Funkcijų CALL ir REGISTER naudojimas

Duomenų tipai F ir G

Pagal duomenų tipus F ir G funkcija gali modifikuoti tarpinę eilutę, priskirtą programos Microsoft Excel. Jei grąžinamosios reikšmės tipo kodas yra F arba G, Microsoft Excel nepaiso reikšmės, kurią grąžina funkcija. Tuomet Microsoft Excel ieško funkcijų argumentų sąrašo pirmam atitinkančiam duomenų tipui (F arba G) ir po to paima dabartinę priskirtą tarpinę eilutę kaip grąžinamąją reikšmę. Microsoft Excel argumentui paskiria 256 baitus, todėl funkcija gali grąžinti didesnę eilutę, nei gavo.

Puslapio viršus

Duomenų tipas K

Duomenų tipas K naudoja loginę rodyklę į kintamojo dydžio FP struktūrą. Šią struktūrą turite apibrėžti DLL funkcijoje ar kodo ištekliuose taip, kaip parodyta toliau:

typedef struct _FP
{
    unsigned short int rows;
    unsigned short int columns;
    double array[1];        /* Actually, array[rows][columns] */
} FP;

Deklaracijos double array[1] paskiria atminties vietą tik vieno elemento masyvui. Elementų skaičius tikrajame masyve yra lygus eilučių skaičiui, padaugintam iš stulpelių skaičiaus.

Puslapio viršus

Duomenų tipas O

Duomenų tipas O gali būti naudojamas tik kaip argumentas, bet ne kaip grąžinamoji reikšmė. Jis perduoda tris elementus: loginę rodyklę į eilučių skaičių masyve, loginę rodyklę į stulpelių skaičių masyve ir loginę rodyklę į dviejų dimensijų masyvą iš skaičių su slankiuoju kableliu.

Užuot grąžinusi reikšmę, funkcija gali modifikuoti masyvą, perduotą O duomenų tipui. Norėdami tai padaryti, kaip argumentą type_text galite naudoti ">O". Daugiau informacijos žr. toliau skyriuje "Modifikavimas vietoje – funkcijos, deklaruotos kaip negaliojančios".

Duomenų tipas O buvo sukurtas tiesioginiam suderinamumui su Fortran DLL funkcijomis, kurios argumentus perduoda pagal nuorodą.

Puslapio viršus

Duomenų tipas P

Duomenų tipas P yra loginė rodyklė į OPER struktūrą. OPER struktūra turi 8 baitus duomenų, po kurių eina 2 baitų identifikatorius, nurodantis duomenų tipą. Naudodama duomenų tipą P, DLL funkcija ar kodo ištekliai gali gauti ir grąžinti bet kurį Microsoft Excel duomenų tipą.

OPER struktūra yra apibrėžiama taip:

typedef struct _oper

{
    union
    {
        double num;
        unsigned char *str;
        unsigned short int bool;
        unsigned short int err;
        struct
        {
            struct _oper *lparray;
            unsigned short int rows;
            unsigned short int columns;
        } array;
    } val;
    unsigned short int type;
} OPER;

Tipo lauke yra viena iš šių reikšmių.

Paskutinės dvi reikšmės gali būti naudojamos tik kaip argumentai, o ne grąžinamosios reikšmės. Nenurodyto argumento reikšmė (128) yra perduodama tada, kai funkcijos kvietėjas nenurodo kurio nors argumento. Tuščio langelio reikšmė (256) yra perduodama, kai funkcijos kvietėjas perduoda nuorodą į tuščią langelį.

Puslapio viršus

Duomenų tipas R - iškviečia Microsoft Excel funkcijas iš DLL

Duomenų tipas R yra loginė rodyklė į XLOPER struktūrą, kuri yra išplėstinė OPER struktūros versija. Microsoft Excel 4.0 ir vėlesnėse versijose duomenų tipą R galite naudoti rašyti DLL funkcijoms ir kodų ištekliams, iškviečiantiems Microsoft Excel funkcijas. Naudodama XLOPER struktūrą, DLL funkcija gali perduoti ne tik duomenis, bet ir lapo nuorodas ir vykdyti srauto kontrolę. Išsamus duomenų tipo R ir Microsoft Excel taikomojo programavimo sąsajos (API) aprašymas yra kita tema ir todėl čia nepateiktas. Microsoft Office XP programuotojo vadove rasite išsamesnės informacijos apie duomenų tipą R, Microsoft Excel API ir kitus Microsoft Excel techninius aspektus.

Puslapio viršus

Kintamosios funkcijos ir perskaičiavimas

Programa Microsoft Excel dažniausiai DLL funkciją (ar kodo išteklius) skaičiuoja tik tada, kai ji yra įvedama į langelį, kai pasikeičia vienas iš jos pirminių narių arba kai langelis yra perskaičiuojamas vykdant makrokomandą. Darbalapyje galite nustatyti, kad DLL funkcija ar kodų ištekliai būtų kintami, t. y., jie būtų perskaičiuojami kaskart, kai perskaičiuojamas darbalapis. Jei funkciją norite nustatyti kaip kintamą, argumento tipo_tekstas pabaigoje pridėkite šauktuką (!) kaip paskutinį simbolį.

Pvz., programoje Microsoft Excel (Windows), tokia darbalapio formulė perskaičiuojama kas kartą, kai perskaičiuojamas darbalapis:

CALL("Kernel32","GetTickCount","J!")

Puslapio viršus

Modifikavimas vietoje – funkcijos deklaruotos kaip negaliojančios

Vieną skaitmenį n galite naudoti grąžinimo tipo kodui argumente tipo_tekstas, kai n yra skaitmuo nuo 1 iki 9. Jis nurodo programai Microsoft Excel ne grąžinti reikšmę, o modifikuoti kintamąjį vietoje, kurią tipo_tekste nurodo n-is argumentas. Tai ar yra vadinama modifikavimu vietoje. N-is argumentas turi būti perduodamo pagal nuorodą duomenų tipo (C, D, E, F, G, K, L, M, N, O, P arba R). DLL funkcija arba kodų ištekliai taip pat turi būti deklaruoti su negaliojimo raktažodžiu C kalba (arba procedūros raktažodžiu Paskalio kalba).

Pvz., DLL funkcija, kuri kaip argumentus gauna nuliu besibaigiančią eilutę ir dvi logines rodykles į sveikuosius skaičius, eilutę gali modifikuoti vietoje. Kaip argumentą tipo_tekstas naudokite 1FMM ir deklaruokite funkciją kaip negaliojančią.

Versijose, ankstesnėse už Microsoft Excel 4.0, pirmajam argumentui modifikuoti vietoje yra naudojama simbolis >, tose versijose nebuvo jokios galimybės modifikuoti ne pirmąjį, o kurį nors kitą argumentą. Simbolis > yra lygiavertis n = 1 programoje Microsoft Excel 4.0 ir vėlesnėse jos versijose.

Puslapio viršus