jCheckBox

JCHECKBOX (NETBEANS)

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

Código en Java: 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 }

DESCRIPCIÓN CHECKBOX (VISUAL STUDIO).

El control CheckBox se utiliza generalmente para listar opciones y que el usuario pueda elegir entre ellas, y dependiendo del valor (si está chequeado o no), se realiza una u otra acción. Una vista previa de este control:

PROPIEDAD CAPTION La propiedad del CheckBox que visualiza el texto en el control se llama Caption. Para establecerla se realiza desde la ventana de Propiedades de Visual Basic , o en tiempo de ejecución de esta manera: Por ejemplo si quisiéremos hacerlo en el evento Load del Formulario, DobleClick sobre el form y en el procedimiento Form_Load: 1. Private Sub Form_Load() 2. 3. Check1.Caption = "Es usted mayor de edad" 4. Check2.Caption = "¿ Tiene hijos ?" 5. Check3.Caption = "¿ Estudió alguna carrera ?" 6. 7. End Sub

PROPIEDAD VALUÉ La principal propiedad de este control es la propiedad Value. Esta propiedad devuelve y establece el valor seleccionado. Esta tiene 3 posibles valores: 

0 - UnChecked



1 - Checked



2 - Grayed

Las más utilizadas son la 0 - UnChecked y 1 - Checked. Cuando está en 0, el checkbox no está tildado o checkeado, cuando está en 1 se muestra marcado. Siguiendo con el ejemplo anterior de la encuesta, un ejemplo que no tiene ningún sentido pero que te dé una idea más clara de cómo usar este control. Agrega en un formulario 3 controles CheckBox como muestra la imagen, un botón Command1 para mostrar el resultado y un control textBox llamado Text1 para ingresar un nombre.

Cuando lo presionemos, mostraremos un mensaje que muestre el resultado de la misma, evaluando mediante la propiedad Value de cada Checkbox. Antes de evaluar los CheckBox comprobamos que se haya ingresado un texto en el Text1, si no se ingresó nada, se muestra un mensaje de advertencia y se termina la rutina mediante la instrucción Exit Sub, en cambio si se ingresó un nombre, visual basic prosigue la ejecución del resto del código: OTRAS PROPIEDADES Las demás propiedades ya se han visto y son comunes a los demás controles de Visual Basic, como son las propiedades de aspecto gráfico y apariencia del control: Propiedad Font, Forecolor, BackColor etc...., y otras como Visible, Enabled , Top, Left, Width, Height etc... A continuación unos ejemplos simples que no tienen mucho sentido pero sirven para practicar

Cambiar la propiedad FontBold (Estilo negrita ) de todos los CheckBox que haya en el formulario Colocar varios controles Check y un botón

Texto plano Imprimir 1. Option Explicit 2. 3. 4. Private Sub Command1_Click() 5. 6. Static bValue As Boolean 7. 8. ' Variable de tipo control 9. 10. Dim xCheckBox As Control 11. 12. ' Recorrer en un bucle todos los controles del formulario actual 13. For Each xCheckBox In Me.Controls 14. ' Comprobar con el operador TypeOf si es un control CheckBox 15. If TypeOf xCheckBox Is CheckBox Then 16. ' Cambia la propiedad Bold 17. xCheckBox.FontBold = Not bValue 18. End If 19. Next 20. 21. If bValue = False Then 22. Command1.Caption = "Negrita" 23. Else 24. Command1.Caption = "Normal" 25. End If 26. 27. bValue = Not bValue 28. 29. End Sub 30. 31. Private Sub Form_Load() 32. Command1.Caption = "Normal" 33. End Sub

Cambiar la propiedad Value de todos los CheckBox que haya en el formulario Colocar varios controles CheckBox y un Command. Texto plano Imprimir 1. Option Explicit 2. 3. 4. Private Sub Command1_Click() 5. 6. Static bValue As Boolean 7. 8. bValue = Not bValue

9. 10. Dim xCheckBox As Control 11. ' Recorrer en un bucle todos los controles del form 12. For Each xCheckBox In Me.Controls 13. ' Comprobar con el operador TypeOf si es un control CheckBox 14. If TypeOf xCheckBox Is CheckBox Then 15. ' Cambiar la propiedad Value 16. xCheckBox.Value = Abs(bValue) 17. End If 18. Next 19. 20. Command1.Caption = "Value: " & CStr(bValue) 21. 22. End Sub 23. 24. Private Sub Form_Load() 25. Command1.Caption = "Value: Falso" 26. End Sub

PROPIEDAD STYLE Una propiedad de este control relacionado a su aspecto gráfico es la Propiedad Style: Esta es similar a la del control CommandButton, y permite tener un checkBox de estilo gráfico o estilo Estándar normal, como muestra esta imagen:

Si está en Graphical, es posible cambiarle el color de fondo y también si queremos podemos mostrar una imagen utilizando la propiedad Picture del Check

EVENTOS DEL CONTROL CHECKBOX El principal evento del control CheckBox es el evento Click. Si colocas un checkBox en un formulario y le das DobleClick, podés ver que VisualBasic abre la ventana de código y te crea un procedimiento de evento como este:

Texto plano Imprimir 1. Private Sub Check1_Click() 2. 3. End Sub Todas las instrucciones que estén en este bloque , se producirán cuando hagamos un click en dicho control: Un ejemplo: Agrega 1 CheckBox. Luego pega el siguiente código, que lo que hace es que cada ves que se presione, muestre el valor de su propiedad Value. Para poder convertir el valor de Value, que puede ser un 1 o un 0 y a "Verdadero" o "Falso" utilizamos la función CBool que lo que hace es Convertir una expresión a un valor de tipo Boolean. Texto plano Imprimir 1. Option Explicit 2. 3. Private Sub Check1_Click() 4. ' -- Mostramos el valor de la propiedad Value del Check1 5. MsgBox CBool(Check1.Value) 6. End Sub

DESCRIPCIÓN DE LOS DEMÁS EVENTOS 

DragDrop: Ocurre cuando finaliza una operación de arrastrar y colocar.



DragOver: Ocurre cuando la operación de arrastrar y colocar está en curso.



GotFocus: Ocurre cuando el checkBox recibe el enfoque



LostFocus : Ocurre cuando el checkBox pierde el enfoque.



KeyDown: Ocurre al presionar una tecla mientras el checkBox tiene el enfoque.



KeyPress : Ocurre al presionar y liberar una tecla ANSI.



KeyUp : Ocurre cuando se libera una tecla mientras el checkBox tiene el enfoque.



MouseDown : Cuando el usuario presiona el botón del mouse mientras el checkBox tiene el enfoque.



MouseUp: Cuando se libera el botón del mouse mientras tiene el enfoque.



Validate : Ocurre cuando el control checkBox pierde el enfoque en favor de un control que produce una validación.

DESCRIPCIÓN CHECKBOX (ASP).

propiedad descripción Name

Es el nombre que identifica a un checkbox a un grupo de radio buttons. Para que éstos últimos conserven la capacidad de selección única, deben tener todo el mismo nombre. Es un valor asociado a cada checkbox o radio.

Value

En el caso de los checkbox es útil asignar a un grupo de éstos con el mismo name distintos valores. Pero si se quieres acceder a las propiedades de cada checkbox separadamente mediante JavaScript, es mejor utilizar un name diferente para cada checkbox, ya que de lo contrario (si todos tienen el mismo name) la propiedad value resulta poco útil. En el caso de los radio buttons es una propiedad necesaria siempre al tener todos el mismoname, aunque para su acceso mediante JavaScript, esta propiedad no es muy útil.

Disabled

Bloquea el checkbox o radio. Por lo tanto "No es enviado en el formulario" y "actúa como si no existiese".

Checked

Marca o comprueba si está marcado un checkbox o un radio. Es una propiedad booleana (que solo admite verdadero o falso) en la cual su valor será "true" (verdadero) si el objeto está marcado y "false" (falso) en caso que no lo esté.

Length

Es la cantidad de radio buttons que existe en un grupo determinado con el mismo name.

Index

array que contiene todos los radio buttons que hay en un grupo con el mismo nombre. Para un grupo de 5 radio buttons con mismo nombre y diferente valor cada uno, para referirnos al cuarto de ellos se debe usar la sintaxis: formulario.nombre_radio[3]

PRINCIPALES EVENTOS evento

descripción

onFocus

Permite realizar una acción al poner el foco en el objeto.

onBlur

Permite realizar una acción cuando el foco ya no se encuentra en el objeto.

onClick

Permite realizar una acción cuando se hace click sobre el objeto.

onChange

Evento que se produce al marcar/desmarcar un checkbox o un radio button.

Sintaxis básica Para un grupo de radio buttons (mismo nombre distinto valor) Para un grupo de checkbox (mismo nombre distinto valor) Ejemplos de aplicación I: Trabajando con la propiedad disabled Ejemplo #1 En este caso se habilitarán o deshabilitarán los checkbox dependiendo de la opción que seleccione el usuario de un grupo de dos radio buttons.

El Script... function habilita(form) { form.intereses[0].disabled = false; form.intereses[1].disabled = false; form.intereses[2].disabled = false; } function deshabilita(form) { form.intereses[0].disabled = true; form.intereses[1].disabled = true; form.intereses[2].disabled = true; } EL FORMULARIO... ¿Desea suscribirse a nuestro boletín de novedades? SI, quiero suscribirme. No, gracias. Seleccione los temas de su interés: Arte y Cultura

Ciencia Música Los resultados... ¿Desea suscribirse a nuestro boletín de novedades? SI, quiero suscribirme.

No, gracias.

Seleccione los temas de su interés: Arte y Cultura Ciencia Música

EJEMPLO #2 En este caso se habilitarán o deshabilitarán los checkbox dependiendo del valor de la propiedad checked de otro checkbox.

El Script... function habilitaDeshabilita(form) { if (form.boletin.checked == true) { form.intereses[0].disabled = false; form.intereses[1].disabled = false; form.intereses[2].disabled = false; } if (form.boletin.checked == false) { form.intereses[0].disabled = true; form.intereses[1].disabled = true; form.intereses[2].disabled = true; } } El Formulario... ¿Desea suscribirse a nuestro boletín de novedades? SI, quiero suscribirme.

Seleccione los temas de su interés: Arte y Cultura Ciencia Música Los resultados... ¿Desea suscribirse a nuestro boletín de novedades? Seleccione los temas de su interés: Arte y Cultura Ciencia Música

SI, quiero suscribirme.