Método Names.Add (Excel)

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

Sintaxe

expressão. Adicionar (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	Variantes	Especifica o texto, em inglês, a ser usado 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	Variantes	Descreve a que nome se refere, em inglês, usando notação de estilo A1, se os parâmetros RefersToLocal, RefersToR1C1 e RefersToR1C1Local não forem especificados. OBSERVAÇÃO: nada será retornado 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	Variantes	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 criará uma nova categoria se a categoria especificada não existir.
NameLocal	Opcional	Variantes	Especifica o texto localizado a ser usado como o nome se o parâmetro Name não for especificado. Os nomes não podem conter espaços nem podem ser formatados como referências a células.
RefersToLocal	Opcional	Variantes	Descreve a que nome se refere, em texto localizado usando notação de estilo A1, se os parâmetros RefersTo, RefersToR1C1 e RefersToR1C1Local não forem especificados.
CategoryLocal	Opcional	Variantes	Especifica o texto localizado que identifica a categoria de uma função personalizada se o parâmetro Category não for especificado.
RefersToR1C1	Opcional	Variantes	Descreve o que o nome se refere, em inglês, usando notação no estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1Local não forem especificados.
RefersToR1C1Local	Opcional	Variantes	Descreve a que nome se refere, em texto localizado usando notação no estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1 não forem especificados.

Valor de retorno

Um objeto Name 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.