Saltar al contenido principal
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 soportadasCondiciones 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/showDialogMac únicamente
htmlWYSIWIGEnabledÁrea 4D Write Pro únicamente
section/differentFirstPageÁrea 4D Write Pro únicamente
section/differentLeftRightPagesÁrea 4D Write Pro únicamente
spell/autoCorrectionEnabled
spell/autoDashSubstitutionsEnabledMac únicamente
spell/autoLanguageEnabledMac únicamente
spell/autoQuoteSubstitutionsEnabledMac únicamente
spell/autoSubstitutionsEnabled
spell/enabled
spell/grammarEnabledMac únicamente
spell/showDialogMac ú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
}

Botón barra de herramientas

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

El estilo de casilla de selección Bevel combina la apariencia del estilo Clásico (es decir, un rectángulo con un título descriptivo) con el comportamiento del estilo Barra de herramientas.

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. Al igual que el estilo Bevel, el estilo Bevel redondeado combina la apariencia del estilo Clásico con el comportamiento del estilo Barra de herramientas.

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. Al igual que el estilo Bevel, el estilo OS X Gradient combina la apariencia del estilo Clásico con el comportamiento del estilo Barra de herramientas.

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. Al igual que el estilo Bevel, el estilo OS X Textured combina la apariencia del estilo Clásico con el comportamiento del estilo Barra de herramientas.

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

El estilo de casilla de selección Office XP combina la apariencia del estilo Clásico con el comportamiento del estilo Barra de herramientas.

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:

Suele asociarse a una imagen de 4 estados, que puede utilizarse junto con una imagen de fondo de 4 estados.

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

Existen propiedades específicas adicionales, dependiendo del estilo de botón: