Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Condição

Objetivo

Permitir a criação de condições, por intermédio de regras, para um botão ficar desabilitado ou escondido em eventos pré-determinados.

ProgramaSO0701J
Pré-Requisito

É pré-requisito para a execução dessa função:
Função Propriedades dos Objetos (SO0701)

Visão Geral

Por intermédio dessa função é possível criar condições para um determinado botão ficar desabilitado ou escondido. A condição é definida por intermédio de regras que podem ser do tipo lista, faixa ou retorno externo.

Descrição

Janela Zoom Condição

Esta janela é executada quando um determinado botão tem a propriedade “Invisível” ou “Desabilitado” com o valor “Condição”, e é pressionado o botão “zoom” na propriedade “Condição” na paleta de propriedades. Nessa tela é possível criar verificações de vários objetos para determinar, por intermédio de seus valores, se o botão deve ou não ficar desabilitado ou invisível em determinados momentos (dependendo da validação).

...

Informações
titleImpotante:

Para a propriedade condição, deve ser informada uma regra, que se for validada com sucesso, DESABILITA ou ESCONDE o botão previamente selecionado. Dessa forma, se for necessário o botão ficar habilitado/visível quando o objeto cod-estab for igual a 100, deve ser criada a seguinte regra:

Objeto cod-estab  .:. LISTA <> 100

Janela Zoom Condição - Opção Lista

A opção “Lista” permite criar uma regra com uma lista de possíveis valores, como, por exemplo de 1,2 ou 3.

...

Campo

Descrição

Lista

Campo utilizado para ser(em) informado(s) o(s) valor(es) que o objeto precisa ter para ser desabilitado ou escondido.

Informações
titleImpotante:

O objeto selecionado fica com a cor azul , enquanto selecionado na lista, para facilitar sua identificação.

Janela Zoom Condição - Opção Faixa

A opção “Faixa” permite criar uma regra com uma faixa de possíveis valores, como, por exemplo de 1 a 50.

...

Campo

Descrição

De

Usado para informar o valor inicial da faixaCampo utilizado para ser(em) informado(s) o(s) valor(es) que o objeto precisa ter para ser desabilitado ou escondido.

AtéUsado para informar o valor final da faixa.

Janela Zoom Condição - Opção Retorno Externo

A opção “Retorno Externo” permite que seja criada uma regra baseada no retorno lógico de um programa externo.

...

Informações
titleImportante:

O método do programa usado no  “Retorno Externo” deve definir dois parâmetros de saída:

  • um valor do tipo lógico (que indica se a validação ocorreu com sucesso ou não).
  • e valor caracter  (que permite definir uma mensagem de erro para mostrar ao usuário, quando a validação não ocorreu com sucesso).

Dica 1 - utilizando o recurso do retorno externo, é possível efetuar validações mais complexas, inclusive envolvendo valores de outros objetos da tela.

Dica 2 - eventualmente pode ser construído um método de retorno externo para lista de valores e para condição que tenham o mesmo objetivo ou a mesma codificação. Mas como a lista de valores deve retornar YES para OK e a propriedade condição tem que retornar YES para desabilitar, na condição pode ser criada uma regra utilizando o mesmo método de validação, apenas com o tipo diferente (<>). Dessa forma, se o retorno externo for NO, o objeto é desabilitado ou escondido.

Dica 3 - é recomendado que, para programas do EMS2 e HR, a propriedade “Condição” seja utilizada em conjunto com a propriedade “Invisível” (devido à arquitetura interna). Para os programas do EMS5, a propriedade “Condição” pode ser utilizada em conjunto com a propriedade “Invisível” ou “Desabilitado”.

Janela Condições Existentes

Esta janela é executada pelo botão “Cópia” da janela “Zoom Condição”. Nela é possível selecionar qual botão da tela (que tenha a propriedade “Condição” utilizada) deve ser utilizado como base para efetuar a cópia das regras da propriedade “Condição”.

...