xlAutoAdd
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Wird von Microsoft Excel hinzugefügt, wenn der Benutzer die XLL während einer Excel-Sitzung mithilfe des Add-In-Managers aktiviert. Diese Funktion wird nicht aufgerufen, wenn Excel gestartet und ein vorinstalliertes Add-In geladen wird.
Diese Funktion kann verwendet werden, um ein benutzerdefiniertes Dialogfeld anzuzeigen, das dem Benutzer mitteilt, dass das Add-In aktiviert wurde, oder um aus der Registrierung zu lesen oder in die Registrierung zu schreiben oder z. B. Lizenzierungsinformationen zu überprüfen.
Excel erfordert keine XLL, um diese Funktion zu implementieren und zu exportieren.
int WINAPI xlAutoAdd(void);
Parameter
Diese Funktion verwendet keine Parameter.
Eigenschaftswert/Rückgabewert
Ihre Implementierung dieser Funktion sollte 1 zurückgeben. (int).
Hinweise
Verwenden Sie diese Funktion, wenn Ihre XLL etwas tun muss, wenn sie vom Add-In-Manager hinzugefügt wird.
Beispiel
Beispiele für Implementierungen dieser Funktion finden Sie \SAMPLES\EXAMPLE\EXAMPLE.C unter und \SAMPLES\GENERIC\GENERIC.C . Der folgende Code stammt aus \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;
}