MODIFY RECORD
MODIFY RECORD ( {tabela}{;}{*} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tabela | Table | → | Tabela a utilizar para entrada de dados ou Tabela por padrão, se omitida |
| * | Operator | → | Ocultar barras de deslocamento |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando MODIFY RECORD permite ao usuário modificar o registro atual da tabela tabela ou da tabela por padrão se é omitido o parâmetro tabela. MODIFY RECORD carrega o registro, se não for carregado pelo processo atual e mostra o formulário de entrada atual. Se não houver registro atual, então MODIFY RECORD não faz nada. MODIFY RECORD não afeta a seleção atual.
O formulário aparece na janela do primeiro plano do processo. A janela tem barras de rolagem e uma caixa de controle do tamanho. Se passar o parâmetro opcional * a janela aparece sem as barras de rolagem e sem a caixa de controle de tamanho.
Para utilizar MODIFY RECORD, o registro atual deve ter acesso de leitura-escritura e não deve estar bloqueado.
Se o formulário contiver botões de navegação entre os registros da seleção, MODIFY RECORD lhe permite ao usuário clicar nos botões para modificar registros e ser movidos a outros registros.
O registro é salvado (aceito) se o usuário clicar no botão Aceitar ou pressionar a tecla Intro (teclado numérico) ou se é executado o comando ACCEPT.
O registro não é guardado se o usuário clicar num botão de tipo CANCELAR ou pressionar a combinação de teclas (Ctrl-Ponto em Windows, Comando-Ponto em Macintosh), ou se é executado o comando CANCEL.
Depois de chamar MODIFY RECORD, a variável sistema OK toma o valor 1 se for aceita o registro e 0 si for cancelada.
Nota: o registro permanece em memória, inclusive quando é cancelada, e pode ser guardada se for executada SAVE RECORD antes de que o ponteiro do registro atual mude.
Se estiver utilizando MODIFY RECORD e o usuário não realiza nenhuma modificação ao registro, não são considerados que o registro tenha sido modificado e ainda que aceite o registro não serão guardadas novamente. As ações tais como a mudança do valor de variáveis, a seleção de caixas de seleção e de botões de opção não são classificadas como modificações. Unicamente a modificação do valor de um campo, através de uma entrada manual ou de um método, faz com que o registro seja guardado novamente.
Exemplos
Ver o exemplo do comando ADD RECORD.
Variáveis e conjuntos do sistema
A variável sistema OK toma o valor 1 se aceitar o registro e 0 se o cancelar. A variável OK não toma nenhum valor até que o registro tenha sido confirmado ou anulado.