Използване на функциите CALL и REGISTER

Типове данни F и G

При типовете данни F и G една функция може да модифицира буфер за низове, който е заделен от Microsoft Excel. Ако кодът на типа на върнатата стойност е F или G, тогава Microsoft Excel игнорира стойността, върната от функцията. Вместо това Microsoft Excel търси списъка от аргументи на функцията за първия съответстващ тип данни (F или G) и след това взема текущото съдържание на заделения буфер за низове като върната стойност. Microsoft Excel заделя 256 байта за аргумента, така че функцията може да върне по-голям низ, отколкото е получила.

Най-горе на страницата

Тип данни K

Типът данни K използва указател към FP структура с променлив размер. Трябва да дефинирате тази структура в DLL или кодовия ресурс, както следва:

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

Декларацията double array[1] заделя памет само за масив с един елемент. Броят на елементите в истинския масив е равен на броя на редовете, умножен по броя на колоните.

Най-горе на страницата

Тип данни O

Типът данни O може да бъде използван само като аргумент, а не като върната стойност. Той предава три елемента: указател към броя на редовете в масив, указател към броя на колоните в масив и указател към двумерен масив от числа с плаваща запетая.

Вместо да върне стойност, една функция може да модифицира масив, подаден от данни тип O. За да направите това, можете да използвате ">O" като аргумента type_text. За повече информация вж. "Модифициране на място – функции, декларирани като Void" по-долу.

Типът данни O е създаден за пряка съвместимост с DLL на Fortran, който предава аргументите по адрес.

Най-горе на страницата

Тип данни P

Типът данни P е указател към OPER структура. OPER структурата съдържа 8 байта данни, следвани от 2-байтов идентификатор, който задава типа на данните. С типа данни P една DLL функция или кодов ресурс може да вземе и да върне всеки тип данни на Microsoft Excel.

Структурата OPER се дефинира като следва:

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;

Полето type съдържа една от следните стойности.

Последните две стойности могат да се използват само като аргументи, а не за връщане на стойности. Стойността за липсващ аргумент (128) се предава, когато извикването пропуска аргумент. Стойността за празна клетка (256) се предава, когато извикването предава препратка към празна клетка.

Най-горе на страницата

Тип данни R – Извикване на функции на Microsoft Excel от DLL

Типът данни R е указател към XLOPER структура, която е разширена версия на OPER структурата. В Microsoft Excel версия 4.0 и по-късните версии можете да използвате типа данни R, за да пишете DLL и кодови ресурси, които извикват функции на Microsoft Excel. В структурата XLOPER една DLL функция, освен да предава данни, може да предава препратки към лист и да реализира управление на потока. Пълното описание на типа данни R и интерфейса за програмиране на приложения (API) на Microsoft Excel е извън обхвата на тази тема. Документът Microsoft Office XP Developer's Guide съдържа подробна информация за типа данни R, Microsoft Excel API и много други технически аспекти на Microsoft Excel.

Най-горе на страницата

Непостоянни функции и преизчисление

Microsoft Excel обикновено изчислява a DLL функция (или кодов ресурс) само когато е въведен в клетка, когато един от нейните предшественици се промени или когато клетката се изчислява по време на изпълнение на макрос. В работния лист можете да направите една DLL функция (или кодов ресурс) непостоянна, който означава, че тя ще се преизчислява всеки път, когато се преизчислява работният лист. За да направите една функция непостоянна, добавете удивителен знак (!) като последен знак в аргумента type_text.

Например в работен лист на Microsoft Excel за Windows следната формула ще се преизчислява всеки път, когато се преизчислява работният лист:

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

Най-горе на страницата

Модифициране на място – функции, декларирани като Void

Можете да използва единична цифра n като код на върнатия тип в type_text, където n е число от 1 до 9. Това съобщава на Microsoft Excel да модифицира променливата на мястото, посочено от n-я аргумент в type_text, вместо да връща стойност. Това се нарича още модифициране на място. n-ят аргумент трябва да бъде тип данни, предаван по адрес (C, D, E, F, G, K, L, M, N, O, P или R). Освен това DLL функцията или кодовият ресурс трябва да се декларират с ключовата дума void в езика C (или с ключовата дума procedure в езика Pascal).

Например една DLL функция, която приема като аргументи един низ, завършващ с нулев символ, и два указателя към цели числа, може да модифицира низа на място. Използвайте "1FMM" като type_text аргумент и декларирайте функцията като void.

Версиите преди Microsoft Excel 4.0 използваха знака > за модифициране на място на първия аргумент; нямаше възможност за модифициране на други аргументи, освен първия. Знакът > е еквивалентен на n = 1 в Microsoft Excel версия 4.0 и следващите версии.

Най-горе на страницата