Funktsioonide CALL ja REGISTER kasutamine

F- ja G-andmetüübid

F- ja G-andmetüüpide puhul võib funktsioon teisendada Microsoft Exceli määratud stringipuhvri. Kui tagastusväärtuse tüübikood on F või G, ignoreerib Microsoft Excel funktsiooni tagastusväärtust. Selle asemel leiab Microsoft Excel funktsiooni argumentide loendist esimese vastava andmetüübi (F või G) ja võtab siis tagastusväärtusena määratud stringipuhvri praeguse sisu. Microsoft Excel määrab argumendile 256 baiti, nii võib funktsioon tagastada pikema stringi kui vastuvõetud string.

Lehe algusse

K-andmetüüp

K-andmetüüp kasutab viita muutuva suurusega FP-struktuurile. See struktuur tuleb määratleda DLL-teegis või koodiressursis järgnevalt:

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

Deklaratsioon double array[1] määrab mälu ainult ühe elemendiga massiivile. Tegeliku massiivi elementide arv võrdub ridade arvu ja veergude arvu korrutisega.

Lehe algusse

O-andmetüüp

O-andmetüüpi saab kasutada ainult argumendina, mitte tagastusväärtusena. See edastab kolme üksust: viita massiivi ridade arvule, viita massiivi veergude arvule ja viita ujukomaarvude kahemõõtmelisele massiivile.

Väärtuse tagastamise asemel võib funktsioon muuta O-andmetüübi poolt edastatud massiivi. Selleks võib kasutada argumendina teksti_tüüp stringi ">O". Lisateabe saamiseks vt allpool osa "Muutmine kohapeal – tühistatud funktsioonid".

O-andmetüüp loodi otseühilduvuse saavutamiseks Fortrani DLL-teekidega, mis edastavad argumente viitena.

Lehe algusse

P-andmetüüp

P-andmetüüp on viit OPER-struktuurile. OPER-struktuur sisaldab 8 baiti andmeid, millele järgneb 2-baidine andmetüüpi määrav identifikaator. P-andmetüübi puhul võib DLL-funktsioon või koodiressurss võtta ja tagastada suvalist Microsoft Exceli andmetüüpi.

OPER-struktuuri määratletakse järgnevalt:

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;

Tüübiväli sisaldab ühte nendest väärtustest.

Viimast kahte väärtust saab kasutada ainult argumentidena, mitte tagastusväärtustena. Puuduva argumendi väärtus (128) edastatakse, kui kutsuja jätab argumendi ära. Tühja lahtri väärtus (256) edastatakse, kui kutsuja edastab viite tühjale lahtrile.

Lehe algusse

R-andmetüüp – Microsoft Exceli funktsioonide kutsumine DLL-teekidest

R-andmetüüp on viit XLOPER-struktuurile, mis on OPER-struktuuri laiendatud versioon. Microsoft Exceli versioonis 4.0 ja hilisemates versioonides võite kasutada R-andmetüüpi DLL-teekide ja koodiressursside kirjutamiseks, mis kutsuvad Microsoft Exceli funktsioone. XLOPER-struktuuri puhul võib DLL-funktsioon lisaks andmete edastamisele edastada leheviiteid ja teostada voogude juhtimist. R-andmetüübi ja Microsoft Exceli rakendusliidese (API-liidese) täielik kirjeldamine jääb selle teema ulatusest välja. Käsiraamat Microsoft Office XP Developer's Guide sisaldab üksikasjalikku teavet R-andmetüübi, Microsoft Exceli API-liidese ja paljude teiste Microsoft Exceli tehniliste aspektide kohta.

Lehe algusse

Hävivad funktsioonid ja ümberarvutus

Microsoft Excel arvutab tavaliselt DLL-funktsiooni või koodiressurssi ainult siis, kui see on sisestatud lahtrisse, kui muutub üks selle eelkäijatest või kui lahtrit arvutatakse makro toimimise ajal. Võite muuta töölehel DLL-funktsiooni või koodiressursi hävivaks, mis tähendab, et see arvutab ümber iga kord, kui arvutatakse ümber töölehte. Funktsiooni muutmiseks hävivaks lisage argumendi teksti_tüüp viimase märgina hüüumärgi (!).

Näiteks programmis Microsoft Excel for Windows arvutab järgmine töölehe valem ümber iga kord, kui arvutatakse ümber töölehte:

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

Lehe algusse

Muutmine kohapeal – tühjad funktsioonid

Võite kasutada tagastustüübi koodina argumendis teksti_tüüp ainsat märki n, kus n on arv vahemikus 1-9. See annab Microsoft Excelile käsu väärtuse tagastamise asemel muuta muutujat asukohas, kuhu osutab argument number n argumendis teksti_tüüp. Seda nimetatakse ka muutmiseks kohapeal. Argument number n peab kuuluma andmetüüpi edastatakse-viitena (C, D, E, F, G, K, L, M, N, O, P või R). DLL-funktsioon või koodiressurss tuleb samuti deklareerida void võtmesõnaga C-keeles või procedure võtmesõnaga Pascalis.

Näiteks võib DLL-funktsioon, mis võtab argumentidena tühja lõpuga stringi ja kaks viita täisarvudele, muuta stringi kohapeal. Kasutage argumendina teksti_tüüp stringi "1FMM" ja tühistage funktsioon.

Varasemad versioonid kui Microsoft Excel 4.0 kasutasid esimese argumendi muutmiseks kohapeal märki >; polnud mingit võimalust muuta muud argumenti kui esimest. Märk > on ekvivalentne võrdusega n = 1 Microsoft Exceli versioonis 4.0 ja hilisemates versioonides.

Lehe algusse