Compartilhar via


xlAutoAdd

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

Adicionado pelo Microsoft Excel sempre que o usuário ativa a XLL durante uma sessão do Excel usando o gerenciador de Add-In. Essa função não é chamada quando o Excel inicia e carrega um suplemento pré-instalado.

Essa função pode ser usada para exibir uma caixa de diálogo personalizada que informa ao usuário que o suplemento foi ativado ou para ler ou gravar no registro ou marcar informações de licenciamento, por exemplo.

O Excel não requer uma XLL para implementar e exportar essa função.

int WINAPI xlAutoAdd(void);

Parâmetros

Essa função não usa argumentos.

Valor de propriedade/Valor de retorno

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

Comentários

Use essa função se houver algo que sua XLL precise fazer quando ela for adicionada pelo gerenciador de Add-In.

Exemplo

Consulte \SAMPLES\EXAMPLE\EXAMPLE.C e \SAMPLES\GENERIC\GENERIC.C , por exemplo, implementações dessa função. O código a seguir é de \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;
}

Confira também

XlAutoRemoveAdd-in Manager e Funções de Interface XLL