xlAutoAdd
適用対象: Excel 2013 | Office 2013 | Visual Studio
ユーザーが Excel セッション中にアドイン マネージャーを使用して XLL を有効にするたびに、Microsoft Excel によって追加されます。 Excel が起動し、あらかじめインストールされたアドインを読み込む際には、この関数は呼び出されません。
たとえば、この関数を使用して、アドインが有効になっていることをユーザーに通知するカスタム ダイアログ ボックスの表示、レジストリの読み取りと書き込み、ライセンス情報の確認などができます。
Excel では、これらの関数の実装とエクスポートに XLL は必要ありません。
int WINAPI xlAutoAdd(void);
パラメーター
この関数に引数はありません。
プロパティ値/戻り値
この関数を実装する場合、1 を返す必要があります。 (int)。
注釈
アドイン マネージャーが任意のタスクを追加するときに、そのタスクを XLL が実行する必要がある場合は、この関数を使用します。
例
この関数の実装例と \SAMPLES\GENERIC\GENERIC.C
を参照してください\SAMPLES\EXAMPLE\EXAMPLE.C
。 次のコードは です \SAMPLES\EXAMPLE\EXAMPLE.C
。
int WINAPI xlAutoAdd(void)
{
XCHAR szBuf[255];
wsprintfW((LPWSTR)szBuf, L"Thank you for adding Example.XLL\n"
L"build date %hs, time %hs",__DATE__, __TIME__);
/* Display a dialog indicating that the XLL was successfully added */
Excel12f(xlcAlert, 0, 2, TempStr12(szBuf), TempInt12(2));
return 1;
}