Použití funkcí VOLAT a PŘIHLÁSIT

Datové typy F a G

U datových typů F a G může funkce změnit obsah vyrovnávací paměti řetězce, kterou přidělil Microsoft Excel. Pokud je kód typu návratové hodnoty F nebo G, Microsoft Excel ignoruje hodnotu vrácenou funkcí. Místo toho hledá v seznamu argumentů funkce první odpovídající datový typ (F nebo G) a pak vezme aktuální obsah přidělené vyrovnávací paměti řetězce jako návratovou hodnotu. Microsoft Excel přidělí pro argument 256 bajtů, takže funkce může vrátit větší řetězec, než který přijala.

Začátek stránky

Datový typ K

Datový typ K používá ukazatel na strukturu proměnné velikosti. Tuto strukturu je v knihovně DLL nebo zdroji kódu nutné definovat následujícím způsobem:

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

Deklarace double array[1] alokuje prostor pouze pro pole o jedné položce. Počet položek ve skutečném poli se pak rovná počtu řádků vynásobenému počtem sloupců.

Začátek stránky

Datový typ O

Datový typ O lze použít pouze pro argumenty, nikoli pro návratovou hodnotu. Předává tři položky: ukazatel na počet řádků v poli, ukazatel na počet sloupců v poli a ukazatel na dvourozměrné pole čísel s plovoucí desetinnou čárkou.

Místo vrácení hodnoty může funkce upravit pole předané datovým typem O. Pokud to chcete udělat, můžete jako argument type_text použít „>O“. Další informace najdete níže v části Změna v místě – funkce deklarované jako Void.

Datový typ O byl vytvořen za účelem přímé kompatibility s knihovnami DLL programovacího jazyka FORTRAN, které předávají argumenty odkazem.

Začátek stránky

Datový typ P

Datový typ P je ukazatel na strukturu OPER. Struktura OPER zahrnuje osm bajtů dat následovaných dvoubajtovým indikátorem, který určuje typ dat. Funkce knihovny DLL nebo zdroje kódu s datovým typem P může přijímat i vracet libovolný datový typ aplikace Microsoft Excel.

Struktura OPER je definována následujícím způsobem:

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;

Pole typ obsahuje některou z těchto hodnot.

Poslední dvě hodnoty lze použít pouze jako argumenty, nikoli jako vrácené hodnoty. Hodnota argumentu chybějící argument (128) se předává tehdy, když ve volání funkce chybí argument. Hodnota argumentu prázdná buňka (256) se předává tehdy, když volání funkce obsahuje odkaz na prázdnou buňku.

Začátek stránky

Datový typ R – volání funkcí aplikace Microsoft Excel z knihoven DLL

Datový typ R je ukazatel na strukturu XLOPER, což je vylepšená verze struktury OPER. V aplikaci Microsoft Excel verze 4.0 a novější lze použít datový typ R k psaní knihoven DLL a zdrojů kódu volajících funkce aplikace Microsoft Excel. Funkce knihovny DLL se strukturou XLOPER může kromě dat předávat odkazy na listy a implementovat řízení toku dat. Úplný popis datového typu R a aplikačního programovacího rozhraní (API) aplikace Microsoft Excel je nad rámec tohoto výkladu. Podrobné informace o datovém typu R, rozhraní API aplikace Microsoft Excel a o mnohých dalších technických vlastnostech aplikace Microsoft Excel obsahuje příručka Microsoft Office XP Developer's Guide.

Začátek stránky

Stále přepočítávané funkce a přepočty

Aplikace Microsoft Excel obvykle vyhodnotí funkci knihovny DLL (nebo zdroje kódu) pouze při jejím zadání do buňky, když se změní některá z jejích vstupních hodnot nebo když se buňka přepočítává při provádění makra. Funkce knihovny DLL nebo zdroje kódu v listu může být nastavena jako stále přepočítávaná, což znamená, že se přepočítá při každém přepočítávání listu. Aby se funkce stala stále přepočítávanou, přidejte jako poslední znak v argumentu typ vykřičník (!).

V aplikaci Microsoft Excel pro systém Windows je například následující vzorec v listu přepočítán při každém přepočítávání listu:

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

Začátek stránky

Změna v místě – funkce deklarované jako Void

Pro kód návratového typu v argumentu typ můžete použít jednu číslici n, kde n je číslo od 1 do 9. Tím sdělíte Microsoft Excelu, aby místo vrácení hodnoty změnil proměnnou v umístění, na které ukazuje n-tý argument v argumentu typ. Tomu se také říká změna v místě. N-tý argument musí být datový typ s předáváním odkazem (C, D, E, F, G, K, L, M, N, O, P nebo R). Funkce nebo zdroj kódu knihovny DLL se také musí deklarovat s klíčovým slovem void v jazyce C (nebo klíčovým slovem procedure v jazyce Pascal).

Například funkce knihovny DLL, která má za vstupní argumenty řetězec zakončený nulou a dva odkazy na celá čísla, může změnit daný řetězec v místě. V takovém případě jako argument typ použijte "1FMM" a funkci deklarujete jako void.

Verze aplikace Microsoft Excel předcházející verzi 4.0 používaly znak > pro změnu prvního argumentu v místě a nebylo možné změnit jiný argument než první. Znak > je ekvivalentní n=1 v aplikaci Microsoft Excel verze 4.0 a novějších.

Začátek stránky