Caixas de seleção

4D v20 R8

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 B: arquitetura XLIFF).

Quando o usuário clica no objeto, a caixa é marcada. Quando a caixa de seleção estiver marcada, seu seu valor é 1. Quando não estiver marcada, seu valor é 0.
Também pode associar uma variável tipo Booleana com a caixa de seleção. Nesse caso, a variável é True quando a caixa for marcada e False quando não marcada.
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.

Usar uma ação padrão

É possível atribuir uma ação padrão a uma check box ou uma check box 3D (usando o comando ou o tema "Action" da lista de Propriedades) para manejar atributos de áreas texto. Por exemplo, se selecionar a ação padrão "fontBold" durante execução, a check box vai gerenciar o atributo "negrito" do texto selecionado na área atual.

Nota: a opção três-estados é compatível apenas com check boxes, não com check boxes 3D]

Só ações que podem representar um estado verdadeiro/falso (ações "checkable") são compatíveis com esse objeto:

Ações compatíveis	Condições de uso (se houver)
avoidPageBreakInsideEnabled	só áreas 4D Write Pro
fontItalic
fontBold
fontLinethrough
fontSubscript	só áreas 4D Write Pro
fontSuperscript	só áreas 4D Write Pro
fontUnderline
font/showDialog	só Mac
htmlWYSIWIGEnabled	só áreas 4D Write Pro
section/differentFirstPage	só áreas 4D Write Pro
section/differentLeftRightPages	só áreas 4D Write Pro
spell/autoCorrectionEnabled
spell/autoDashSubstitutionsEnabled	só Mac
spell/autoLanguageEnabled	só Mac
spell/autoQuoteSubstitutionsEnabled	só Mac
spell/autoSubstitutionsEnabled
spell/enabled
spell/grammarEnabled	Mac only
spell/showDialog	Mac only
spell/visibleSubstitutions
visibleBackground	só áreas 4D Write Pro
visibleFooters	só áreas 4D Write Pro
visibleHeaders	só áreas 4D Write Pro
visibleHiddenChars	só áreas 4D Write Pro
visibleHorizontalRuler	só áreas 4D Write Pro
visiblePageFrames	só áreas 4D Write Pro
visibleReferences
widowAndOrphanControlEnabled	só áreas 4D Write Pro

Para informação detalhada sobre essas ações, veja a seção Ações padrões.