Control Botón de opción (OptionButton) para los diálogos en OOo Basic
Los botones de opción (también conocidos como botones de radio) se utilizan generalmente en grupos de dos o más, permitiendo seleccionar (marcar) una de un conjunto predefinido de opciones. Al seleccionar una opción (marcar) las demás se deseleccionan (desmarcan), lo que asegura que solo una de las opciones permanezca seleccionada (marcada).
Propiedades del control botón de opción
Los botones de opción tienen entre otras las siguientes propiedades:
Propiedad | Tipo | Descripción |
---|---|---|
State |
Boolean | Estado del botón de opción. Las opciones posibles son:
|
Label |
String | Texto (etiqueta) que muestra el control. |
Propiedades del objeto Model del botón de opció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 del botón de opción. 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. Todos los botones de opción del mismo grupo de opciones deben tener una numeración secuencial. |
TextColor |
Long | Color RGB del texto. |
TextLineColor |
Long | Color RGB de la línea del texto. |
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 UnoControlRadioButtonModel |
En referencia a los grupos de opciones:
- Para crear un grupo de opciones los controles deben estar colocados uno tras otro en la secuencia de activación Orden de tabuladores (o propiedad TabIndex). Por ejemplo, un grupo de cinco botones de opción tendrán el orden de tabulación del 3 al 7.
- Para definir otro grupo debe existir un salto de al menos un elemento en la secuencia de activación. Por ejemplo, un segundo grupo de tres botones en el mismo diálogo tendrán el orden de tabulación del 9 al 11.
En VBA para definir un grupo de opciones se disponen los botones de opción dentro de un cuadro de grupo (ControlFrame), mientras que en Apache OpenOffice, el grupo de opciones se define por su numeración secuencial en el orden de tabulación
Los cuadros de grupo en Apache OpenOffice tan sólo son divisores visuales y no definen grupos de opciones |
Texto, imágenes y código bajo licencia |