Використання функцій CALL і REGISTER

Увага! : Цю статтю перекладено за допомогою служби машинного перекладу; див. застереження. Версію цієї статті англійською мовою див. тут для отримання довідки.

Увага! : Увага!    Неправильне редагування реєстру може серйозно пошкодити вашу операційну системи, після чого знадобиться її повторна інсталяція. Корпорація Microsoft не може гарантувати, що негативні наслідки редагування реєстру можна буде усунути. Перед редагуванням реєстру створіть резервну копію всіх важливих даних. Останні відомості про використання та захист реєстру комп'ютера можна знайти в довідці Microsoft Windows.

У цій статті подано синтаксис формули й описано використання функцій CALL, REGISTER і REGISTER.ID в програмі Microsoft Excel.

Примітка :  Функції CALL і REGISTER недоступні у веб-програмі Excel Online.

У цій статті

Опис

Типи даних

Примітки

Додаткові відомості про типи даних

Типи даних F і G

Тип даних K

Тип даних O

Тип даних P

Тип даних R: виклик функцій Microsoft Excel із DLL-бібліотек

Мінливі функції та повторне обчислення

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

Опис

У цьому розділі описано типи даних аргументів і результатів функцій CALL, REGISTER і REGISTER.ID. Аргументи й результати несуттєво різняться залежно від робочого середовища; ці відмінності відзначаються в таблиці типів даних.

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

Типи даних

У функціях CALL, REGISTER і REGISTER.ID аргумент "тип" вказує на тип даних значення, яке повертається, а також на типи даних усіх аргументів функції DLL-бібліотеки або кодового ресурсу. Перший символ аргументу "тип_інформації" вказує на тип даних значення, яке повертається, а решта символів — на типи даних усіх аргументів. Наприклад, для функції DLL-бібліотеки, яка повертає число з рухомою комою і приймає ціле число та число з рухомою комою як аргументи, потрібно вказати таке значення аргументу "тип_інформації": BIB.

Нижченаведена таблиця містить повний список кодів типів даних, які розпізнаються в Microsoft Excel, опис кожного з типів даних, принцип передавання аргументу або значення, що повертається, а також типову декларацію типу даних мовою програмування C.

Код

Опис

Передавання

Вираз мовою C

А

Логічний
FALSE=0, TRUE=1

Значення

short int

B

8-байтне число IEEE з рухомою комою

Значення
(Windows)

Посилання (Macintosh)

double
(Windows)

double * (Macintosh)

C

Рядок із нульовим закінченням (максимальна довжина рядка = 255)

Посилання

char *

D

Рядок із довжиною в байтах (перший байт містить довжину рядка, максимальна довжина рядка = 255)

Посилання

Unsigned char *

E

8-байтне число IEEE з рухомою комою

Посилання

double *

F

Рядок із нульовим закінченням (максимальна довжина рядка = 255)

Посилання (змінення на місці)

char *

G

Рядок із довжиною в байтах (перший байт містить довжину рядка, максимальна довжина рядка = 255)

Посилання (змінення на місці)

unsigned char *

H

2-байтове ціле число без знака

Значення

unsigned short int

I

2-байтове ціле число зі знаком

Значення

short int

J

4-байтове ціле число зі знаком

Значення

long int

K

Масив

Посилання

FP *

L

Логічний
FALSE=0, TRUE=1

Посилання

short int *

M

2-байтове ціле число зі знаком

Посилання

short int *

N

4-байтове ціле число зі знаком

Посилання

long int *

O

Масив

Посилання

Передаються три аргументи:
unsigned short int *
unsigned short int *
double [ ]

P

Структура даних Microsoft Excel OPER

Посилання

OPER *

R

Структура даних Microsoft Excel XLOPER

Посилання

XLOPER *

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

Примітки

  • Декларації мовою C базуються на припущенні, що в компіляторі встановлено за промовчанням 8-байтові числа з подвійною точністю, 2-байтові короткі цілі числа та 4-байтові довгі цілі числа.

  • У програмному середовищі Microsoft Windows усі вказівники є дальніми. Наприклад, код типу даних D у Microsoft Windows слід визначати як unsigned char far *.

  • Усі функції в DLL-бібліотеках і кодових ресурсах викликаються за допомогою синтаксису виклику Pascal. У більшості компіляторів C синтаксис виклику Pascal можна використовувати, додавши до декларації функції ключове слово Pascal, як показано у прикладі нижче: pascal void main (rows,columns,a)

  • Якщо для значення, що повертається функцією, використовується тип даних, який передається за посиланням, результатом функції можна передати пустий вказівник. Microsoft Excel інтерпретує пустий вказівник як значення помилки #NUM!.

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

Додаткові відомості про типи даних

Цей розділ містить докладні відомості про типи даних F, G, K, O, P і R, а також інші відомості про аргумент тип_інформації.

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

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

Тип

Опис

Поле значення (Val)

1

Числовий

num

2

Рядок (перший байт містить довжину рядка)

str

4

Булевий (логічний)

bool

16

Помилка: значення помилок:

#NULL!

#DIV/0!

15#Value!

#REF!

#NAME?

#NUM!

#N/A

err

64

Масив

array

128

Відсутній аргумент

256

Пуста клітинка

Останні два значення можна використовувати лише як аргументи, а не як результати. Значення відсутнього аргументу (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.

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

Примітка : Застереження про машинний переклад: Цю статтю перекладено комп’ютерною системою без втручання людини. Корпорація Майкрософт пропонує таку послугу, щоб іншомовні користувачі могли дізнаватися про продукти, служби й технології Microsoft. Оскільки статтю перекладено за допомогою служби машинного перекладу, вона може містити смислові, синтаксичні або граматичні помилки.

Отримуйте нові функції раніше за інших
Приєднайтеся до оцінювачів Office

Ця інформація корисна?

Дякуємо за ваш відгук!

Дякуємо за відгук! Схоже, вам може стати в нагоді допомога одного з наших спеціалістів служби підтримки Office, з яким ми вас можемо з’єднати.

×