Versão: 20

Caixa de selecção

Uma caixa de seleção é um tipo de botão usado para introduzir ou exibir dados binários (verdadeiro-falso). Basicamente, ou é verificada ou não, mas um terceiro estado pode ser definido.

As caixas de verificação são controladas por métodos ou acções normalizadas. O método associado com ela é executado quando selecionar a caixa de seleção. Como todos os botões, uma variável da caixa de seleção é estabelecida em 0 quando o formulário é aberto pela primeira vez.

Uma caixa de seleção mostra o teto do lado de um pequeno quadrado. Este texto é estabelecido na propriedade Title da caixa de seleção. Pode entrar um título no formulário de uma referência XLIFF nessa área (ver Anexo B: XLIFF arquitetura).

Utilizar caixas de seleção

Uma caixa de seleção pode ser associada a uma variável ou expressão de tipo inteiro ou booleano.

inteiro: se a caixa for selecionada, a variável tem o valor 1. Quando não for marcado, tem o valor 0. Se a caixa de seleção estiver no terceiro estado (ver abaixo), tem o valor 2.
booleano: se a caixa for marcada, a variável tem o valor True. Quando não for marcado, tem o valor False.

Uma parte ou todas as caixas de seleção de um formulário podem estar marcadas ou desmarcadas. As caixas de seleção múltiplas permitem ao usuário selecionar várias opções.

Caixas de seleção de três estados

Os objetos caixa de seleção de estilo Clássico y Plano aceitam um terceiro estado. Este terceiro estado é um estado intermediário, que geralmente se usa para fins de visualização. Por exemplo, permite indicar que uma propriedade é presentada em uma seleção de objetos,

Para ativar este terceiro estado, deve selecionar a propriedade Três estados.

Essa propriedade só está disponível para caixas de seleção regulares e planas associadas a variáveis ou expressões — as caixas de seleção de expressões booleanas não podem usar a propriedade Três Estados (uma expressão Booleana não pode estar em um estado intermediário).

A variável associada à caixa de seleção devolve o valor 2 quando a caixa estiver no terceiro estado.

In entry mode, the Three-States check boxes display each state sequentially, in the following order: unchecked / checked / intermediary / unchecked, etc. No modo de entrada, as caixas de seleção dos três estados mostram cada estado de forma sequencial na ordem abaixo: sem marcar/marcado/intermediário/sem marcar, etc. O estado intermediário não é geralmente muito útil no modo entrada; no código, simplesmente force o valor da variável para 0 quando tomar o valor de 2 para passar diretamente de um estado marcado para o estado desmarcado.

Usar uma ação padrão

Pode atribuir uma ação padrão a uma caixa de seleção para manejar os atributos das áreas de texto. Por exemplo, se atribuir a ação padrão fontBold, em execução a caixa de seleção gerenciará o atributo "negrito" do texxto selecionado na área atual.

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

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

Para informações detalhas dessas ações, veja a seção Ações padrão.

Estilos de botão caixas de seleção

Os estilos de caixa de seleção controlam a aparência geral de uma caixa de seleção assim como suas propriedades disponíveis. É possível aplicar diferentes estilos pré-definidos para caixas de seleção. Um grande número de variações podem ser obtidas combinando essas propriedades/comportamentos.

Com exceção das propriedades disponíveis, muitos objetos caixa de seleção são estruturalmente idênticos. A diferença é no processamento das variáveis associadas.

4D oferece caixas de seleção nos estilos predefinidos abaixo:

Clássico

O estilo Clássico de caixa de seleção corresponde a um sistema de caixa de seleção padrão (*ou seja, *, um retângulo com um título descritivo):

JSON Exemplo

    "myCheckBox": {
  "type": "checkbox", 
  "style":"regular",
  "text": "Cancel", 
  "action": "Cancel",  
  "left": 60,   
  "top": 160,  
  "width": 100,   
  "height": 20  
  "dataSourceTypeHint":"boolean"
  }

Plano

O estilo de caixa de seleção Plano tem uma aparência minimalista. A natureza gráfica do estilo Flat é especialmente útil para os formulários que vão ser impressos.

JSON Exemplo

    "myCheckBox": {
   "type": "checkbox", 
   "style":"flat",
   "text": "Cancel", 
   "action": "cancel", 
   "left": 60,  
    "top": 160, 
    "width": 100,   
   "height": 20   
   }

Botão barra de ferramentas

O estilo de botão barra de ferramentas está pensado principalmente para sua integração em uma barra de ferramentas.

O estilo Barra de ferramentas tem um fundo transparente com um título. Está geralmente associado com uma imagem de 4 estados.

Exemplo com estados selecionado/ não selecionado/ ressaltado:

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox",
                "style":"toolbar", 
                "text": "Checkbox",
    "icon": "/RESOURCES/File.png", 
    "iconFrames": 4 
                "left": 60, 
                "top": 160, 
                "width": 100,     
                "height": 20     
                }

Bevel

O estilo de caixa de seleção Bevel combina a aparência do estilo Clássico (ou seja, um retângulo com um título descritivo) com o comportamento do estilo Barra de ferramentas.

O estilo Bevel tem um fundo cinza claro com um título. Está geralmente associado com uma imagem de 4 estados.

Exemplo com estados selecionado/ não selecionado/ ressaltado:

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox", 
                "style":"bevel",
                "text": "Checkbox",  
     "icon": "/RESOURCES/File.png", 
    "iconFrames": 4 
               "left": 60, 
                "top": 160, 
                "width": 100,    
                "height": 20    
                }

Bevel arredondado

O estilo de caixa de seleção Bevel arredondado é quase idêntico ao estilo Bevel, exceto que, dependendo do sistema operativo, as esquinas do botão podem ser arredondadas. Da mesma forma que com o estilo Bevel, o estilo Bevel arredondado combina a aparência do estilo Clássico com o comportamento do estilo Barra de ferramentas.

O estilo Bevel arredondado tem um fundo cinza claro com um título. Está geralmente associado com uma imagem de 4 estados.

Exemplo em macOS:

em Windows, o estilo Bevel arredondado é idêntico ao estilo Bevel.

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox", 
                "style":"roundedBevel",  
                "text": "Checkbox", 
     "icon": "/RESOURCES/File.png", 
    "iconFrames": 4 
                "left": 60, 
                "top": 160, 
                "width": 100,   
                "height": 20   
                }

OS X Gradient

O estilo de caixa de seleção OS X Gradient é quase idêntico ao estilo Bevel, exceto que, dependendo do sistema operativo, pode ter uma aparência de dois tons. Da mesma forma que o estilo Bevel, o estilo OS X Gradient combina a aparência del estilo Clássico com o comportamento do estilo Barra de ferramentas.

O estilo Gradient OS X tem um fundo cinza claro com um título e se mostra como um botão de sistema de dois tons em macOS. Está geralmente associado com uma imagem de 4 estados.

Em Windows, este estilo é idêntico ao estilo Bevel.

JSON Exemplo

    "myCheckBox": {
   "type": "checkbox", 
   "style":"gradientBevel", 
   "text": "Checkbox", 
   "icon": "/RESOURCES/File.png",
   "iconFrames": 4
   "left": 60,  
   "top": 160,  
   "width": 100,    
   "height": 20    
           }

OS X Texturizado

O estilo de caixa de seleção OS X Textured é similar ao estilo Bevel, exceto que, dependendo do sistema operativo, pode ter uma aparência diferente. Da mesma forma que com o estilo Bevel, o estilo Bevel arredondado combina a aparência do estilo Clássico com o comportamento do estilo Barra de ferramentas.

Como padrão, o estilo OS X Textured aparece como:

Windows - um botão padrão com um fundo azul claro com um título no centro.

macOS - um botão de sistema ‘standard’. Sua altura está predefinida: não é possível ampliar ou reduzir.

JSON Exemplo

    "myCheckBox": {
   "type": "checkbox", 
   "style":"texturedBevel", 
   "text": "Checkbox", 
   "left": 60, 
   "top": 160, 
   "width": 100,     
   "height": 20     
   }

Office XP

O estilo de caixa de seleção Office XP combina a aparência do estilo Clássico com o comportamento do estilo Barra de ferramentas.

As cores (ressaltado e fundo) de um botão com o estilo Office XP são baseadas nos sistemas de cores. A aparência do botão pode ser diferente quando o cursor passar por cima dele, dependendo do SO:

Windows - seu fundo só aparece quando o mouse passa por cima. Exemplo com estados selecionado/ não selecionado/ ressaltado:

macOS - seu fundo é sempre mostrado. Exemplos com estados desmarcado/ marcado:

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox", 
                "style":"office",
                "text": "Checkbox",  
                "action": "fontBold",
     "icon": "/RESOURCES/File.png", 
    "iconFrames": 4  
               "left": 60, 
                "top": 160,  
                "width": 100,   
                "height": 20   
                }

Contrair/expandir

Este estilo de caixa de seleção pode ser usado para adicionar um ícone padrão de contrair/expandir. Estes ícones são utilizados nativamente em listas hierárquicas.

Windows - o ícone parece-se com um [+] ou um [-]

macOS - parece com um triângulo apontando para cima ou para baixo.

info

O estilo Contrair/Expandir tem o nome "disclosure" na gramática JSON do estilo de botão.

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox", 
                "style":"disclosure",
    "method": "m_collapse",
    "left": 60, 
                "top": 160, 
                "width": 100,   
                "height": 20   
                }

Botão disclosure

Em macOS e Windows, uma caixa de seleção com o estilo de botão "Divulgação" aparece como um botão de informação padrão, normalmente utilizado para mostrar/ocultar informação adicional. Quando usar um botão radio, o símbolo botão aponta para baixo com o valor 0 e para cima com o valor 1.

Windows
macOS

info

O estilo Disclosure tem o nome "roundedDisclosure" na gramática JSON do estilo de botão.

JSON Exemplo

    "myCheckBox": {
                "type": "checkbox",  
                "style":"roundedDisclosure", 
    "method": "m_disclose",
                "left": 60,  
                "top": 160, 
                "width": 100,   
                "height": 20   
                }

Personalizado

O estilo de botão Personalizado aceita uma imagem de fundo personalizada e permite gerir propriedades específicas:

Geralmente associado com uma imagem de 4 estados, que pode ser usada em conjunção com um quarto estado background picture.

JSON Exemplo

    "myCheckbox": {
  "type": "checkbox",
  "style":"custom",
  "text": "OK", 
  "icon": "/RESOURCES/smiley.jpg", 
  "iconFrame": 4, 
  "customBackgroundPicture": "/RESOURCES/paper.jpg", 
  "iconOffset": 5, //custom icon offset when clicked
  "left": 60, 
  "top": 160, 
  "width": 100,  
  "height": 20,
  "customBorderX": 20,
  "customBorderY": 5
  }

Propriedades compatíveis

Todas as caixas de seleção partilhar o mesmo conjunto de propriedades básicas:

Bold - Bottom - Button Style - Class - Enterable - Expression Type - Focusable - Font - Font Color - Font Size - Height - Help Tip - Horizontal Sizing - Italic - Left - Object Name - Right - Save value - Shortcut - Standard action - Title - Top - Type - Underline - Variable or Expression - Vertical Sizing - Visibility - Width

(1) Not supported by the Regular and Flat styles.
(2) Not supported by the Regular, Flat, Disclosure and Collapse/Expand styles.

Propriedades específicas adicionais estão disponíveis, dependendo do estilo botão:

Rota de acesso do fundo - Margem horizontal - Deslocamento ícone - Margem vertical (Personalizado)
Três Estados (Flat, Clássico)

Utilizar caixas de seleção​

Caixas de seleção de três estados​

Usar uma ação padrão​

Estilos de botão caixas de seleção​

Clássico​

JSON Exemplo​

Plano​

JSON Exemplo​

Botão barra de ferramentas​

JSON Exemplo​

Bevel​

JSON Exemplo​

Bevel arredondado​

JSON Exemplo​

OS X Gradient​

JSON Exemplo​

OS X Texturizado​

JSON Exemplo​

Office XP​

JSON Exemplo​

Contrair/expandir​

JSON Exemplo​

Botão disclosure​

JSON Exemplo​

Personalizado​

JSON Exemplo​

Propriedades compatíveis​

Utilizar caixas de seleção

Caixas de seleção de três estados

Usar uma ação padrão

Estilos de botão caixas de seleção

Clássico

JSON Exemplo

Plano

JSON Exemplo

Botão barra de ferramentas

JSON Exemplo

Bevel

JSON Exemplo

Bevel arredondado

JSON Exemplo

OS X Gradient

JSON Exemplo

OS X Texturizado

JSON Exemplo

Office XP

JSON Exemplo

Contrair/expandir

JSON Exemplo

Botão disclosure

JSON Exemplo

Personalizado

JSON Exemplo

Propriedades compatíveis