Saltar para o conteúdo principal
Versão: 20 R6

VP ADD RANGE NAME

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

ParâmetroTipoDescrição
rangeObjObject->Objeto intervalo
nameText->Nome da fórmula
optionsObject->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:

PropriedadeTipoDescrição
scopeNumberÂ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).
    commentTextComentá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