VP ADD RANGE NAME

VP ADD RANGE NAME ( rangeObj : Object ; name : Text { ; options : Object } )

Parâmetro	Tipo		Descrição
rangeObj	Object	->	Objeto intervalo
name	Text	->	Nome da fórmula
options	Object	->	Opções para a fórmula nomeada

Descrição

O comando VP ADD RANGE NAME cria ou modifica um intervalo nomeado no documento aberto.

Os intervalos nomeados criados por este comando são guardados com o documento.

Em rangeObj, passe o intervalo que você deseja nomear e, em name, passe o novo nome para o intervalo. Se o nome já estiver a ser utilizado no mesmo âmbito, o novo intervalo nomeado substitui o existente. Note que pode utilizar o mesmo nome para diferentes âmbitos (ver abaixo).

Pode passar um objeto com propriedades adicionais para a fórmula nomeada em options. As propriedades abaixo são compatíveis:

Propriedade	Tipo	Descrição
scope	Number	Âmbito do intervalo. Você pode passar o índice da planilha (a contagem começa em 0) ou usar as seguintes constantes: vk current sheet``vk</li><li> workbookO escopo determina se um nome de intervalo é local em uma determinada planilha (scope=sheet index ou vk current sheet) ou global em toda a pasta de trabalho (scope=vk workbook).
comment	Text	Comentário associado ao intervalo nomeado

• Um intervalo nomeado é, na verdade, uma fórmula nomeada que contém coordenadas. VP ADD RANGE NAME facilitates the creation of named ranges, but you can also use the VP ADD FORMULA NAME method to create named ranges.
• As fórmulas que definem intervalos nomeados podem ser recuperadas com o método [VP Get formula by name] (vp-get-formula-by-name.md).

Exemplo

Pretende criar um intervalo nomeado para um intervalo de células:

$range:=VP Cell("ViewProArea";2;10)
VP ADD RANGE NAME($range;"Total1")

Veja também

VP Get names
VP Name