xlAutoOpen

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Função de retorno de chamada que deve ser implementada e exportada por cada XLL válida. A função xlAutoOpen é o local recomendado de onde registrar funções e comandos XLL, inicializar estruturas de dados, personalizar a interface do usuário e assim por diante.

int WINAPI xlAutoOpen(void);

Parâmetros

Essa função não usa argumentos.

Valor de propriedade/Valor de retorno

A implementação dessa função deve retornar 1 (int).

Comentários

O Microsoft Excel chama xlAutoOpen sempre que a XLL é ativada. A XLL é ativada nas seguintes situações:

• No início de uma sessão do Excel, se ela estivesse ativa na última sessão do Excel que terminou normalmente.

• Se carregado durante uma sessão do Excel.

• Uma XLL pode ser carregada de várias maneiras:

• Ao escolher Abrir no menu Arquivo (em que a versão do Excel dá suporte a esse método de carregamento de XLLs).

• Usando o Gerenciador de Suplemento.

• De outra XLL que chama xlfRegister com o nome dessa DLL como o único argumento.

• De uma planilha de macro XLM que chama REGISTER com o nome dessa DLL como o único argumento.

• Se o suplemento for desativado e reativado durante uma sessão do Excel, essa função será chamada para reativação.

Exemplo

Consulte os arquivos SAMPLES\EXAMPLE\EXAMPLE.C e SAMPLES\GENERIC\GENERIC.C, e, por exemplo, implementações dessa função.

Confira também

xlAutoClose
xlAutoRegister/xlAutoRegister12Add-in Manager e XLL Interface Functions