xlfGetName
Aplica-se a: Excel 2013 | Office 2013 | Visual Studio
Retorna a definição de um nome como ele aparece na coluna Referenciar à caixa de diálogo Gerenciador de Nomes , que é exibida quando você clica no Gerenciador de Nomes na seção Nomes Definidos na guia Fórmulas . Se a definição contiver referências, elas serão dadas como referências de estilo R1C1. Use xlfGetName para marcar o valor definido por um nome. Para obter o nome que corresponde a uma definição, use xlfGetDef.
Excel12(xlfGetName, LPXLOPER12 pxRes, 2, LPXLOPER12 pxNameText, LPXLOPER12 pxInfoType);
Parâmetros
pxNameText (xltypeStr)
Pode ser um nome definido na planilha; uma referência externa a um nome definido na pasta de trabalho ativa, por exemplo, "!Sales"; ou uma referência externa a um nome definido em uma pasta de trabalho aberta específica, por exemplo, "[Book1]SHEET1!Sales".
pxNameText também pode ser um nome oculto.
pxInfoType (xltypeBool)
Especifica o tipo de informação a ser retornada sobre o nome. Se FALSE ou omitido, a definição será retornada. Se TRUE, retornará TRUE se o nome for definido apenas para a planilha, FALSE se o nome for definido para toda a pasta de trabalho.
Valor de propriedade/Valor de retorno
pxRes (xltypeStr, xltypeBool ou xltypeErr)
Dependendo do valor passado para pxInfoType, retorna a definição do nome especificado (xltypeStr) ou TRUE ou FALSE (xltypeBool).
Comentários
Se a planilha Proteger e o conteúdo das células bloqueadas marcar caixa tiver sido selecionada na caixa de diálogo Proteger Planilha para proteger a pasta de trabalho que contém o nome, xlfGetName retornará o valor de #N/A erro. Para ver a caixa de diálogo Proteger Planilha , clique em Proteger Planilha na seção Alterações da guia Examinar .
A tabela a seguir lista três exemplos dos valores retornados por uma chamada para xlfGetDef com o argumento pxNameText especificado.
| Definição no Excel | pxNameText | Valor Retornado |
|---|---|---|
| O nome Vendas em uma planilha é definido como o número 523. | "Vendas" |
"=523" |
| O nome Lucro na planilha ativa é definido como a fórmula =Sales-Costs. | "! Lucro" |
"=Sales-Costs" |
| O nome Banco de Dados na planilha ativa é definido como o intervalo A1:F500. | "! Banco de dados" |
"=R1C1:R500C6" |