Método Names.Add (Excel)
Define um novo nome para um intervalo de células.
expressão. Adicionar (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)
Expressão Uma variável que representa um objeto Names .
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:
|
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. |
Um objeto Name que representa o novo nome.
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
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.