VGroupBox

Hereda de: Widget.
Esta clase representa al control caja de grupo de controles.
​Propiedades​
Tipo
Propiedad
Number
​alignment​
Boolean
​checkable​
Boolean
​checked​
Boolean
​flat​
String
​title​
Funciones
Generales
Retorno
Función
void
​setChecked( Boolean checked )
De widgets hijos
Retorno
Función
​Widget​
​childWidgetAt( Number index )
Number
​childWidgetCount()
Enumeraciones
Flags de alineamiento
AlignLeft = 0×0001
AlignRight = 0×0002
AlignHCenter = 0×0004
AlignJustify = 0×0008
AlignAbsolute = 0×0010
AlignTop = 0×0020
AlignBottom = 0×0040
AlignVCenter = 0×0080
AlignCenter = AlignVCenter | AlignHCenter
Documentación de propiedades
alignment
Permite leer o configurar la alineación del contenido. Ver enum de flags de alineamiento. Los valores con combinables mediante el uso del operador bitwise or booleano "|".
checkable
Permite leer o configurar si el botón se puede pulsar. De forma predeterminada, el botón no es pulsable.
checked
Permite leer o configurar si el botón está pulsado/activado. Sólo los botones con la propiedad checkable activa se pueden pulsar/activar. De forma predeterminada, el botón no está pulsado/activado.
flat
Permite leer o configurar si el control se pinta como una línea o como un marco. Un groupbox por lo general consta de un marco que la rodea con un título en la parte superior. Si esta característica está habilitada, sólo la parte superior del marco se dibuja en la mayoría de los estilos, de lo contrario todo el marco se dibuja. De forma predeterminada, esta propiedad está desactivada, es decir, los groupbox son planos a menos que explícitamente se especifica.
Nota: en algunos estilos, los groupbox planos y no planos tienen representaciones similares y puede no ser tan distinguibles como lo son en otros estilos.
title
Permite leer o configurar el texto del título mostrado en el control. El groupbox tendrá un atajo de teclado si el título contiene un ampersand (&), seguido de una letra.
Documentación de funciones
Funciones generales
void setChecked( Boolean checked )
El control caja de grupo permite visualizar un checkbox utilizando la propiedad checkable. Esta función permite asignar el valor del checkbox.
Parámetros:
cheked: valor booleano para fijar el estado true=marcado, false=desmarcado.
Funciones de widgets hijos
Widget childWidgetAt( Number index )
Devuelve un objeto de la clase Widget correspondiente al número de índice especificado.
Parámetros:
index: número correspondiente al índice de la posición que ocupa el control dentro del grupo.
Number childWidgetCount()
Devuelve el número de controles (widgets) que contiene el control.
Ejemplos
1. Cambiar el título a una caja de grupo de un formulario desde un manejador de evento del mismo
1
//Obtenemos el formulario
2
var formulario = theRoot.dataView();
3
​
4
//Obtenemos el control caja de grupo
5
var control = formulario.control("CAJ_GRP");
6
​
7
//Cambiamos el título del conrol
8
control.title="Nuevo título";
Copied!
2. Activar el check box en una caja de grupo
1
//Obtenemos el formulario
2
var formulario = theRoot.dataView();
3
​
4
//Obtenemos la caja de grupo
5
var control = formulario.control("CAJ_GRP");
6
​
7
//Activamos el check box y lo inicializamos a false
8
control.checkable = true;
9
control.setChecked( 0 )
Copied!
3. Una caja de grupo que tiene activado el check box y que contiene varios check boxes: evento que cambia el estado de todos los check boxes que contiene al activar/inactivar el check box de la caja
El manejador de evento se dispararía con al señal de ratón: botón soltado de la caja de grupo.
1
//Obenemos el formulario
2
var formulario = theRoot.dataView();
3
​
4
//Obtenemos la caja de grupo y los controles de chekbox que contiene
5
var caja = formulario.control("CAJ_GRP");
6
var check1 = formulario.control("BTN_CHK");
7
var check2 = formulario.control("BTN_CHK2");
8
​
9
//Capturamos el estado del check
10
//(Devuelve el valor del check antes de cambiar)
11
var estado = caja.checked;
12
​
13
//Si cambia de false a true se activan los check boxes
14
//Si no, se inactivan
15
if (estado == 0) {
16
​
17
	check1.setChecked(true);
18
	check2.setChecked(true);
19
}
20
else {
21
	check1.setChecked(false);
22
	check2.setChecked(false);
23
}
Copied!