Método Names.Add (Excel)

Define um novo nome para um intervalo de células.

Sintaxe

expressão. Add (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

expressão Uma variável que representa um objeto Names .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Name	Opcional	Variant	Especifica o texto, em inglês, a utilizar como o nome se o parâmetro NameLocal não for especificado. Os nomes não podem conter espaços nem podem ser formatados como referências a células.
RefersTo	Opcional	Variant	Descreve o que o nome se refere, em inglês, através da notação de estilo A1, se os parâmetros RefersToLocal, RefersToR1C1 e RefersToR1C1Local não forem especificados. NOTA: nada é devolvido se a referência não existir.
Visible	Opcional	Variant	True especifica que o nome está definido como visível. False especifica que o nome está definido como oculto. Um nome oculto não aparece na caixa de diálogo Definir Nome, Colar Nome ou Goto . O valor padrão é True.
MacroType	Opcional	Variant	O tipo de macro, determinado por um destes valores: 1 - Função definida pelo usuário (procedimento Function) 2 - Macro (procedimento Sub) 3 ou omitido - Nenhum (o nome não se refere a uma macro ou função definida pelo usuário)
ShortcutKey	Opcional	Variant	Especifica a tecla de atalho da macro. Deve ser uma única letra, como "z" ou "Z". Aplica-se somente a macros de comando.
Category	Opcional	Variant	A categoria da macro ou função se o argumento MacroType for igual a 1 ou 2. A categoria é usada no Assistente de Função. Categorias existentes podem ser referidas por número, começando por 1, ou por nome, em inglês. O Excel cria uma nova categoria se a categoria especificada não existir.
NameLocal	Opcional	Variant	Especifica o texto localizado a utilizar como o nome se o parâmetro Nome não for especificado. Os nomes não podem conter espaços nem podem ser formatados como referências a células.
RefersToLocal	Opcional	Variant	Descreve o que o nome se refere, em texto localizado com notação de estilo A1, se os parâmetros RefersTo, RefersToR1C1 e RefersToR1C1Local não forem especificados.
CategoryLocal	Opcional	Variant	Especifica o texto localizado que identifica a categoria de uma função personalizada se o parâmetro Categoria não for especificado.
RefersToR1C1	Opcional	Variant	Descreve o que o nome se refere, em inglês com notação de estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1Local não forem especificados.
RefersToR1C1Local	Opcional	Variant	Descreve o que o nome se refere, em texto localizado com notação de estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1 não forem especificados.

Valor de retorno

Um objeto Nome que representa o novo nome.

Exemplo

Este exemplo define um novo nome para o intervalo A1:D3 de Sheet1 na pasta de trabalho ativa.

Observação

Nothing será retornado se Sheet1 não existir.

Sub MakeRange() 
 
    ActiveWorkbook.Names.Add _ 
        Name:="tempRange", _ 
        RefersTo:="=Sheet1!$A$1:$D$3" 
 
End Sub

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.