xlSheetNm

适用于:Excel 2013 | Office 2013 | Visual Studio

从外部引用中包含的内部工作表 ID 返回工作表或宏工作表的名称,如果传递了内部引用,则返回当前工作表的名称。

Excel12(xlSheetNm, LPXLOPER12 pxRes, 1, LPXLOPER12 pxExtref);

参数

pxExtref (xltypeRefxltypeSRef)

对所需名称的工作表的引用。

如果要传递外部引用 (xltypeRef) 它只需要包含工作表的 ID。 描述工作表上单元格的数据结构将被忽略,无需提供。 如果 ID 设置为零, xlSheetNm 将返回当前工作表的名称。

如果要传递内部引用 (xltypeSef) ,xlSheetNm 将返回当前工作表的名称。

属性值/返回值

以 形式[Book1]Sheet1返回 (xltypeStr) 工作表的名称。

示例

以下示例显示从中调用函数的工作表的名称。 仅当在执行 XLM 命令宏时从宏表调用时,函数才能正常工作。 这是因为它调用 xlcAlert,只有命令才能执行此操作,并且需要从工作表而不是对话框、菜单或命令栏调用它,以便 xlfCaller 返回引用。

\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;
}

另请参阅