【XLL API 函数】xlSheetNm

从外部引用包含的工作表ID返回工作表或宏表名称，或是当前表名称。

原型

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

参数

pxExtref (xltypeRef or xltypeSRef)

表示你想引用的工作表名称。如果你传送一个外部引用 (xltypeRef) ，参数就只需要工作表 ID。这种结构上描述工单表的单元格是忽略的和不需要的。如果ID设置为零，xlSheetNm 返回当前工作表名称。

如果你传送一个内部引用( xltypeSef ) ， xlSheetNm 返回当前工作表名称。

属性值 / 返回值

以[Book1]Sheet1 格式返回工作表名称。

实例

接下来的实例，显示了调用xlSheetNm 函数时返回的工作表名称。此函数只能在宏表函数中应用

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