Використання функцій 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". Для отримання додаткових відомостей див. розділ "Змінення на місці: функції, задекларовані як пусті".

Тип даних 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;

Поле типу містить одне з нижченаведених значень.

Останні два значення можна використовувати лише як аргументи, а не як результати. Значення відсутнього аргументу (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 обчислює функцію DLL-бібліотеки або кодового ресурсу лише після того, як її ввести в клітинку, змінити одну із впливаючих клітинок, або в тому разі, коли клітинка обчислюється за допомогою макросу. На аркуші можна зробити функцію DLL-бібліотеки або кодового ресурсу мінливою, що буде означати повторне її обчислення кожний раз під час повторного обчислення аркуша. Щоб зробити функцію мінливою, додайте знак оклику(!) як останній символ в аргументі тип_інформації.

Наприклад, у програмі Microsoft Excel для Windows нижченаведена формула аркушу здійснює повторне обчислення кожний раз під час повторного обчислення аркуша:

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

На початок сторінки

Змінення на місці: функції, задекларовані як недійсні

В аргументі тип_інформації можна вказати код типу значення, що повертається, однією цифрою n — числом від 1 до 9. Це дає команду Microsoft Excel змінити розташування змінної, вказаної n-ним аргументом в аргументі тип_інформації, замість того, щоб повертати значення. Ця дія також називається зміненням на місці. N-ний аргумент має мати тип даних, який передається за посиланням (C, D, E, F, G, K, L, M, N, O, P або R). Функцію DLL-бібліотеки або кодового ресурсу також слід задекларувати ключовим словом void для мови C (або ключовим словом procedure для мови Pascal).

Наприклад, функція DLL-бібліотеки, яка приймає рядок із нульовим закінченням і два вказівники на цілі числа як аргументи, може змінювати рядок на місці. Укажіть для аргументу тип_інформації значення "1FMM" і задекларуйте функцію як пусту (void).

У версіях Microsoft Excel до 4.0, використовувався символ >для змінення першого аргументу на місці; не було можливості змінювати будь-які аргументи, окрім першого. У версії Microsoft Excel 4.0 і пізніших символ > еквівалентний n = 1.

На початок сторінки