Caixas de seleção

4D v16.3

Caixas de seleção

Uso

Uma caixa de seleção é utilizada para introduzir ou mostrar dados bionários (verdadeiro-falso). Uma caixa de seleção é um tipo de botão que pode estar selecionando ou desmarcando. Seu efeito é controlado por um método. Como todos os botões, uma caixa de seleção se inicia no 0 quando o formulário é aberto pela primeira vez. O método associado a uma caixa de seleção é executado quando a caixa de seleção é selecionada.

Geralmente uma caixa de seleção mostra o texto junto a um quadrado pequeno. Este texto é definido na área Título do tema “Objetos” na lista de propriedades. É possível introduzir nesta área uma etiqueta em forma de referência XLIFF ou STR# (ver Apêndice C: arquitetura XLIFF).

Quando o usuário clica no objeto, a caixa é marcada e seu valor é 1. Quando não está marcada, seu valor é 0. Todas as caixas de seleção em um formulário podem ser marcadas ou desmarcadas.

Um grupo de caixas de seleção permite ao usuário selecionar várias opções.

Diferente de um campo booleano com formato de caixa de seleção, os valores da variável da caixa de seleção não são salvos automaticamente. É necessário utilizar um método para manejar a variável.

Nota: As caixas de seleção 3D tem o mesmo funcionamento que as caixas de seleção porém sua aparência (por exemplo, a representação do estado selecionado/não selecionado) é definida pelas propriedades da família de botões 3D. Para maiores informações, consulte o parágrafo Botões 3D, caixa de seleção 3D e botões de opção 3D.

Caixa de seleção de Três Estados

Os objetos de tipo caixas de seleção aceitam um terceiro estado. O terceiro estado é um estado intermediário, usado geralmente para visualização. Este estado permite, por exemplo, indicar que uma propriedade está presente em uma seleção de objetos, porém não em todos os objetos.

Para que uma caixa de seleção tome controle deste terceiro estado, você deve definir a propriedade Três estados no tema “Exibir” da Lista de propriedades:

Esta propiedade está disponível somente para caixas de seleção padrão associadas a variáveis numéricas, as caixas de seleção 3D e as caixas de seleção para campos booleanos não podem utilizar a propriedade Três estados (um campo booleano não puede estar em um estado intermediário).

A variável associada à caixa de seleção retorna o valor 2 quando a caixa de seleção está no estado intermediário.

Dica: no modo entrada, as caixas de seleção mostram cada estado sequencialmente, na seguinte ordem: não selecionado/ selecionado/intermediário/não selecionado, etc. O estado intermediário geralmente não é muito útil no modo entrada; no código, simplesmente força o valor da variável a 0 quando toma o valor 2 com o fim de passar diretamente do estado selecionado ao estado não selecionado.