Control Casilla de verificación (CheckBox) para los diálogos en OOo Basic
Las casillas de verificación sirven para activar o no una opción individual e independiente. Según las configuremos, tienen capacidad para determinar:
- Dos estados: marcado o desmarcado, o...
- Tres estados: marcado, desmarcado o indeterminado.
El estado indeterminado se suele aplicar cuando no está claro el estado, o si el estado marcado o desmarcado correspondiente tienen más de un significado.
Por ejemplo, si el estado marcado indica que el texto seleccionado está en negrita, y el estado desmarcado que no lo está, podemos utilizar el estado indeterminado para indicar que se ha seleccionado texto en el que algunos caracteres están en negrita y otros no.
Propiedades del control casilla de verificación
Las casillas de verificación ofrecen las siguientes propiedades:
Propiedad | Tipo | Descripción |
---|---|---|
State |
Short | Estado de la casilla de verificación.
Pueden ser una de las siguientes opciones:
|
Label |
String | Texto (etiqueta) que muestra el control. |
EnableTriState |
Boolean | Define si es posible aplicar dos o tres estados:
|
Propiedades del objeto Model de la casilla de verificación
El objeto Evento que se pasa al controlador de eventos de este control permite alcanzar las siguientes propiedades a través del objeto Model:
Propiedad | Tipo | Descripción |
---|---|---|
Align |
Short | Alineación horizontal del texto del control.
Las opciones posibles son:
|
VerticalAlign |
Short | Alineación vertical del texto del control, según la enumeración com.sun.star.awt.VerticalAlignment. (Ver Enum VerticalAlignment). |
BackgroundColor |
Long | Color RGB de fondo |
Enabled |
Boolean | Define si el control está activado o desactivado. |
FontDescriptor |
struct | Propiedades de fuente utilizadas en el control, en concordancia con la estructura com.sun.star.awt.FontDescriptor. (Ver Struct FontDescriptor). |
ImagePosition |
Short | Posición de la imagen en el control, si existe, respecto del texto, si existe, según la enumeración com.sun.star.awt.ImagePosition. (Ver Constants group ImagePosition). Las opciones posibles son:
|
ImageURL |
String | URL de la imagen asignada al control. |
Label |
String | Texto (etiqueta) que muestra el control. |
MultiLine |
Boolean | El texto se muestra en varias líneas (si es necesario). |
Printable |
Boolean | Define si el control se imprime. Si es FALSE, el control no se muestra al ser impreso. |
State |
Short | Estado de la casilla de verificación. 2 si está en estado indeterminado, 1 si está activado (marcado), 0 si no lo está (desmarcado). |
TabStop |
Boolean | Define si el control es seleccionable mediante la tecla Tab. |
TabIndex |
Short | Define el orden de tabulación. |
TextColor |
Long | Color RGB del texto. |
TextLineColor |
Long | Color RGB de la línea del texto. |
TriState |
Boolean | Define si es posible elegir entre dos o tres estados. |
HelpText |
String | Texto de ayuda que se muestra cuando se sitúa el cursor del ratón sobre el control. |
HelpURL |
String | URL de la ayuda en línea asociada al control. |
Para conocer más propiedades, ver Service UnoControlCheckBoxModel |
Texto, imágenes y código bajo licencia |