Cómo Utilizar la Clase Checkbox

La clase Checkbox proporciona cajas de chequeo -- botones con dos estados que pueden estar "on" o "off". (Quizás podría conocer este elemento UI como botón de radio.) Cuando el usuario pulsa un botón de radio, cambia su estado y genera un evento Action. Otras formas de proporcionar grupos de botones de radio que pueden ser seleccionados son choices, lists, y menus.

Si se quiere un grupo de botones de radio en el que sólo uno pueda estar activado, puede añadir un objeto CheckboxGroup para vigilar el estado de los botones de radio.

Abajo hay un applet que tiene dos columnas de botones de radio. En la izquierda hay tres botones independientes. Se pueden seleccionar los tres botones de radio, si se quiere. En la derecha hay tres botones de radio que están corrdinados por un objeto CheckboxGroup. Este objeto se asegura de que no haya más de un botón de radio seleccionado al mismo tiempo. Para ser específicos, un grupo de botones de radio puede no tener ninguno seleccionado, pero una vez que el usuario selecciona un botón, sólo uno de ellos podrá ser seleccionado en adelante.

Aquí tienes el programa completo. Abajo tienes el código que crea los dos grupos de botones de radio. Observa que sólo elsegundo, el grupo mutuamente exclusivo de botones está controlado por un CheckboxGroup.

Panel p1, p2;
Checkbox cb1, cb2, cb3; //Estos son los botones de radio independientes.
Checkbox cb4, cb5, cb6; //Estos botones de radio son parte de un grupo.
CheckboxGroup cbg;

cb1 = new Checkbox();   //El estado por defecto es "off" (false).
cb1.setLabel("Checkbox 1");
cb2 = new Checkbox("Checkbox 2");
cb3 = new Checkbox("Checkbox 3");
cb3.setState(true);     //Cambia el estado a"on" (true).
. . .
cbg = new CheckboxGroup();
cb4 = new Checkbox("Checkbox 4", cbg, false); //estado inicial: off (false)
cb5 = new Checkbox("Checkbox 5", cbg, false); //estado inicial: off
cb6 = new Checkbox("Checkbox 6", cbg, false); //estado inicial: off

Junto con los métodos de la clase Checkbox mostrados arriba, esta clase tiene dos métodos adiconales que podrías querer utilizar: getCheckboxGroup() y setCheckboxGroup(). Junto con el sencillo constructor CeckboxGroup utilizado en el código de ejemplo, CheckboxGroup también define los siguientes métodos: getCurrent() y setCurrent(). Estos métodos obtienen y cambian (respectivamente) el botón de radio seleccionado actualmente.


Ozito