CALL 関数と REGISTER 関数の使い方

データ型 F および G

データ型 F および G を使用すると、Excel によって割り当てられる文字列バッファーを関数で変更することができます。 戻り値のコードが F または G の場合は、関数によって返された値が無視されます。 代わりに、関数の引数の一覧から最初に対応するデータ型 (F または G) が検索され、割り当てられた文字列バッファーの現在の内容が戻り値として見なされます。 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] では、1 要素の配列に対してのみ記憶領域が割り当てられます。 実際の配列における要素数は、行数に列数を掛けた値になります。

ページの先頭へ

データ型 O

O データ型は、戻り値としてではなく、引数としてのみ使用できます。 3 つの項目 (配列内の行数へのポインター、配列内の列の数へのポインター、浮動小数点数の 2 次元配列へのポインター) が渡されます。

関数では、値を返す代わりに、データ型 O によって渡される配列を変更することができます。 そのためには、タイプ引数として ">O" を使用します。 詳細については、次の「指定した引数の変更: Void として宣言される関数」を参照してください。

データ型 O は、引数を参照で渡す Fortran DLL との直接的な互換性を確保する目的で作成されたものです。

ページの先頭へ

データ型 P

データ型 P は、OPER 構造体へのポインターです。 OPER 構造体には、8 バイトのデータに続いてデータ型を指定する 2 バイトの識別子が含まれます。 データ型 P を使用すれば、DLL 関数またはコード リソースで、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 フィールドには、次のいずれかの値が格納されます。

最後の 2 つは引数としてのみ使用され、戻り値には使用されません。 呼び出し側が引数を省略した場合は、引数の欠落を表す 128 が渡されます。 呼び出し側が空白セル参照を渡した場合は、空白セルを表す 256 が渡されます。

ページの先頭へ

データ型 R: DLL から Excel の関数を呼び出す

データ型 R は、OPER 構造体の拡張版である XLOPER 構造体へのポインターです。 Excel 4.0 以降では、データ型 R を使用して Excel の関数を呼び出す DLL とコード リソースを作成することができます。 XLOPER 構造体を使用すれば、DLL 関数で、データの受渡し以外にシート参照の受け渡しやフロー制御の実現が可能になります。 このトピックでは、データ型 R や Excel のアプリケーション プログラミング インターフェイス (API) について詳しく説明しません。 データ型 R、Excel の API、および Excel に関するその他の技術情報については、『Microsoft Office XP Developer's Guide』で詳しく説明されています。

ページの先頭へ

可変関数と再計算

通常、Microsoft Excel では、DLL 関数 (またはコード リソース) は、セルに入力されたとき、優先順位のいずれかが変更されたとき、またはマクロ中にセルが計算された場合にのみ計算されます。 ワークシートでは、DLL 関数またはコード リソースを揮発性にすることができます。つまり、ワークシートが再計算されるたびに再計算されます。 関数を揮発性にするには、type_text引数の最後の文字として感嘆符 (!) を追加します。

たとえば Windows 版 Excel では、ワークシートが再計算されるたびに、次のようなワークシートの数式も再計算されます。

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

ページの先頭へ

指定した引数の変更: Void として宣言される関数

タイプの戻り値のコードとして 1 桁の数字 n を使用することができます。 この 1 から 9 までの数字 n を使って、値を返すのではなく、タイプの n 番目の引数で示される場所にある変数を変更するように指定できます。 これは、指定した引数の変更とも呼ばれます。 n 番目の引数は、参照渡しのデータ型 (C、D、E、F、G、K、L、M、N、O、P、または R) であることが必要です。 また、DLL 関数やコード リソースを、C 言語の void キーワード (または Pascal の procedure キーワード) で宣言する必要があります。

たとえば、引数として末尾が Null の文字列および 2 つの整数へのポインターを取る DLL 関数では、指定した位置の文字列を変更することができます。 この場合、タイプ引数として "1FMM" を使用し、関数を void として宣言します。

Excel 4.0 より前のバージョンでは、> 記号を使って最初の引数を指定して変更できるだけで、それ以外の引数を変更する方法はありませんでした。 > 記号は、Excel 4.0 以降における n = 1 に相当します。

ページの先頭へ