Método Names.Add (Excel)

  • Artigo

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.