Método Names.Add (Excel)

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

Sintaxe

mais simples. 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 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 Variant Descreve a que o nome se refere, em inglês, usando notação no 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 é exibido na caixa de diálogo Definir Nome, Colar Nome ou Ir para . 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 criará uma nova categoria se a categoria especificada não existir.
NameLocal Opcional Variant Especifica o texto localizado a ser usado 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 a que o nome se refere, em texto localizado usando notação de estilo A1, se os parâmetros RefersTo, RefersToR1C1 e RefersToR1C1Local não estiverem 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 a que o nome se refere, em inglês usando notação no estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1Local não estiverem especificados.
RefersToR1C1Local Opcional Variant Descreve a que o nome se refere, em texto localizado usando notação de estilo R1C1, se os parâmetros RefersTo, RefersToLocal e RefersToR1C1 não estiverem 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.

  • Last updated on