4D Doc Center : CANCEL

4D v14.3

CANCEL


	CANCEL

	Este comando não requer parâmetros

Descrição

O comando CANCEL se utiliza em métodos de objeto ou de formulário (ou em uma subrotina) para:

cancelar a criação ou modificação de um registro ou sub-registro, para o qual a entrada de dados for inicializada utilizando ADD RECORD, MODIFY RECORD, ADD SUBRECORD ou MODIFY SUBRECORD.
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 ou 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).

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).

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.

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.