xlfSetName
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Wird verwendet, um definierte Namen zu erstellen und zu löschen, die der DLL zugeordnet sind.
Excel12(xlfSetName, LPXLOPER12 pxRes, 2, LPXLOPER12 pxNameText, LPXLOPER12 pxNameDefinition);
Parameter
pxNameText (xltypeStr)
Der Name des Bereichs, der den üblichen Einschränkungen in Microsoft Excel für gültige Namen entsprechen sollte.
pxNameDefinition (xltypeStr, xltypeNum, xltypeBool, xltypeErr, xltypeMulti, xltypeSRef, xltypeRef, xltypeRef oder xltypeInt)
(Optional). Der Wert, der Satz von Werten, die Zelle oder der Zellbereich, als den pxNameText definiert ist. Wenn er nicht angegeben wird, wird der Name gelöscht.
Eigenschaftswert/Rückgabewert
pxRes (xltypeBool oder xltypeErr)
TRUE, wenn der Vorgang erfolgreich war, oder FALSE, wenn der Name nicht erstellt oder gelöscht werden konnte. Gibt #VALUE zurück! , wenn eines oder mehrere der Argumente ungültig waren.
Hinweise
Wenn eine Funktion oder ein Befehl mit xlfRegister mit einem gültigen pxFunctionText-Argument registriert wird, erstellt Excel einen Namen, der der DLL-Ressource zugeordnet ist. Wenn Ihre DLL entladen wird, sollten solche Namen mithilfe der xlfSetName-Funktion gelöscht werden. Aufgrund eines bekannten Problems in Excel schlägt dieser Löschvorgang jedoch fehl. Weitere Informationen finden Sie unter Bekannte Probleme bei der Excel-XLL-Entwicklung.
Beispiel
Weitere Informationen finden Sie im Code für die xlAutoClose-Funktion in \SAMPLES\GENERIC\GENERIC.C.