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 KeystrokeeOn 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 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 | inteiro longo | Value used for the fill. |
| fillDirection | inteiro longo | Direction of the fill. |
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";
}