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 |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.