C# - [DataGridView] – Uso del CheckBox - DataGridViewCheckBoxColumn

 

Introducción

El articulo intentara mostrar las algunas forma en que se puede utilizar el checkbox en un control DataGridView.

Detectar el cambio en la selección

Para realizar la tarea se hará uso de dos eventos que pueden ser igual de útiles, el CellValueChange y el CellContentClick

De forma estándar el CellValueChange, se deparará a seleccionar el check de la celda y quitar el foco de la misma, saliendo del modo de edición.

Pero este no ejecuta la acción en el mismo instante en que se origina, sino que hay que salir de la edición de la celda para que el evento ocurra.

private void dataGridView1_CellValueChanged(object sender, DataGridViewCellEventArgs e)
{
	//
	// Solo se trabaja ante los cambios en la columan de los checkbox 
	//
	if (dataGridView1.Columns[e.ColumnIndex].Name == "Seleccion") {
		//
		// Se toma la fila seleccionada
		//
		DataGridViewRow row = dataGridView1.Rows[e.RowIndex];

		//
		// Se selecciona la celda del checkbox
		//
		DataGridViewCheckBoxCell cellSelecion = row.Cells["Seleccion"] as DataGridViewCheckBoxCell;
              
		//
		// Se valida si esta checkeada
		//
		if (Convert.ToBoolean(cellSelecion.Value)) {

                  string mensaje = string.Format("Evento CellValueChanged.\n\nSe ha seccionado, \nDescripcion: '{0}', \nPrecio Unitario: '{1}', \nMedida: '{2}'", 
                                                      row.Cells["Descripcion"].Value, 
                                                      row.Cells["PrecioUnitario"].Value, 
                                                      row.Cells["UnidadMedida"].Value);

			MessageBox.Show(mensaje, "", MessageBoxButtons.OK, MessageBoxIcon.Information);

		}

	}

}

Con respecto al CellContentClick, que si ejecuta la acción en el mismo momento en que el usuario marca, o desmarca, el checkbox, pero me encontré que solo devolvía null en la propiedad Value de la celda.

private void dataGridView1_CellContentClick(object sender, DataGridViewCellEventArgs e)
{
    //
    // Detecta si se ha seleccionado el header de la grilla
    //
    if (e.RowIndex == -1)
        return;

    if (dataGridView1.Columns[e.ColumnIndex].Name == "Seleccion")
    {

        //
        // Se toma la fila seleccionada
        //
        DataGridViewRow row = dataGridView1.Rows[e.RowIndex];

        //
        // Se selecciona la celda del checkbox
        //
        DataGridViewCheckBoxCell cellSelecion = row.Cells["Seleccion"] as DataGridViewCheckBoxCell;


        if (Convert.ToBoolean(cellSelecion.Value))
        {

            string mensaje = string.Format("Evento CellContentClick.\n\nSe ha seccionado, \nDescripcion: '{0}', \nPrecio Unitario: '{1}', \nMedida: '{2}'",
                                                row.Cells["Descripcion"].Value,
                                                row.Cells["PrecioUnitario"].Value,
                                                row.Cells["UnidadMedida"].Value);

            MessageBox.Show(mensaje, "", MessageBoxButtons.OK, MessageBoxIcon.Information);

        }
        else
        {
            string mensaje = string.Format("Evento CellContentClick.\n\nSe ha quitado la seleccion, \nDescripcion: '{0}', \nPrecio Unitario: '{1}', \nMedida: '{2}'",
                                                row.Cells["Descripcion"].Value,
                                                row.Cells["PrecioUnitario"].Value,
                                                row.Cells["UnidadMedida"].Value);

            MessageBox.Show(mensaje, "", MessageBoxButtons.OK, MessageBoxIcon.Information);

        }
    }
}

También se ha intentado hacer uso del evento EditingControlShowing, el cual permitiría detectar la selección en el mismo momento que el usuario realiza la acción, pero esto no fue posible ya que este tipo de columna no provoca el evento necesario para tomar el control CheckBox y asignar el evento SelectedIndexChanged.

Ante este problema con los eventos, y notar que ninguno responde como debería, se encontró un método que resolvió todos los problemas de un solo golpe, se trata del CommitEdit

private void dataGridView1_CurrentCellDirtyStateChanged(object sender, EventArgs e)
{
    if (dataGridView1.IsCurrentCellDirty)
    {
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
    }
}

En el evento CurrentCellDirtyStateChanged, se detecta si la grilla esta con algún cambio pendiente, y en caso de estarlo se hace un Commit del mismo para reflejar el valor en los eventos que lo usaran. Esto arregla los dos problemas detectados anteriormente:

- se lanza el evento CellValueChanged, sin tener que quitar el foco de la celda

- ya no se recibe el null en el Value de la celda, en el evento CellContentClick

[C#]

[VB.NET]

Aplicar formato a la selección

Teniendo en cuenta lo contado en la sección anterior, aplicar un formato a la fila seleccionada no debería ser un misterio.

private void dataGridView1_CellContentClick(object sender, DataGridViewCellEventArgs e)
{
    //
    // Detecta si se ha seleccionado el header de la grilla
    //
    if (e.RowIndex == -1)
        return;

    if (dataGridView1.Columns[e.ColumnIndex].Name == "Seleccion")
    {

        //
        // Se toma la fila seleccionada
        //
        DataGridViewRow row = dataGridView1.Rows[e.RowIndex];

        //
        // Se selecciona la celda del checkbox
        //
        DataGridViewCheckBoxCell cellSelecion = row.Cells["Seleccion"] as DataGridViewCheckBoxCell;

        if (Convert.ToBoolean(cellSelecion.Value))
            row.DefaultCellStyle.BackColor = Color.Green;    
        else
            row.DefaultCellStyle.BackColor = Color.White; 

    }
}

private void dataGridView1_CurrentCellDirtyStateChanged(object sender, EventArgs e)
{
    if (dataGridView1.IsCurrentCellDirty)
    {
        dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
    }
}

Simplemente ante la detección de la selección del usuario se cambia el color de la fila usando el DefaultCellStyle.BackColor.

[C#]

[VB.NET]