Salva en 14:12 27 may 2015

2015-05-27T14:12:27Z

Página nueva

{{Menu|cat=Basic|Titulo=Control Botón de opción (OptionButton) para los diálogos en OOo Basic|vers=4.1.x}}
<seo title="Control Botón de opción (OptionButton) para los diálogos en OOo Basic - Apache OpenOffice Basic"
metakeywords="boton,opcion,optionbutton,radiobutton,control,controles,macro,basic,dialogos,starbasic,manual,curso,tutorial,open,office,openoffice,apache openoffice,libreoffice"
metadescription="Control Botón de opción (OptionButton) para los diálogos en lenguaje OOo Basic (StarBasic) en Apache OpenOffice y LibreOffice"/>
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:

{| class="mitb" align="center" width="90%"
!Propiedad
!Tipo
!Descripción
|-
|
==== State ====
|''Boolean''
|Estado del botón de opción. Las opciones posibles son:
::*'''TRUE''' si está activado (marcado)
::*'''FALSE''' si no está activado (desmarcado).
|-
|
==== 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''''':

{| class="mitb" align="center" width="90%"
!Propiedad
!Tipo
!Descripción
|-
|
==== Align ====
|''Short''
|Alineación horizontal del texto del control. Las opciones posibles son:
::*0: izquierda
::*1: centro
::*2: derecha
|-
|
==== VerticalAlign ====
|''Short''
|Alineación vertical del texto del control, según la enumeración '''''com.sun.star.awt.VerticalAlignment'''''. (Ver {{Enlace|https://www.openoffice.org/api/docs/common/ref/com/sun/star/style/VerticalAlignment.html|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 {{Enlace|https://www.openoffice.org/api/docs/common/ref/com/sun/star/awt/FontDescriptor.html|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 {{Enlace|https://www.openoffice.org/api/docs/common/ref/com/sun/star/awt/ImagePosition.html|Constants group ImagePosition}}). Las opciones posibles son:
::*0: Izquierda arriba
::*1 Izquierda centro
::*2 Izquierda abajo
::*3 Derecha arriba
::*4 Derecha centro
::*5 Derecha abajo
::*6: Encima izquierda
::*7: Encima centro
::*8: Encima derecha
::*9 Debajo izquierda
::*10: Debajo centro
::*11: Debajo derecha
::*12: Centrada
|-
|
==== 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.
|}

{{Aviso|ancho=80%|imagen=[[image:Señal_Nota.png|link=]]|color=RoyalBlue|imagenpos= | texto=Para conocer más propiedades, ver {{Enlace|https://www.openoffice.org/api/docs/common/ref/com/sun/star/awt/UnoControlRadioButtonModel.html|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.

{{Aviso|ancho=80%|imagen=[[image:Señal_Nota.png|link=]]|color=RoyalBlue|imagenpos= | texto=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}}

{{Aviso|ancho=80%|imagen=[[image:Señal_CopyRight.png|link=]]|color=NavajoWhite|imagenpos=top | texto=<small><small>Texto, imágenes y código bajo licencia [[Image:CC_BY-SA.png|64px|link=http://creativecommons.org/licenses/by-sa/3.0/es/]]</small></small> }}

{{Pie|Control Casilla de verificacion CheckBox en OpenOffice Basic|Control Casilla de verificación (CheckBox)|Larga=1}}
[[Category:Ver.4.0.x]][[Category:Ver.3.4.x]][[Category:Ver.3.3.x]][[Category:Ver.3.2.x]][[Category:Ver.3.1.x]]

Control Boton de opcion OptionButton en OpenOffice Basic - Historial de revisiones

Salva en 14:12 27 may 2015