Saltar para o conteúdo principal
Versão: v19

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. The intermediary state is generally not very useful in entry mode; in the code, simply force the value of the variable to 0 when it takes the value of 2 in order to pass directly from the checked state to the unchecked state. 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 suportadasCondições de uso (se houver)
avoidPageBreakInsideEnabledApenas áreas 4D Write Pro
fontItalic
fontBold
fontLinethrough
fontSubscriptApenas áreas 4D Write Pro
fontSuperscriptApenas áreas 4D Write Pro
fontUnderline
font/showDialogSó em Mac
htmlWYSIWIGEnabledApenas áreas 4D Write Pro
section/differentFirstPageApenas áreas 4D Write Pro
section/differentLeftRightPagesApenas áreas 4D Write Pro
spell/autoCorrectionEnabled
spell/autoDashSubstitutionsEnabledSó em Mac
spell/autoLanguageEnabledSó em Mac
spell/autoQuoteSubstitutionsEnabledSó em Mac
spell/autoSubstitutionsEnabled
spell/enabled
spell/grammarEnabledSó em Mac
spell/showDialogSó em Mac
spell/visibleSubstitutions
visibleBackgroundApenas áreas 4D Write Pro
visibleFootersApenas áreas 4D Write Pro
visibleHeadersApenas áreas 4D Write Pro
visibleHiddenCharsApenas áreas 4D Write Pro
visibleHorizontalRulerApenas áreas 4D Write Pro
visiblePageFramesApenas áreas 4D Write Pro
visibleReferences
widowAndOrphanControlEnabledApenas á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.

JSON Exemplo

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

Botão de divulgação

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

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

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