xlfGetName
Hace referencia a: Excel 2013 | Office 2013 | Visual Studio
Devuelve la definición de un nombre tal como aparece en la columna Hace referencia a del cuadro de diálogo Administrador de nombres, que se muestra al hacer clic en Administrador de nombres en la sección Nombres definidos de la pestaña Fórmulas . Si la definición contiene referencias, se proporcionan como referencias de estilo R1C1. Use xlfGetName para comprobar el valor definido por un nombre. Para obtener el nombre que corresponde a una definición, use xlfGetDef.
Excel12(xlfGetName, LPXLOPER12 pxRes, 2, LPXLOPER12 pxNameText, LPXLOPER12 pxInfoType);
Parameters
pxNameText (xltypeStr)
Puede ser un nombre definido en la hoja; una referencia externa a un nombre definido en el libro activo, por ejemplo, "!Sales"; o una referencia externa a un nombre definido en un libro abierto determinado, por ejemplo, "[Book1]SHEET1!Sales".
pxNameText también puede ser un nombre oculto.
pxInfoType (xltypeBool)
Especifica el tipo de información que se va a devolver sobre el nombre. Si se omite o FALSE, se devuelve la definición. Si es TRUE, devuelve TRUE si el nombre se define solo para la hoja, FALSE si el nombre está definido para todo el libro.
Valor de la propiedad/valor devuelto
pxRes (xltypeStr, xltypeBool o xltypeErr)
En función del valor pasado para pxInfoType, devuelve la definición del nombre especificado (xltypeStr) o TRUE o FALSE (xltypeBool).
Comentarios
Si la casilla Proteger hoja de cálculo y contenido de celdas bloqueadas se ha seleccionado en el cuadro de diálogo Proteger hoja para proteger el libro que contiene el nombre, xlfGetName devuelve el valor de #N/A error. Para ver el cuadro de diálogo Proteger hoja , haga clic en Proteger hoja en la sección Cambios de la pestaña Revisar .
En la tabla siguiente se enumeran tres ejemplos de los valores devueltos por una llamada a xlfGetDef con el argumento pxNameText especificado.
| Definición en Excel | pxNameText | Valor devuelto |
|---|---|---|
| El nombre Ventas de una hoja se define como el número 523. | "Ventas" |
"=523" |
| El nombre Profit de la hoja activa se define como la fórmula =Sales-Costs. | "! Beneficios" |
"=Sales-Costs" |
| El nombre Base de datos de la hoja activa se define como el intervalo A1:F500. | "! Base de datos" |
"=R1C1:R500C6" |