xlAutoAdd

S’applique à: Excel 2013 | Office 2013 | Visual Studio

Ajouté par Microsoft Excel chaque fois que l’utilisateur active le XLL pendant une session Excel à l’aide de Add-In Manager. Cette fonction n’est pas appelée quand Excel démarre et charge un complément préinstallé.

Cette fonction peut être utilisée pour afficher une boîte de dialogue personnalisée qui indique à l’utilisateur que le complément a été activé, ou pour lire ou écrire dans le registre, ou case activée des informations de licence, par exemple.

Excel ne nécessite pas de XLL pour implémenter et exporter cette fonction.

int WINAPI xlAutoAdd(void);

Paramètres

Cette fonction ne prend aucun argument.

Valeur de propriété/valeur de renvoi

Votre implémentation de cette fonction doit retourner 1. (int).

Remarques

Utilisez cette fonction s’il y a quelque chose que votre XLL doit faire lorsqu’il est ajouté par le gestionnaire de Add-In.

Exemple

Consultez \SAMPLES\EXAMPLE\EXAMPLE.C et \SAMPLES\GENERIC\GENERIC.C pour obtenir des exemples d’implémentation de cette fonction. Le code suivant provient 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;
}

Voir aussi

Gestionnaire de compléments xlAutoRemoveet fonctions d’interface XLL