Versión: 20 R5 BETA

Casilla a seleccionar

Una casilla de selección es un tipo de botón utilizado para introducir o mostrar datos binarios (verdadero-falso). Basically, it is either checked or unchecked, but a third state can be defined.

Check boxes are controlled by methods or standard actions. El método asociado a ella se ejecuta cuando se selecciona la casilla de selección. Como todos los botones, la variable de la casilla de selección se pone en 0 cuando se abre el formulario por primera vez.

Una casilla de selección muestra el texto junto a un pequeño cuadrado. This text is set in the Title property of the check box. You can enter a title in the form of an XLIFF reference in this area (see Appendix B: XLIFF architecture).

Utilizar casillas de selección

A check box can be associated to a variable or expression of type integer or boolean.

integer: if the box is checked, the variable has the value 1. Cuando no se marca, tiene el valor 0. Si la casilla de selección está en tercer estado (ver más abajo), tiene el valor 2.
boolean: if the box is checked, the variable has the value True. When not checked, it has the value False.

Una parte o todas las casillas de selección de un formulario pueden estar marcadas o desmarcadas. Las casillas de selección múltiples permiten al usuario seleccionar varias opciones.

Casilla de selección de tres estados

Check box objects with Regular and Flat button style accept a third state. Este tercer estado es un estado intermedio, que generalmente se utiliza para fines de visualización. Por ejemplo, permite indicar que una propiedad está presente en una selección de objetos, pero no en cada objeto de la selección.

To enable this third state, you must select the Three-States property.

This property is only available for regular and flat check boxes associated with numeric variables or expressions — check boxes for Boolean expressions cannot use the Three-States property (a Boolean expression cannot be in an intermediary state).

La variable asociada a la casilla de selección devuelve el valor 2 cuando la casilla está en el tercer estado.

En el modo de entrada, las casillas de selección de los tres estados muestran cada estado de forma secuencial, en el siguiente orden: sin marcar / marcado / intermedio / sin marcar, etc. El estado intermedio no suele ser muy útil en el modo de entrada; en el código, basta con forzar el valor de la variable a 0 cuando toma el valor de 2 para pasar directamente del estado comprobado al estado no comprobado.

Utilizar una acción estándar

You can assign a standard action to a check box to handle attributes of text areas. For example, if you assign the fontBold standard action, at runtime the check box will manage the "bold" attribute of the selected text in the current area.

Sólo las acciones que pueden representar un estado verdadero/falso (acciones "marcables") son soportadas por este objeto:

Acciones soportadas	Condiciones de uso (si las hay)
avoidPageBreakInsideEnabled	Área 4D Write Pro únicamente
fontItalic
fontBold
fontLinethrough
fontSubscript	Área 4D Write Pro únicamente
fontSuperscript	Área 4D Write Pro únicamente
fontUnderline
font/showDialog	Mac únicamente
htmlWYSIWIGEnabled	Área 4D Write Pro únicamente
section/differentFirstPage	Área 4D Write Pro únicamente
section/differentLeftRightPages	Área 4D Write Pro únicamente
spell/autoCorrectionEnabled
spell/autoDashSubstitutionsEnabled	Mac únicamente
spell/autoLanguageEnabled	Mac únicamente
spell/autoQuoteSubstitutionsEnabled	Mac únicamente
spell/autoSubstitutionsEnabled
spell/enabled
spell/grammarEnabled	Mac únicamente
spell/showDialog	Mac únicamente
spell/visibleSubstitutions
visibleBackground	Área 4D Write Pro únicamente
visibleFooters	Área 4D Write Pro únicamente
visibleHeaders	Área 4D Write Pro únicamente
visibleHiddenChars	Área 4D Write Pro únicamente
visibleHorizontalRuler	Área 4D Write Pro únicamente
visiblePageFrames	Área 4D Write Pro únicamente
visibleReferences
widowAndOrphanControlEnabled	Área 4D Write Pro únicamente

For detailed information on these actions, please refer to the Standard actions section.

Estilos de botones casillas de selección

Check boxes use button styles to control a check box's general appearance as well as its available properties. Es posible aplicar diferentes estilos predefinidos a las casillas de selección. Se puede obtener un gran número de variaciones combinando estas propiedades/comportamientos.

With the exception of the available properties, many check box objects are structurally identical. La diferencia está en el tratamiento de sus variables asociadas.

4D ofrece casillas de selección en los siguientes estilos de botón predefinidos:

Clásico

The Regular check box button style is a standard system check box (i.e., a rectangle with a descriptive title):

Ejemplo JSON:

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

Plano

El estilo plano del botón casilla de selección tiene una apariencia minimalista. La naturaleza gráfica del estilo Flat es especialmente útil para los formularios que se van a imprimir.

Ejemplo JSON:

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

Botón barra de herramientas

El estilo del botón barra de herramientas está destinado principalmente a la integración en una barra de herramientas.

El estilo del botón Barra de herramientas tiene un fondo transparente con un título. It is usually associated with a 4-state picture.

Ejemplo con estados seleccionado / no seleccionado / subrayado:

Ejemplo JSON:

    "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 button style combines the appearance of the Regular button style (i.e., a rectangle with a descriptive title) with the Toolbar Button button style's behavior.

El estilo de botón Bevel redondeado tiene un fondo gris claro con un título. It is usually associated with a 4-state picture.

Ejemplo con estados seleccionado / no seleccionado / subrayado:

Ejemplo JSON:

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

Bevel redondeado

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

El botón Bevel tiene un fondo gris claro con un título. It is usually associated with a 4-state picture.

Ejemplo en macOS:

On Windows, the Rounded Bevel button style is identical to the Bevel button style.

Ejemplo JSON:

    "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 button style is nearly identical to the Bevel button style. As with the Bevel button style, the OS X Gradient button style combines the appearance of the Regular button style with the Toolbar Button button style's behavior.

El estilo del botón Gradient OS X tiene un fondo gris claro con un título y se puede mostrar como un botón de sistema de dos tonos en macOS. It is usually associated with a 4-state picture.

On Windows, this check box button style is identical to the Bevel button style.

Ejemplo JSON:

    "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 button style is similar to the Bevel button style but with a smaller size (maximum size is the size of a standard macOS system button). As with the Bevel button style, the OS X Textured button style combines the appearance of the Regular button style with the Toolbar Button button style's behavior.

Por defecto, el estilo del botón OS X Textured aparece como:

Windows - a standard system button with a light blue background with a title in the center.

macOS - a standard system button. Su altura está predefinida: no es posible ampliarla o reducirla.

Ejemplo JSON:

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

Office XP

The Office XP button style combines the appearance of the Regular button style with the Toolbar Button button style's behavior.

Los colores (resaltado y fondo) de una casilla de selección con el estilo de botón Office XP se basan en los colores del sistema. La apariencia de la casilla de selección puede ser diferente cuando el cursor pasa por encima, dependiendo del sistema operativo:

Windows - its background only appears when the mouse rolls over it. Ejemplo con estados seleccionado / no seleccionado / subrayado:

macOS - its background is always displayed. Ejemplo con estados seleccionado / no seleccionado:

Ejemplo JSON:

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

Contraer/Desplegar

Este estilo de botón de casilla de selección se puede utilizar para añadir un icono estándar de contraer/expandir. Estos iconos se utilizan de forma nativa en las listas jerárquicas.

Windows - the icon looks like a [+] or a [-]

macOS - it looks like a triangle pointing right or down.

info

The Collapse/Expand style is named "disclosure" in the button style JSON Grammar.

Ejemplo JSON:

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

Divulgación

En macOS y Windows, una casilla de selección con el estilo de botón "Divulgación" aparece como un botón de información estándar, normalmente utilizado para mostrar/ocultar información adicional. Cuando se utiliza como botón radio, el símbolo del botón apunta hacia abajo con el valor 0 y hacia arriba con el valor 1.

Windows
macOS

info

The Disclosure style is named "roundedDisclosure" in the button style JSON Grammar.

Ejemplo JSON:

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

Personalizado

El estilo del botón Personalizado acepta una imagen de fondo personalizada y permite gestionar propiedades específicas:

It is usually associated with a 4-state picture, that can be used in conjunction with a 4-state background picture.

Ejemplo JSON:

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

Propiedades soportadas

Todas las casillas de selección comparten un mismo conjunto de propiedades básicas:

Bold - Bottom - Button Style - Class - Enterable - Expression Type - Focusable - Font - Font Color - Font Size - Height - Help Tip - Horizontal Alignment(1) - Horizontal Sizing - Image hugs title(2) - Italic - Left - Number of States(2) - Object Name - Picture pathname(2) - Right - Save value - Shortcut - Standard action - Title - Title/Picture Position(2) - 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.

Additional specific properties are available, depending on the button style:

Custom: Background pathname - Horizontal Margin - Icon Offset - Vertical Margin
Flat, Regular: Three-States

Utilizar casillas de selección​

Casilla de selección de tres estados​

Utilizar una acción estándar​

Estilos de botones casillas de selección​

Clásico​

Ejemplo JSON:​

Plano​

Ejemplo JSON:​

Botón barra de herramientas​

Ejemplo JSON:​

Bevel​

Ejemplo JSON:​

Bevel redondeado​

Ejemplo JSON:​

OS X Gradient​

Ejemplo JSON:​

OS X Texturizado​

Ejemplo JSON:​

Office XP​

Ejemplo JSON:​

Contraer/Desplegar​

Ejemplo JSON:​

Divulgación​

Ejemplo JSON:​

Personalizado​

Ejemplo JSON:​

Propiedades soportadas​

Utilizar casillas de selección

Casilla de selección de tres estados

Utilizar una acción estándar

Estilos de botones casillas de selección

Clásico

Ejemplo JSON:

Plano

Ejemplo JSON:

Botón barra de herramientas

Ejemplo JSON:

Bevel

Ejemplo JSON:

Bevel redondeado

Ejemplo JSON:

OS X Gradient

Ejemplo JSON:

OS X Texturizado

Ejemplo JSON:

Office XP

Ejemplo JSON:

Contraer/Desplegar

Ejemplo JSON:

Divulgación

Ejemplo JSON:

Personalizado

Ejemplo JSON:

Propiedades soportadas