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;
}

另请参阅

xlAutoRemove外接程序管理器和 XLL 接口函数