xlAutoAdd
适用于:Excel 2013 | Office 2013 | Visual Studio
每当用户在 Excel 会话期间使用 Add-In 管理器激活 XLL 时,Microsoft Excel 添加。 当 Excel 启动并加载预安装的加载项时,不会调用此函数。
例如,此函数可用于显示一个自定义对话框,该对话框告知用户加载项已激活,或者从注册表读取或写入,或检查许可信息。
Excel 不需要 XLL 来实现和导出此函数。
int WINAPI xlAutoAdd(void);
参数
此函数无需使用任何参数。
属性值/返回值
此函数的实现应返回 1。 (int) 。
备注
如果 XLL 由 Add-In 管理器添加时需要执行任何操作,请使用此函数。
示例
有关此函数的示例实现,请参阅 \SAMPLES\EXAMPLE\EXAMPLE.C
和 \SAMPLES\GENERIC\GENERIC.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;
}