xlAutoOpen

  • Статья

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

Функция обратного вызова, которая должна быть реализована и экспортирована каждым допустимым XLL. Функция xlAutoOpen — это рекомендуемое место для регистрации функций и команд XLL, инициализации структур данных, настройки пользовательского интерфейса и т. д.

int WINAPI xlAutoOpen(void);

Параметры

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

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

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

Замечания

Microsoft Excel вызывает xlAutoOpen при активации XLL. XLL активируется в следующих ситуациях:

  • В начале сеанса Excel, если он был активен в последнем сеансе Excel, который закончился нормально.

  • При загрузке во время сеанса Excel.

  • XLL можно загрузить несколькими способами:

  • Выбрав Открыть в меню Файл (где версия Excel поддерживает этот метод загрузки XLLs).

  • С помощью диспетчера надстроек.

  • Из другого XLL, который вызывает xlfRegister с именем этой библиотеки DLL в качестве единственного аргумента.

  • С листа макросов XLM, который вызывает REGISTER с именем этой библиотеки DLL в качестве единственного аргумента.

  • Если надстройка деактивирована и повторно активируется во время сеанса Excel, эта функция вызывается при повторной активации.

Пример

См. файлы SAMPLES\EXAMPLE\EXAMPLE.C и SAMPLES\GENERIC\GENERIC.C, а также примеры реализации этой функции.

См. также

xlAutoClose
xlAutoRegister/xlAutoRegister12Диспетчер надстроек и функции интерфейса XLL