xlAutoAdd

Область применения: Excel 2013 | Office 2013 | Visual Studio

Добавляется Microsoft Excel всякий раз, когда пользователь активирует XLL во время сеанса Excel с помощью диспетчера Add-In. Эта функция не вызывается при запуске Excel и загрузке предварительно установленной надстройки.

Эту функцию можно использовать для отображения настраиваемого диалогового окна, в котором пользователю сообщается, что надстройка активирована, или для чтения или записи в реестр, а также проверка сведения о лицензировании, например.

Excel не требует XLL для реализации и экспорта этой функции.

int WINAPI xlAutoAdd(void);

Параметры

Эта функция не получает никаких аргументов.

Значение свойства и возвращаемое значение

Реализация этой функции должна возвращать значение 1. (int).

Замечания

Используйте эту функцию, если при добавлении Add-In Manager необходимо выполнить какие-либо действия, необходимые для XLL.

Пример

См. \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