On After Edit
Code | Pode ser chamado por | Definição |
---|---|---|
45 | Área 4D View Pro - Área 4D Write Pro - Caixa de Combinação - Formulário - Entrada - Lista Hierárquica - List Box - Coluna de List Box | O conteúdo do objecto inserível que tem o foco acabou de ser modificado |
Descrição
Caso geral
Este evento pode ser usado para filtrar a entrada de dados nos objetos digitáveis do teclado no nível mais baixo.
Quando é usado, este evento é gerado após cada alteração feita no conteúdo de um objeto inserível, independentemente da ação que causou a alteração, ou seja:
- Ações de edição padrão que modificam conteúdo como colar, cortar, excluir ou cancelar;
- Eliminar um valor (ação semelhante a colar);
- Qualquer entrada de teclado feita pelo usuário; neste caso, o evento
On After Edit
é gerado após os eventosOn Before Keystroke
eOn After Keystroke
, se eles forem utilizados. - Qualquer modificação feita usando um comando de linguagem que simula uma ação do usuário (ou seja,
POST KEY
).
No evento No After Edit
, os dados de texto sendo inseridos são retornados pelo comando Obter texto editado
.
4D View Pro
O objeto devolvido pelo comando FORM Event
contém:
Propriedade | Tipo | Descrição |
---|---|---|
code | inteiro longo | On After Edit |
description | text | "On After Edit" |
objectName | text | Nome da área 4D View Pro |
sheetName | text | Nome da folha do evento |
action | text | "editChange", "valueChanged", "DragDropBlock", "DragFillBlock", "formulaChanged", "clipboardPasted" |
Dependendo do valor da propriedade action
, o objeto do evento irá conter propriedades adicionais.
action = editChange
Propriedade | Tipo | Descrição |
---|---|---|
range | object | Intervalo de células |
editingText | variant | O valor do editor atual |
action = valueChanged
Propriedade | Tipo | Descrição |
---|---|---|
range | object | Intervalo de células |
oldValue | variant | Valor da célula antes da alteração |
newValue | variant | Valor da célula após a alteração |
action = DragDropBlock
Propriedade | Tipo | Descrição |
---|---|---|
fromRange | object | Intervalo do células de origem (a ser arrastado) |
toRange | object | Intervalo de células de destino (local de largada) |
copy | boolean | Especifica se o intervalo fonte é copiado ou não |
insert | boolean | Especifica se o intervalo fonte é inserido ou não |
action = DragFillBlock
Propriedade | Tipo | Descrição |
---|---|---|
fillRange | object | Intervalo utilizado para o preenchimento |
autoFillType | inteiro longo | Valor usado para o preenchimento. |
fillDirection | inteiro longo | Direção do preenchimento. |
action = formulaChanged
Propriedade | Tipo | Descrição |
---|---|---|
range | object | Intervalo de células |
formula | text | A fórmula introduzida |
action = clipboardPasted
Propriedade | Tipo | Descrição |
---|---|---|
range | object | Intervalo de células |
pasteOption | inteiro longo | Especifica o que foi colado na área de transferência: |
pasteData | object | Os dados da área de transferência para serem colados |
Exemplo
Eis um exemplo de tratamento de um evento On After Edit
:
If(FORM Event.code=On After Edit)
If(FORM Event.action="valueChanged")
ALERT("WARNING: You are currently changing the value\
from "+String(FORM Event.oldValue)+\
" to "+String(FORM Event.newValue)+"!")
End if
End if
O exemplo acima poderia gerar um objeto evento como este:
{
"code":45;
"description":"On After Edit";
"objectName":"ViewProArea"
"sheetname":"Sheet1";
"action":"valueChanged";
"range": {area:ViewProArea,ranges:[{column:1,row:2,sheet:1}]};
"oldValue":"The quick brown fox";
"newValue":"jumped over the lazy dog";
}