VGroupBox

Hereda de: Widget.

Esta clase representa al control caja de grupo de controles.

Indice de propiedades

Number alignment

Boolean checkable

Boolean checked

Boolean flat

String title

Indice de funciones

Generales

void setChecked( Boolean checked )

De widgets hijos

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

//Obtenemos el formulario
var formulario = theRoot.dataView();

//Obtenemos el control caja de grupo
var control = formulario.control("CAJ_GRP");

//Cambiamos el título del conrol
control.title="Nuevo título";

2. Activar el check box en una caja de grupo

//Obtenemos el formulario
var formulario = theRoot.dataView();

//Obtenemos la caja de grupo
var control = formulario.control("CAJ_GRP");

//Activamos el check box y lo inicializamos a false
control.checkable = true;
control.setChecked( 0 )

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.

//Obenemos el formulario
var formulario = theRoot.dataView();

//Obtenemos la caja de grupo y los controles de chekbox que contiene
var caja = formulario.control("CAJ_GRP");
var check1 = formulario.control("BTN_CHK");
var check2 = formulario.control("BTN_CHK2");

//Capturamos el estado del check
//(Devuelve el valor del check antes de cambiar)
var estado = caja.checked;

//Si cambia de false a true se activan los check boxes
//Si no, se inactivan
if (estado == 0) {

	check1.setChecked(true);
	check2.setChecked(true);
}
else {
	check1.setChecked(false);
	check2.setChecked(false);
}