Compartilhar via

xlfGetDef

  • Artigo

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Retorna o nome, como texto, que é definido para uma determinada área, valor ou fórmula em uma pasta de trabalho. No Excel, esse valor é exibido na coluna Nome da 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 . Use xlfGetDef para obter o nome que corresponde a uma definição. Para obter a definição de um nome, use xlfGetName.

Excel12(xlfGetDef, LPXLOPER12 pxRes, 3, LPXLOPER12 pxDefText, LPXLOPER12 pxDocumentText, LPXLOPER12 pxTypeNum);

Parâmetros

pxDefText (xltypeStr)

Pode ser qualquer coisa que você possa definir um nome para se referir, incluindo uma referência, um valor, um objeto ou uma fórmula.

As referências devem ser dadas no estilo R1C1, como "R3C5". Se pxDefText for um valor ou fórmula, não será necessário incluir o sinal igual que é exibido na coluna Refers To na caixa de diálogo Gerenciador de Nomes . Se houver mais de um nome para pxDefText, xlfGetDef retornará o primeiro nome. Se nenhum nome corresponder a pxDefText, xlfGetDef retornará o valor do #NAME? erro.

pxDocumentText (xltypeStr)

Especifica a planilha na qual pxDefText está ativado. Se pxDocumentText for omitido, presume-se que seja a planilha ativa.

pxTypeNum (xltypeNum)

Um número de 1 a 3 especificando quais tipos de nomes são retornados.

pxTypeNum Retorna
1 ou omitido
 Somente nomes normais.
2
 Somente nomes ocultos.
3
 Todos os nomes.

Valor de propriedade/Valor de retorno

pxRes (xltypeStr ou xltypeErr)

Retorna o nome associado à definição especificada.

Comentários

A tabela a seguir lista quatro exemplos dos valores retornados por uma chamada para xlfGetDef com os argumentos especificados.

Nome definido no Excel pxDefText pxDocumentText pxTypeNum Valor Retornado
O intervalo especificado no Sheet4 se chama Vendas. "R2C2:R9C6"
 "Sheet4"
 <Omitido>
"Vendas"
O valor 100 em Sheet4 é definido como Constante. "100"
 "Sheet4"
 <Omitido>
"Constante"
A fórmula especificada no Sheet4 chama-se SumTotal. "SUM(R1C1:R10C1)"
 "Sheet4"
 <Omitido>
"SumTotal"
3 é definido como o contador de nomes ocultos na planilha ativa. "3"
 <Omitido>
2
 "Contador"

Confira também