VP ADD RANGE NAME

4D v18

VP ADD RANGE NAME


VP ADD RANGE NAME ( objRange ; nome {; opções} )

Parâmetro	Tipo	Descrição
objRange	Objeto	Objeto Range
nome	Texto	Nome da range
opções	Objeto	Opções para a range nomeada

Descrição

O comando VP ADD RANGE NAME cria ou modifica uma range (faixa ou gama de seleção) nomeada no documento aberto.

Nota: Ranges nomeadas criadas por este comando são salvas com o documento.

Em objRange, pase a range (faixa de seleção de objetos) que deseja nomear e em nome, passe o novo nome para a range. Se o nome já for usado dentro do mesmo alcance (escopo), a novo range nomeada substitui a existente. Lembre que pode utilizar o mesmo nome para diferentes alcances (ver abaixo).

Pode passar um objeto com propriedades adicionais para a range nomeada em opções. As propriedades abaixo são compatíveis:

Propriedade

Tipo

Descrição

scope

Numérico

Alcance para a range. Pode passar o índice da folha (contando a partir de 0)ou utilizar as constantes a seguir:

Constante	Valor	Comentário
vk current sheet	-1	Determina a folha atual de área 4D View Pro (padrão)
vk workbook	-2	Determina toda a folha de área 4D View Pro.

Nota: o alcance determina se um nome de range for local para uma folha de trabalho determinada (alcance = índice de folha ou vk current sheet), o global em todo o livro de trabalho (alcance =vk workbook).

comment

Texto

Comentário associado à range nomeada

Notas:

Já que uma range nomeada é basicamente uma fórmula nomeada que contém corrdenadas, VP ADD RANGE NAME facilita a criação das ranges nomeadas, mas também é possível usar o comando VP ADD FORMULA NAME para criar ranges nomeadas
As ranges com nome e as fórmulas podem ser recuperadas com o comando VP Get formula by name.

Exemplo

Se quiser criar uma range nomeada para uma range de células:

 $range:=VP Cell("ViewProArea";2;10)

 VP ADD RANGE NAME($range;"Total1")