Classe Names (Excel VBA)

Uma coleção de todos os objetos Name no aplicativo ou na pasta de trabalho. Para usar uma variável de classe Names, ela primeiro precisa ser instanciada por exemplo

Dim nms as Names
Set nms = ActiveWorkbook.Names

For Each

Aqui está um exemplo de processamento dos itens Names em uma coleção.

Dim nam As Name
For Each nam In Names
	
Next nam

Add

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

Add (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

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

Arguments

Optional arguments

Os seguintes argumentos são opcionais

Name (String) - 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 (Range) - Descreve a que se refere o nome, em inglês, usando a 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 (Boolean) - 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 nomeou ir para. O valor padrão é True.

MacroType (Byte) - 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 (String) - Especifica a tecla de atalho da macro. Deve ser uma única letra, como "z" ou "Z". Aplica-se somente a macros de comando.

Category (String) - 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 (String) - 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 (String) - Descreve a que se refere o nome, no texto localizado, usando a notação de estilo __ a1, se os parâmetros referito, _RefersToR1C1_e RefersToR1C1Local não forem especificados.

CategoryLocal (String) - Especifica o texto localizado que identifica a categoria de uma função personalizada se o parâmetro Category não for especificado.

RefersToR1C1 (String) - Descreve a que se refere o nome, em inglês, usando a notação de estilo __ L1C1, se os parâmetros referito, _RefersToLocal_e RefersToR1C1Local não forem especificados.

RefersToR1C1Local (String) - Descreve a que se refere o nome, no texto localizado, usando a notação de estilo __ L1C1, se os parâmetros referito, _RefersToLocal_e RefersToR1C1 não forem especificados.

Count

Retorna um valor Long que representa o número de objetos na coleção.

Dim lngCount As Long
lngCount = ActiveWorkbook.Names.Count

Item

Retorna um único objeto Name de uma coleção Names .

Você deve especificar somente um desses três argumentos.

Item (Index, IndexLocal, RefersTo)

ActiveWorkbook.Names.Item("mySortRange").Delete

Arguments

Optional arguments

Os seguintes argumentos são opcionais

Index (Long) - O nome ou número do nome definido a ser retornado.

IndexLocal (String) - O nome do nome definido, no idioma do usuário. Nenhum nome será traduzido se você usar este argumento.

RefersTo (String) - A que o nome se refere. Você usa este argumento para identificar um nome pelo elemento ao qual ele se refere.