EDIT FORMULA

EDIT FORMULA ( tabela ; formula )

Parâmetro	Tipo		Descrição
tabela	Table	→	Tabela a mostrar por padrão no editor de fórmulas
formula	Text	→	Variável que contem a fórmula a mostrar no editor de fórmulas ou "" somente para mostrar o editor
←	Fórmula validada pelo usuário

Descrição

O comando EDIT FORMULA mostra o editor de fórmulas com o propósito de permitir ao usuário escrever ou modificar uma fórmula. O editor contém ao abrir:

• na lista da esquerda, os campos da tabela passados no parâmetro tabela,
• na área de fórmula, a fórmula contida na variável formula. Se passa uma cadeia vazia em formula, o editor é mostrado sem fórmula.

O usuário pode modificar e guardar a formula mostrada. Também é possível escrever ou carregar uma nova fórmula. Entretanto, se o usuário valida a caixa de diálogo, a variável de sistema OK toma o valor 1 e a variável formula contém a fórmula definida pelo usuário. Se o usuário cancela a fórmula, a variável sistema OK toma o valor 0 e a variável formula não muda.

Nota:

• por padrão, o acesso aos métodos e aos comandos está restrito para os usuários (exceto para o Desenhista (designer) e Administrador, em bancos de dados criadas com 4D 2004.4 e posteriores). Quando este mecanismo estiver ativado, você deve designar explicitamente os elementos acessíveis aos usuários utilizando o comando SET ALLOWED METHODS. Se a formula chama métodos que não foram autorizados previamente no editor de fórmulas utilizando o comando SET ALLOWED METHODS, é gerado um erro de sintaxe e não poderá validar a caixa de diálogo.
• O editor de fórmula não está associado com qualquer barra de menu por padrão. É preciso instalar um menu padrão Edit no processo de chamada se quiser que os usuários possam se beneficiar de atalhos cortar/copiar/pegar no editor de fórmula.
• A estrutura virtual definida pelos comandos SET TABLE TITLES e SET FIELD TITLES (se houver) não pode ser usada na variável fórmula - nem será usada por 4D na variável retornada. A estrutura virtual é usada apenas na caixa de diálogo editor Fórmula.

Lembre que quando se valida a caixa de diálogo, o comando não executa a formula; só valida e atualiza o conteúdo da variável. Se quer executar a formula, deve utilizar o comando EXECUTE FORMULA .

Exemplo

Visualização do editor de fórmulas com a tabela [Empregados] e sem uma fórmula introduzida previamente:

 $minhaFormula:=""
 EDIT FORMULA([Empregados];$minhaFormula)
 If(OK=1)
    APPLY TO SELECTION([Empregados];EXECUTE FORMULA($minhaFormula))
 End if

Variáveis e conjuntos do sistema

Se o usuário valida a caixa de diálogo, a variável de sistema OK toma o valor 1. Se o usuário anula a caixa de diálogo, a variável sistema OK toma o valor 0.

Ver também

APPLY TO SELECTION
EXECUTE FORMULA
SET ALLOWED METHODS

Propriedades

Número do comando	806
Thread-seguro	✗
Modificar variáveis	OK