VP Get active cell

4D v18

VP Get active cell


VP Get active cell ( vpNomeArea {; planilha} ) -> Resultado

Parâmetro	Tipo	Descrição
vpNomeArea	Texto	Nome de objeto de área de formulário 4D View Pro
planilha	Inteiro longo	índice de planilha (folha de cálculo atual se omitido)
Resultado	Objeto	Objeto range de uma célula

Descrição

O comando VP Get active cell retorna um novo objeto range que faz referência à celula que tem o foco e onde novos dados serão digitados (a célula ativa).

Em vpNomeArea, passe o nome da área 4D View Pro. Se passar um nome que não existir, um erro é retornado.

No parâmetro opcional planilha, pode indicar uma folha de cálculo específica onde a range será definida (índice começa em 0). Se omitida, a folha de cálculo atual será usada como o padrão. Pode selecionar explicitamente a folha de cálculo atual com a constante abaixo

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

Exemplo

O código abaixo:

 $activeCell:=VP Get active cell("myVPArea")

 

  //devolve um objeto range que contém: 

  //$activeCell.ranges[0].column=3

  //$activeCell.ranges[0].row=4

  //$activeCell.ranges[0].sheet=0

recuperará as coordenadas da célula ativa: