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

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. 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 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
}

Botão barra de ferramentas

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

This check box style can be used to add a standard collapse/expand icon. 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:

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 - 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: