Versión: 18

Casilla a seleccionar

Generalidades

Una casilla de selección es un tipo de botón utilizado para introducir o mostrar datos binarios (verdadero-falso). Básicamente, está seleccionado o no, pero se puede definir un tercer estado (ver más abajo).

Las casillas de selección se controlan por métodos. Como todos los botones, la variable de la casilla de selección se pone en 0 cuando se abre el formulario por primera vez. El método asociado a ella se ejecuta cuando se selecciona la casilla de selección.

Una casilla de selección muestra el texto junto a un pequeño cuadrado. Este texto se define en el área Título del tema "Objetos" de la Lista de propiedades. Para introducir en esta área un título en forma de referencia XLIFF (ver Anexo B: arquitectura XLIFF).

Utilizar casillas de selección

Una casilla de selección puede asociarse a una variable o expresión de tipo entero o booleano.

entero: si la casilla está marcada, la variable tiene el valor 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.
booleano: si la casilla está marcada, la variable tiene el valor True. Cuando no se marca, toma el valor 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

Los objetos casilla de selección de estilo Clásico y Plano aceptan un tercer estado. 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.

Para activar este tercer estado, debe seleccionar la propiedad Tres estados.

Esta propiedad sólo está disponible para casillas de selección regulares y planas asociadas a variables o expresiones - las casillas de selección de expresiones booleanas no pueden utilizar la propiedad Tres estados (una expresión booleana no puede estar en un estado intermedio).

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

Puede asignar una acción estándar a una casilla de selección para manejar los atributos de las áreas de texto. Por ejemplo, si asigna la acción estándar fontBold, en ejecución la casilla de selección gestionará el atributo "negrita" del texto seleccionado en el área actual.

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

Para información detallada sobre estas acciones, consulte la sección Acciones estándar.

Estilos de botones casillas de selección

Los estilos de casillas de selección controlan la apariencia general de una casilla de selección, así como sus propiedades disponibles. 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.

Con la excepción de las propiedades-disponibles, muchos objetos casilla de selección son estructuralmente idénticos. La diferencia está en el tratamiento de sus variables asociadas.

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

Clásico

El estilo Clásico de casilla de selección corresponde a un sistema de casilla de selección estándar (*es decir, *, un rectángulo con un título descriptivo):

Ejemplo JSON

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

Plano

El estilo de casilla de selección Plano 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   
   }

El estilo del botón barra de herramientas está pensado principalmente para su integración en una barra de herramientas.

El estilo Barra de herramientas tiene un fondo transparente con un título. Suele estar asociado a una imagen de 4 estados.

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

El estilo Bevel tiene un fondo gris claro con un título. Suele estar asociado a una imagen de 4 estados.

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

El estilo de casilla de selección Bevel redondeado es casi idéntico al estilo Bevel, excepto que, dependiendo del sistema operativo, las esquinas del botón pueden ser redondeadas. As with the Bevel style, the Rounded Bevel style combines the appearance of the Regular style with the Toolbar style's behavior.

El estilo Bevel redondeado tiene un fondo gris claro con un título. Suele estar asociado a una imagen de 4 estados.

Ejemplo en macOS:

en Windows, el estilo Bevel redondeado es idéntico al estilo Bevel.

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

El estilo de casilla de selección OS X Gradient es casi idéntico al estilo Bevel, excepto que, dependiendo del sistema operativo, puede tener una apariencia de dos tonos. As with the Bevel style, the OS X Gradient style combines the appearance of the Regular style with the Toolbar style's behavior.

El estilo Gradient OS X tiene un fondo gris claro con un título y se muestra como un botón de sistema de dos tonos en macOS. Suele estar asociado a una imagen de 4 estados.

En Windows, este estilo es idéntico al estilo Bevel.

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

El estilo de casilla de selección OS X Textured es similar al estilo Bevel, excepto que, dependiendo del sistema operativo, puede tener una apariencia diferente. As with the Bevel style, the OS X Textured style combines the appearance of the Regular style with the Toolbar style's behavior.

Por defecto, el estilo OS X Textured aparece como:

Windows - un botón sistema estándar con un fondo azul claro con un título en el centro.
macOS - - un botón sistema estándar que muestra un cambio de color de gris claro a gris oscuro. 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 check box style combines the appearance of the Regular style with the Toolbar style's behavior.

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

Windows - su fondo sólo aparece cuando el ratón pasa por encima. Ejemplo con estados seleccionado / no seleccionado / subrayado:
macOS - su fondo se muestra siempre. 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 casilla de selección se puede utilizar para añadir un icono estándar de contraer/expandir. Estos botones se utilizan de forma nativa en las listas jerárquicas.

Windows - el botón parece un [+] o un [-]
macOS - se ve como un triángulo que apunta hacia la derecha o hacia abajo.

Ejemplo JSON

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

Botón de divulgación

En macOS y Windows, una casilla de selección con el estilo "Disclosure" 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

Ejemplo JSON

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

Personalizado

El estilo de casilla de selecció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, //desplazamiento del icono personalizado al hacer clic
  "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:

Negrita - Inferior - Estilo de botón - Clase - Enfocable - Fuente - Color de fuente - Tamaño de fuente - Altura - Mensaje de ayuda - Tamaño horizontal - Cursiva - Izquierda - Nombre de objeto - Derecha - Acceso directo - Acción estándar - Título - Superior - Tipo - Subrayado - Variable o expresión - Tamaño vertical - Visibilidad - Ancho

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

Background pathname - Horizontal Margin - Icon Offset - Vertical Margin (Custom)
Tres estados (Plano, Clásico)
Número de estados - Nombre de ruta de la imagen - Título/Posición de la imagen (Botón de la barra de herramientas, Bisel, Bisel redondeado, OS X Degradado, OS X Texturizado, Office XP, Personalizado)

Generalidades​

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​

Botón de divulgación​

Ejemplo JSON​

Personalizado​

Ejemplo JSON​

Propiedades soportadas​

Generalidades

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

Botón de divulgación

Ejemplo JSON

Personalizado

Ejemplo JSON

Propiedades soportadas