xlSheetNm
Hace referencia a: Excel 2013 | Office 2013 | Visual Studio
Devuelve el nombre de una hoja de cálculo o una hoja de macros de su identificador interno de hoja contenido dentro de una referencia externa, o el nombre de la hoja actual si se pasa una referencia interna.
Excel12(xlSheetNm, LPXLOPER12 pxRes, 1, LPXLOPER12 pxExtref);
Parameters
pxExtref (xltypeRef o xltypeSRef)
Referencia a la hoja cuyo nombre desea.
Si pasa una referencia externa (xltypeRef), solo debe contener el identificador de la hoja. Las estructuras de datos que describen las celdas de la hoja de cálculo se omiten y no es necesario proporcionarlas. Si el identificador se establece en cero, xlSheetNm devuelve el nombre de la hoja actual.
Si pasa una referencia interna (xltypeSef), xlSheetNm devuelve el nombre de la hoja actual.
Valor de la propiedad/valor devuelto
Devuelve el nombre de la hoja (xltypeStr) en el formulario [Book1]Sheet1.
Ejemplo
En el ejemplo siguiente se muestra el nombre de la hoja desde la que se llamó a la función. La función funciona correctamente solo si se llama desde una hoja de macros mientras se ejecuta una macro de comandos XLM. Esto se debe a que llama a xlcAlert, que solo pueden hacer los comandos, y debe llamarse desde una hoja en lugar de un cuadro de diálogo, un menú o una barra de comandos para que xlfCaller devuelva una referencia.
\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;
}