Versão: 18

Caixa de selecção

Visão Geral

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

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

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 de caixa de verificação com o estilo Clássico e 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 verificação controlam o aspeto geral de uma caixa de verificação, bem como as 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 seguintes estilos predefinidos:

Clássico

O estilo de caixa de verificação Regular é uma caixa de verificação padrão do sistema (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 verificação Plano tem um aspeto 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   
   }

O estilo da caixa de verificação do botão da barra de ferramentas destina-se principalmente à integração numa barra de ferramentas.

O estilo da 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

The Bevel check box style combines the appearance of the Regular (i.e., a rectangle with a descriptive title) style with the Toolbar style's behavior.

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

The Rounded Bevel check box style is nearly identical to the Bevel style except, depending on the OS, the corners of the button may be rounded. As with the Bevel style, the Rounded Bevel style combines the appearance of the Regular style with the Toolbar style's behavior.

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:

on Windows, the Rounded Bevel style is identical to the Bevel style.

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

The OS X Gradient check box style is nearly identical to the Bevel style except, depending on the OS, it may have a two-toned appearance. As with the Bevel style, the OS X Gradient style combines the appearance of the Regular style with the Toolbar style's behavior.

The OS X Gradient style has a light gray background with a title and is displayed as a two-tone system button on macOS. Está geralmente associado com uma imagem de 4 estados.

On Windows, this style is identical to the Bevel style.

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

The OS X Textured checkbox style is similar to the Bevel style except, depending on the OS, it may have a different appearance. As with the Bevel style, the OS X Textured style combines the appearance of the Regular style with the Toolbar style's behavior.

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 sistema padrão que mostra uma mudança de cor cinza claro a cinza escuro. 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

The Office XP check box style combines the appearance of the Regular style with the Toolbar style's behavior.

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. Esses botões são usados nativamente em listas hierárquicas.

Windows - o botão se parece com um [+] ou um [-]
macOS - parece com um triângulo apontando para cima ou para baixo.

JSON Exemplo

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

Botão de divulgação

In macOS and Windows, a check box with the "Disclosure" style appears as a standard disclosure button, usually used to show/hide additional information. 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

JSON Exemplo

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

Personalizado

The Custom check box style accepts a personalized background picture and allows managing specific properties:

It is usually associated with a 4-state picture, that can be used in conjunction with a 4-state 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 - Focusable - Font - Font Color - Font Size - Height - Help Tip - Horizontal Sizing - Italic - Left - Object Name - Right - Shortcut - Standard action - Title - Top - Type - Underline - Variable or Expression - Vertical Sizing - Visibility - Width

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

Background pathname - Horizontal Margin - Icon Offset - Vertical Margin (Custom)
Três estados (plano, clássico)
Número de estados - Caminho da imagem - Título/posição da imagem (Botão da barra de ferramentas, Bevel, Rounded Bevel, Gradiente X, OS X Textured, Office XP, Personalizado)

Visão Geral​

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 de divulgação​

JSON Exemplo​

Personalizado​

JSON Exemplo​

Propriedades compatíveis​

Visão Geral

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 de divulgação

JSON Exemplo

Personalizado

JSON Exemplo

Propriedades compatíveis