REJECT

REJECT tem duas sintaxes. A primeira sintaxe não tem parâmetros. Neste caso, o comando rechaça a totalidade da entrada e obriga ao usuário a permanecer no formulário. A segunda sintaxe recusa somente o campo e obriga ao usuário a permanecer no campo.

Nota: deve considerar utilizar as ferramentas integradas de validação de dados antes de utilizar este comando.

A primeira sintaxe de REJECT evita que o usuário aceite um registro incompleto. Pode alcançar ol mesmo resultado sem utilizar REJECT, associe a tecla Intro com um botão Sem ação e utilize os comandos ACCEPT e CANCEL para aceitar ou cancelar o registro, uma vez os campos foram introduzidos corretamente. É recomendável utilizar esta segunda técnica e não a primeira sintaxe de REJECT.

Se utilizar a primeira sintaxe, você executa REJECT para evitar que o usuário aceite um registro, geralmente porque o registro está incompleto ou tem entradas incorretas. Se o usuário trata de aceitar o registro, a execução de REJECT evita a aceitação do registro; o registro permanece visualizado no formulário. O usuário deve continuar com a entrada de dados até que o registro seja aceitável ou o registro seja cancelado.

O melhor lugar para o comando REJECT, quando se utiliza esta sintaxe, é o método de objeto de um botão Aceitar associado a tecla Intro. Desta forma, a validação ocorre só quando o registro é aceito e o usuário não pode forçar a validação pressionando a tecla Enter.

A segunda sintaxe de REJECT se executa com o parâmetro campo. O cursor permanece na área de entrada do campo. Esta sintaxe de REJECT obriga ao usuário a introduzir um valor correto. Deve ser utilizada imediatamente depois da modificação de um campo. Pode provar a modificação utilizando a função Modified. Igualmente pode utilizar REJECT no método de objeto da área de entrada. Este comando não tem efeito em campos de subformulários.

Deve colocar qualquer das sintaxe do comando REJECT no método de formulário ou no método de objeto do formulário que esteja modificando. Se está utilizando REJECT para ol formulário detalhado de um subformulário para uma tabela, coloque-o no método de formulário o método de objeto para o formulário detalhado.

Pode utilizar HIGHLIGHT TEXT para selecionar os dados no campo que estão sendo recusados.

O seguinte exemplo é sobre um registro de transação bancária que ilustra a primeira sintaxe de REJECT utilizada no método de objeto de um botão Aceitar. A tecla Enter está definida como um equivalente do botão. Isto significa que inclusive se o usuário pressiona a tecla Enter para aceitar o registro, o método de objeto do botão será executado. Se a transação é um cheque, então deve haver um número de cheque. Se não houver um número de cheque, se recusa a validação:

O seguinte exemplo é parte de um método de objeto para um campo [Empregados]Salario. O método de objeto prova o campo [Empregados]Salario e recuza o campo se o valor é menor que 10 000 EUR. Pode realizar a mesma operação especificando um valor mínimo para o campo no editor de formulários: