CANCEL

4D v20.6

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.

ACCEPT
PAGE BREAK
Print form

CANCEL

Descrição

Modo Headless

Exemplo

Variáveis e conjuntos do sistema