xlSheetNm
Gilt für: Excel 2013 | Office 2013 | Visual Studio
Gibt den Namen eines Arbeitsblatts oder Makroblatts aus seiner internen Blatt-ID zurück, die in einem externen Verweis enthalten ist, oder den Namen des aktuellen Blatts, wenn ein interner Verweis übergeben wird.
Excel12(xlSheetNm, LPXLOPER12 pxRes, 1, LPXLOPER12 pxExtref);
Parameter
pxExtref (xltypeRef oder xltypeSRef)
Ein Verweis auf das Blatt, dessen Name Sie verwenden möchten.
Wenn Sie einen externen Verweis (xltypeRef) übergeben, muss dieser nur die ID des Blatts enthalten. Die Datenstrukturen, die die Zellen auf dem Arbeitsblatt beschreiben, werden ignoriert und müssen nicht bereitgestellt werden. Wenn die ID auf 0 (null) festgelegt ist, gibt xlSheetNm den Namen des aktuellen Blatts zurück.
Wenn Sie einen internen Verweis (xltypeSef) übergeben, gibt xlSheetNm den Namen des aktuellen Blatts zurück.
Eigenschaftswert/Rückgabewert
Gibt den Namen des Blatts (xltypeStr) im Format [Book1]Sheet1zurück.
Beispiel
Im folgenden Beispiel wird der Name des Blatts angezeigt, aus dem die Funktion aufgerufen wurde. Die Funktion funktioniert nur ordnungsgemäß, wenn sie während der Ausführung eines XLM-Befehlsmakros von einem Makro aus einem Makro aufgerufen wird. Dies liegt daran, dass xlcAlert aufgerufen wird, was nur Von Befehlen möglich ist, und es muss von einem Blatt und nicht von einem Dialogfeld, Menü oder einer Befehlsleiste aufgerufen werden, damit xlfCaller einen Verweis zurückgeben kann.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI xlSheetNmExample(void)
{
XLOPER12 xRes, xSheetName;
Excel12(xlfCaller, &xRes, 0);
Excel12(xlSheetNm, &xSheetName, 1, (LPXLOPER12)&xRes);
Excel12(xlcAlert, 0, 1, (LPXLOPER12)&xSheetName);
Excel12(xlFree, 0, 1, (LPXLOPER12)&xSheetName);
return 1;
}