Saltar para o conteúdo principal
Versão: 20

On After Edit

CodePode ser chamado porDefinição
454D View Pro area - 4D Write Pro area - Combo Box - Form - Input - Hierarchical List - List Box - List Box ColumnO 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 the On Before Keystroke and On 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:

PropriedadeTipoDescrição
codeinteiro longoOn After Edit
descriptiontext"On After Edit"
objectNametextNome da área 4D View Pro
sheetNametextNome da folha do evento
actiontext"editChange", "valueChanged", "DragDropBlock", "DragFillBlock", "formulaChanged", "clipboardPasted"

Dependendo do valor da propriedade action, o objeto de evento conterá propriedades adicionais.

action = editChange

PropriedadeTipoDescrição
rangeobjectIntervalo de células
editingTextvariantO valor do editor actual

action = valueChanged

PropriedadeTipoDescrição
rangeobjectIntervalo de células
oldValuevariantValor da célula antes da alteração
newValuevariantValor da célula após a alteração

action = DragDropBlock

PropriedadeTipoDescrição
fromRangeobjectIntervalo do células de origem (a ser arrastado)
toRangeobjectIntervalo de células de destino (local de largada)
copybooleanEspecifica se o intervalo fonte é copiado ou não
insertbooleanEspecifica se o intervalo fonte é inserido ou não

action = DragFillBlock

PropriedadeTipoDescrição
fillRangeobjectIntervalo utilizado para o preenchimento
autoFillTypelongintValor utilizado para o enchimento.
  • 0: as células são preenchidas com todos os dados (valores, formatação e fórmulas)
  • 1: as células são preenchidas com dados automáticos sequenciais
  • 2: As células são preenchidas apenas com formatação
  • 3: as células são preenchidas com valores, mas não com formatação
  • 4: Os valores são removidos das células
  • 5: As células são preenchidas automaticamente
  • action = formulaChanged

    PropriedadeTipoDescrição
    rangeobjectIntervalo de células
    formulatextA fórmula introduzida

    action = clipboardPasted

    PropriedadeTipoDescrição
    rangeobjectIntervalo de células
    pasteOptioninteiro longoEspecifica 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: somente as fórmulas são coladas
  • 4: os valores e a formatação são colados (não as fórmulas)
  • 5: as fórmulas e a formatação são coladas (não os valores)
  • pasteDataobjectOs dados da área de transferência a serem colados
  • "text" (texto): O texto da área de transferência
  • "html" (texto): O HTML da área de transferência
  • 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";
    }