Partager via


xlAutoRemove

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

Appelé par Microsoft Excel chaque fois que l’utilisateur désactive le XLL pendant une session Excel à l’aide de Add-In Manager. Cette fonction n’est pas appelée lors de la fermeture normale ou anormale d’une session Excel lorsque le complément est installé.

Cette fonction peut être utilisée pour afficher une boîte de dialogue personnalisée indiquant à l’utilisateur que le complément a été désactivé, ou pour lire ou écrire dans le registre, par exemple.

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

int WINAPI xlAutoRemove(void);

Paramètres

Cette fonction ne prend aucun argument.

Valeur de propriété/valeur de renvoi

Votre exécution de cette fonction doit renvoyer 1 (ent).

Remarques

Utilisez cette fonction si votre XLL doit effectuer une tâche lorsqu’elle est supprimée par le Add-In Manager.

Exemple

Consultez les fichiers\SAMPLES\EXAMPLE\EXAMPLE.C et \SAMPLES\GENERIC\GENERIC.C les exemples d’implémentation de cette fonction. Le code suivant provient de \SAMPLES\EXAMPLE\EXAMPLE.C.

int WINAPI xlAutoRemove(void)
{
/* Display a dialog box indicating that the XLL was successfully removed */
   Excel12f(xlcAlert, 0, 2,
      TempStr12(L"Thank you for removing Example.XLL!"),
      TempInt12(2));
   return 1;
}

Voir aussi

xlAutoAddAdd-in Manager et XLL Interface Functions