• ¿Cómo Usar CheckBox?
• El API CheckBox
• Constructores de CheckBox

¿Cómo Usar CheckBox?

La versión Swing soporta botones checkbox con la clase JCheckBox. Swing también soporta checkboxes en menus, utilizando la clase JCheckBoxMenuItem. Como JCheckBox y JCheckBoxMenuItem descienden de AbstractButton, los checkboxes de Swing tienen todas las características de un botón normal como se explicó en Cómo usar Buttons. Por ejemplo, podemos especificar imágenes para ser utilizadas en los checkboxes.

Los Checkboxes son similares a los botones de rádio, pero su modelo de selección es diferente, por convención. Cualquier número de checkboxes en un grupo -- ninguno, alguno o todos -- pueden ser seleccionados. Por otro lado, en un grupo de botones de rádio, sólo puede haber uno seleccionado.

Aquí podemos ver una imagen de una aplicación que utiliza cuatro checkboxes para personalizar una caricatura.

Un Checkbox genera un evento ítem y un evento action por cada pulsación. Normalmente, solo escucharemos los eventos de ítem, ya que nos permiten determinar si el click selecciona o desactiva el checkbox. Abajo puedes ver el código de CheckBoxDemo.java que crea los checkboxes del ejemplo anterior y reacciona ante las pulsaciones.

//In initialization code:
    chinButton = new JCheckBox("Chin");
    chinButton.setMnemonic('c'); 
    chinButton.setSelected(true);

    glassesButton = new JCheckBox("Glasses");
    glassesButton.setMnemonic('g'); 
    glassesButton.setSelected(true);

    hairButton = new JCheckBox("Hair");
    hairButton.setMnemonic('h'); 
    hairButton.setSelected(true);

    teethButton = new JCheckBox("Teeth");
    teethButton.setMnemonic('t'); 
    teethButton.setSelected(true);

    // Register a listener for the check boxes.
    CheckBoxListener myListener = new CheckBoxListener();
    chinButton.addItemListener(myListener);
    glassesButton.addItemListener(myListener);
    hairButton.addItemListener(myListener);
    teethButton.addItemListener(myListener);
...
class CheckBoxListener implements ItemListener {
    public void itemStateChanged(ItemEvent e) {
        ...
	Object source = e.getItemSelectable();

        if (source == chinButton) {
            //...make a note of it...
        } else if (source == glassesButton) {
            //...make a note of it...
        } else if (source == hairButton) {
            //...make a note of it...
        } else if (source == teethButton) {
            //...make a note of it...
        }

        if (e.getStateChange() == ItemEvent.DESELECTED)
            //...make a note of it...
        picture.setIcon(/* new icon */);
        ...
    }
}

 El API CheckBox

Puedes ver El API Button para información sobre el API de AbstractButton del que descienden JCheckBox y JCheckBoxMenuItem. Los métodos de AbstractButton que son más usados son setMnemonic, addItemListener, setSelected, y isSelected. El único API definido por JCheckBox y JCheckBoxMenuItem que utilizaremos son los constructores.

 Constructores de CheckBox