Eventos formulario 4D View Pro

4D v19

Overview

Os eventos de formulário abaixo estão disponíveis na Lista Propriedades para áreas 4D View Pro:

Alguns dos eventos são eventos formulários padrão (disponíveis para todos os objetos ativos) e alguns são eventos formulários 4D View Pro específicos. Os eventos de formulário 4D View Pro específicos oferecem informações adicionais no objeto retornado pelo comando FORM Event quando são gerados para áreas 4D View Pro. A tabela abaixo mostra que eventos são padrão e quais são específicos para eventos de formulário 4D View Pro:

Eventos 4D padrão (ver Form event code)	Eventos 4D View Pro específicos
On Load	On VP Ready
On Getting Focus	On Clicked
On Losing Focus	On Double Clicked
On Unload	On Header Click
	On After Edit
	On Selection Change
	On Column Resize
	On Row Resize

On VP Ready

Todo código de inicialização de área 4D View Pro, para carregar ou ler valores desde ou na área, deve estar localizado no evento de formulário On VP Ready da área. Este evento de formulário se ativa quando tiver completado o carregamento da área. Provar este evento assegura que o código será executado em um contexto válido. Un erro é devolvido se chamar a um comando 4D View Pro antes de gerar o evento de formulário On VP Ready.

Nota: as áreas 4D View Pro são carregadas assincronamente em formulários 4D. Isso significa que o evento de formulário On load padrão não pode ser utilizado pelo código de inicialização 4D View Pro, já que poderia ser executado antes de que se complete o carregamento da área. On VP Ready sempre é gerado depois de On load.

On Clicked

Cliar em qualquer parte de um documento 4D View Pro gera o evento On Clicked. O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On Clicked
description	text	"On Clicked"
objectName	text	nome área 4D View Pro
sheetName	text	Nome da planilha do evento
range	objeto	Range de células.

Exemplo:

 If(FORM Event.code=On Clicked)

    VP SET CELL STYLE(FORM Event.range;New object("backColor";"green"))

 End if

On Double Clicked

Quando um usuário der um duplo clique em qualquer parte de um documento 4D View Pro, o evento On Double Clicked é gerado. O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On Double Clicked
description	text	"On Double Clicked"
objectName	text	nome área 4D View Pro
sheetName	text	Nome da planilha do evento
range	objeto	Range de células

Exemplo:

 If(FORM Event.code=On Double Clicked)

    $value:=VP Get value(FORM Event.range)

 End if

On Header Click

Se um usuário clicar no cabeçalho de coluna ou linha em um documento 4D View Pro gera o evento On Header Click. O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On Header Click
description	text	"On Header Click"
objectName	text	nome área 4D View Pro
sheetName	text	Nome da planilha do evento
range	objeto	Range de células
sheetArea	longint	O local da planilha onde o evento ocorre: 0: A área entre a cabeçalhos de coluna números/letras (canto esquerdo superior da planilha) 1: Os cabeçalhos coluna (área indicando os números/letras coluna) Os cabeçalhos linhas (área indicando os números linha)

Exemplo:

 If(FORM Event.code=On Header Click)

    Case of

       :(FORM Event.sheetArea=1)

          $values:=VP Get values(FORM Event.range)

       :(FORM Event.sheetArea=2)

          VP SET CELL STYLE(FORM Event.range;New object("backColor";"gray"))

       :(FORM Event.sheetArea=0)

          VP SET CELL STYLE(FORM Event.range;New object("borderBottom";New object("color";"#800080";"style";vk line style thick)))

    End case

 End if

On After Edit

Depois de qualquer modificação de um documento 4D View Pro, o evento On After Edit é gerado. O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On After Edit
description	text	"On After Edit"
objectName	text	nome área 4D View Pro
sheetName	text	Nome de planilha do evento
action	text	"editChange", "valueChanged", "DragDropBlock", "DragFillBlock", "formulaChanged", "clipboardPasted"

Nota: ver também o evento On VP Range Changed.

Dependendo do valor da propriedade action, o objeto vai conter propriedades adicionais.

action = editChange

Editar o texto gera as propriedades adicionais abaixo:

Propriedade	Tipo	Descrição
range	objeto	Range de células
editingText	variant	O valor do editor atual

action = valueChanged

Mudar valores gera as propriedades adicionais abaixo:

Propriedade	Tipo	Descrição
range	objeto	Range de células
oldValue	variant	Valor da célula antes da mudança
newValue	variant	Valor da célula depois da mudança

action = DragDropBlock

Ações de arrastar e soltar geram a inclusão das propriedades adicionais abaixo:

Propriedade	Tipo	Descrição
fromRange	object	Range da seleção de células origem (sendo arrastada)
toRange	object	Range da seleção de células destino (local de largar)
copy	boolean	Especifica se a seleção de fonte é copiada ou não
insert	boolean	Especifica se a seleção fonte é inserida ou não

action = DragFillBlock

Arrastar conteúdos para preencher células adjacentes gera as propriedades adicionais abaixo:

Propriedade	Tipo	Descrição
fillRange	object	Seleção usada para preencherl
autoFillType	longint	Valor usado para o preenchimento. 0: Células são preenchidas com todos os dados (valores, formataçãoe fórmulas) 1: Células são preenchidas com dados sequenciasi automaticamente 2: Células são preenchidas com formatação apenas 3: Células são preenchidas com valores mas não formatação 4: Valores são removidos das células 5: Células são preenchidas automaticamente
fillDirection	longint	Direção do preenchimento. 0: As células para a esquerda são preenchidas 1: as células para a direita são preenchidas 2: As células para cima são preenchidas 3: As células abaixo são preenchidas

action = formulaChanged

Digitar fórmulas gera as propriedades abaixo:


Propriedade	Tipo	Descrição
range	object	Range da célula
formula	text	a fórmula inserida

action = clipboardPasted

Colar conteúdos a partir da área de transferência gera as propriedades adicionais abaixo:

Propriedade

Tipo

Descrição

cellRange

object

A seleção recebe os conteúdos

pasteOption

longint

específica o que é colado da área de transferência:

0: Tudo é colado (valores, formatação e fórmulas)

1: Apenas os valores são colados

2: Apenas a formatação é colada

3: Apenas as fórmulas são coladas

4: Valores e formatação são colados (mas não as fórmulas)

5: Fórmulas e formatação são coladas (mas não os valores)

pasteData

object

Os dados da área de transferência a ser colados

Propriedade	Tipo	Descrição
text	text	o texto da área de transferência
html	text	o HTML da área de transferência

Exemplo

Aqui está um exemplo manejando o evento On After Edit:

 If(FORM Event.code=On After Edit)

    If(FORM Event.action="valueChanged")

       ALERT("WARNING: Você está mudando o valor de "+String(FORM Event.oldValue)+" para "+String(FORM Event.newValue)+"!")

    End if

 End if

O exemplo acima poderia gerar um objeto evento (ver FORM Event) como este:


{
"code":45;
"description":"On After Edit";
"objectName":"ViewProArea"
"sheetIndex":0;
"sheetname":"Sheet1";
"action":"valueChanged";
"row":9;
"column":3;
"oldValue":"The quick brown fox";
"newValue":"jumped over the lazy dog";
}

On Selection Change

Modificação da seleção de linhas ou colunas atual em um documento 4D View Pro gera o evento On Selection Change . O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On Selection Change
description	text	"On Selection Change"
objectName	text	nome de área 4D View Pro
sheetIndex	longint	Indice de folha do evento
sheetName	text	Nome da folha do evento
oldSelections	range	Coleção de seleção de objetos antes da mudança.
newSelections	range	Coleção de objetos seleção range depois da mudança:

Exemplo:

 If(FORM Event.code=On Selection Change)

    VP SET CELL STYLE(FORM Event.oldSelections;New object("backColor";Null))

    VP SET CELL STYLE(FORM Event.newSelections;New object("backColor";"red"))

 End if

On Column Resize

Quando um usuário modifica a largura da coluna em um documento 4D View Pro, o evento On Column Resize é gerado. O objeto retornado pelo comando FORM Event contém:

Propriedade	Tipo	Descrição
code	longint	On Column Resize
description	text	"On Column Resize"
objectName	text	4D View Pro nome de área
sheetIndex	longint	Indice da folha do evento
sheetName	text	Nome da folha do evento
range	objeto	Range de células das colunas cujas larguras mudaram
header	boolean	True se o cabelho (primeira coluna) for redimensionado, senão false

Exemplo:

 If(FORM Event.code=On Column Resize)

    VP SET CELL STYLE(FORM Event.range;New object("hAlign";vk horizontal align right))

 End if

On Row Resize

Um usuário que esteja modificando a altura das linhas em um documento 4D View Pro gera o evento On Row Resize. O objeto retornado pelo comando FORM Event contém:

Propriedades	Tipo	Descrição
code	longint	On Row Resize
description	text	"On Row Resize"
objectName	text	nome da área 4D View Pro
sheetIndex	longint	Indice da folha de cálculo do evento
sheetName	text	Nome da folha de cálculo do evento
range	objeto	Range de células das linhas cujas alturas mudaram
header	boolean	True se o cabeçalho de coluna da linha (primeira linha) for redimensionado, senão false

Example:

 If(FORM Event.code=On Row Resize)

    VP SET CELL STYLE(FORM Event.range;New object("vAlign";vk vertical align top))

 End if

On VP Range Changed

Quando produzir uma mudança dentro de um intervalo de células no documento 4D View Pro, se gera o evento On VP Range Changed. O objeto devolvido pelo comando FORM Event contiém:

Propriedade	Tipo	Descrição
objectName	texto	Nome da área 4D View Pro
code	inteiro longo	On VP Range Changed
description	texto	"On VP Range Changed"
sheetName	texto	Nome da folhla de evento
range	objeto	Intervalo de células da mudança
changedCells	objeto	Intervalo que contém apenas as celulas modificas. Pode ser um intervalo combinado.
action	texto	Tipo de operação que gera o evento: "clear" - Uma operação de valor de intervalo "dragDrop" - Uma operação de arrastar e soltar "dragFill" - Uma operação de arrastar e preencher "evaluateFormula" - Definir uma fórmula em um intervalo de células especificado "paste" - Uma operação de colar "setArrayFormula" - Definir uma fórmula em um intervalo de células especificado "sort" - Ordenar um intervalo de células

Nota: ver também On After Edit.