On After Edit
Code | Pode ser chamado por | Definição |
---|---|---|
45 | 4D View Pro area - 4D Write Pro area - Combo Box - Form - Input - Hierarchical List - List Box - List Box Column | O conteúdo do objecto inserível que tem o foco acabou de ser modificado |
Descrição
Caso geral
This event can be used filter the data entry in keyboard enterable objects at the lowest level.
When it is used, this event is generated after each change made to the contents of an enterable object, regardless of the action that caused the change, i.e.:
- Standard editing actions which modify content like paste, cut, delete or cancel;
- Eliminar um valor (ação semelhante a colar);
- Any keyboard entry made by the user; in this case, the
On After Edit
event is generated after theOn Before Keystroke
andOn After Keystroke
events, if they are used. - Any modification made using a language command that simulates a user action (i.e.,
POST KEY
).
No evento On After Edit
, os dados texto introduzidos são devolvidos pelo comando Get edited text
.
4D View Pro
O objecto 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 de evento conterá propriedades adicionais.
action = editChange
Propriedade | Tipo | Descrição |
---|---|---|
range | object | Intervalo de células |
editingText | variant | O valor do editor actual |
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 | longint | Valor utilizado para o enchimento. |
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 é colado da área de transferência: |
pasteData | object | Os dados da área de transferência a 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
End if
End if
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";
}