Saltar para o conteúdo principal
Versão: Próximo

VP Get formula by name

VP Get formula by name ( vpAreaName : Text ; name : Text { ; scope : Number } ) : Object

ParâmetroTipoDescrição
vpAreaNameText->Nome de objeto formulário área 4D View Pro
nameText->Nome do intervalo nomeado
scopeNumber->Âmbito alvo (padrão=folha atual)
ResultadosObject<-Named formula or named range definition

Descrição

The VP Get formula by name command returns the formula and comment corresponding to the named range or named formula passed in the name parameter, or null if it does not exist in the defined scope.

Em vpAreaName, passe o nome da área 4D View Pro. Se passar um nome que não existe, é devolvido um erro.

Pass the named range or named formula that you want to get in name. Note que os intervalos com nome são devolvidos como fórmulas que contém referências absolutas de células.

You can define where to get the formula in scope using either the sheet index (counting begins at 0) or the following constants:

  • vk current sheet
  • vk workbook
Objecto devolvido

O objeto retornado contém as propriedades abaixo:

PropriedadeTipoDescrição
formulaTextTexto da fórmula correspondente à fórmula nomeada ou intervalo nomeado. Para os intervalos nomeados, a fórmula é uma sequência de coordenadas absolutas.
commentTextComentário correspondente à fórmula nomeada ou ao intervalo nomeado

Exemplo

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

$formula:=VP Get formula by name("ViewProArea";"Total1")
//$formula.formula=Sheet1!$A$1

$formula:=VP Get formula by name("ViewProArea";"Total")
//$formula=null (if not existing)

Veja também

VP ADD FORMULA NAME
VP Get names