CANCEL
CANCEL
| Este comando não requer parâmetros |
|---|
Descrição
No contexto de entrada de dados, CANCEL realiza a mesma ação que se o usuário tivesse pressionado a tecla de cancelação (Esc). Também é possível colocar no método de caixa de fechamento opcional de uma janela criada pelo comandoOpen window
O comando CANCEL se utiliza em métodos de objeto ou de formulário (ou em uma subrotina) para:
- cancelar um registro novo ou modificado, para o qual a entrada de dados for inicializada utilizando ADD RECORD ou MODIFY RECORD.
- cancelar um formulário mostrado através do comando DIALOG.
- sair de um formulário que mostra uma seleção de registros, utilizando DISPLAY SELECTION o MODIFY SELECTION.
- cancelar a impressão de um formulário que estiver a ponto de ser impresso utilizando o comando Print form (ver a continuação).
CANCEL é executado com frequência como resultado da seleção de um comando de menu. CANCEL também é utilizado com frequência no método de objeto de um botão “sem ação”.
Este comando também é usado no método da caixa de fechamento opcional de uma janela criada por el comando Open window. Se houver uma janela com caixa de controle de menu, pode chamar a ACCEPT ou CANCEL, no método a executar, quando se dá duplo clique na caixa de controle de menu ou se selecione o comando de menu Fechar.
Não é possível concatenar vários CANCEL. A execução consecutiva de dois comandos CANCEL em um método terá o mesmo resultado que a execução de um só comando.
Finalmente, este comando pode ser utilizado não evento de formulário On Printing Detail, quando é utilizado o comando Print form. Neste contexto, o comando CANCEL suspende a impressão do formulário que estiver a ponto de ser impresso, depois retoma na seguinte página. Este mecanismo pode ser utilizado para administrar a impressão de formulários quando não houver suficiente espaço ou no caso de que seja necessária uma quebra de página.
Nota: esta operação é diferente da do comando PAGE BREAK(*)que cancela TODOS os formulários que estão a espera de impressão.
Modo Headless
O comando CANCEL é permitido no modo headless (computador sem periféricos), no contexto de áreas offscreen criadas por VP Run offscreen area ou WA Run offscreen area.
Exemplo
Consulte o exemplo do comando SET PRINT MARKER.
Variáveis e conjuntos do sistema
Quando o comando CANCEL é executado (anulação de formulário ou de impressão), a variável sistema OK assume o valor 0.