Referencia rápida y utilización del jCheckBox en NetBeans

Referencia rápida y utilización del jCheckBox en NetBeans

Descripción del jCheckBox

Objeto booleano cuya función es seleccionar y deseleccionar opciones dentro de una aplicación. En otros lenguajes, puede ser conocido simplemente como Checkbox. De manera coloquial, también puede llegar a ser conocido como casilla de verificación.

Propiedades más importantes

Action

Es la acción que se va a disparar al utilizar este objeto, su valor por defecto es null, es decir, no tiene ninguna función relacionada inicialmente. Cada vez que creamos una función, esta se agrega aquí por si deseamos utilizarla.

Background

Cambia el color de fondo del objeto, presione el botón (…) para tener acceso a una paleta de color.

Font

Abre una ventana de dialogo con la que podemos cambiar el tipo, tamaño y estilo de fuente.

Foreground

Color de fuente, presione el botón (…) para tener acceso a una paleta de color.

Selected

Define si el checkbox aparecerá seleccionado o deseleccionado desde el inicio. Solo de click en la casilla una vez para activar y otra vez para desactivar.

Text

La etiqueta o texto que acompaña al checkbox

ToolTiptext

Breve texto de ayuda que aparece al posar el ratón encima de un componente, escriba lo que necesite que aparezca.

Border

Tipo de borde. De click en el botón (…) para seleccionar el tipo de borde deseado.

BorderPainted

Casilla que se activa si queremos que el borde se remarque o se desactiva si queremos que el borde no se marque.

ContentAreaFilled

Casilla que decide si el componente tiene color de relleno o no

Cursor

Abra esta lista para seleccionar el puntero de ratón que aparecerá al posar su mouse sobre el componente

Focusable

Active esta casilla si desea que este componente reciba el “foco” del ratón

Name

Nombre del objeto.

Variable Name

Nombre que tendrá la variable que controlará este objeto

Nomenclatura

Si no se utiliza la propiedad Variable Name, entonces el checkbox recibe el nombre de jCheckBox seguido de un número consecutivo según se vayan agregando al formulario. Luego entonces, el primer checkbox recibiría el nombre de jCheckBox1.

Métodos más importantes

add

Agrega un objeto en caso de que el componente lo soporte

addActionListener

Agrega un ActionListener al componente

addKeyListener

Agrega una función “escucha” de teclado

addMouseListener

Agrega una función “escuche” de ratón

doClick

Selecciona el componente, se le puede agregar un retardo en milisegundos

equals

Compara este componente con otro, muy utilizado en los eventos de tipo “escucha”

getActionCommand

Regresa el texto que contenga el componente

getFont

Regresa la fuente que tenga el componente

getHeight

Regresa la altura del componente en píxeles

getWidth

Regresa la anchura del componente en píxeles

getName

Regresa el nombre del objeto

getText

Igual que getActionCommand

getX

Devuelve la posición en el eje X del componente

getY

Devuelve la posición en el eje Y del componente

isEnabled

Devuelve true si el componente esta activo, en caso contrario, devuelve false

isFocusable

Devuelve true si el componente puede recibir el “foco”, en caso contrario devuelve false

isSeleted

Devuelve true si el componente esta seleccionado, en caso contrario devuelve false

isShowing

Devuelve true si el componente se puede ver en pantalla , en caso contrario devuelve false

isValidate

Devuelve true si el componente es válido , en caso contrario devuelve false

isVisible

Devuelve true si el componente esta visible, en caso contrario devuelve false

remove

Remueve el componente del contenedor que se le especifique

removeActionListener

Remueve el ActionListener que se le indique del componente

repaint

Vuelve a dibujar el componente, ideal cuando el objeto ha cambiado y se desea actualizar

setAction

Cambia o establece una acción para el componente

setBackground

Cambia o establece el color de fondo

setEnabled

Habilita (true) o deshabilita (false) el objeto

setFont

Cambia o establece la fuente del componente

setForeground

Cambia o establece el color de texto del componente

setName

Cambia el nombre del componente

setSize

Cambia el ancho y el alto del componente

setText

Cambia o establece el texto que acompaña al componente

toString

Convierte a cadena de texto el contenido del componente

Utilización del jCheckBox

Para probar su utilización, vamos a realizar una aplicación sencilla. Arranquemos un nuevo proyecto en el menú Archivo, Nuevo (File, New), seleccionemos Java en la categoría, y Java Desktop Application en la sección de proyectos. Debería quedar como sigue.

Utilización del componente jCheckBox en NetBeans

Presionemos Next y pongámosle de nombre CheckBoxPrueba, la ruta de la aplicación puede ser al gusto. Nos fijamos que quede seleccionado Basic Application, así debe lucir nuestra ventana.

Utilización del componente jCheckBox en NetBeans

Presionemos Finish, y ya estamos listos para trabajar. Como siempre, vamos a trabajar con los Swing Components ubicados en la Palete en la parte superior derecha por lo general. En este caso, trabajaremos con un botón, un checkbox y una etiqueta.

Utilización del componente jCheckBox en NetBeans

El resultado sería el siguiente

Utilización del componente jCheckBox en NetBeans

Vamos a aplicar una acción al botón de aceptar, para ello, presionamos el botón derecho del ratón encima de él y seleccionar Set Action.

Utilización del componente jCheckBox en NetBeans

En la ventana de dialogo, abrimos la lista llamada Action y seleccionamos Create New Action, enseguida procedemos a nombre la acción como alPresionar, debería quedar como ilustra la siguiente ventana.

Utilización del componente jCheckBox en NetBeans

Hemos de aparecer en la ventana de código y tendremos una nueva función frente a nuestros ojos.

Utilización del componente jCheckBox en NetBeans

Vamos a colocar un poco de código para probar los métodos y las propiedades del CheckBox. Escriba lo siguiente entre las llaves de inicio y fin de la función alPresionar.

jCheckBox1.setBackground(Color.red); // Pintamos el fondo de color rojo
jCheckBox1.setForeground(Color.green); // Pintamos las letras de color verde
if(jCheckBox1.isSelected()) // Si hemos dado clic en el jCheckBox
    jLabel1.setText("El CheckBox ha sido seleccionado"); // Cambiamos la etiqueta
else //Pero si no le dimos clic al jCheckBox
{
      jLabel1.setText("El CheckBox no esta seleccionado");  //Ponemos otro texto diferente
      jCheckBox1.setBackground(Color.gray); // Pintamos el fondo de color gris
      jCheckBox1.setForeground(Color.black); // Y las letras de negro
}

Pruebe el proyecto con F6, y juegue con poco con la aplicación, algo como esto debería tener en su pantalla

Utilización del componente jCheckBox en NetBeans

Recursos adicionales

  1. Descargar Código completo