DataGridViewCellToolTipTextNeededEventHandler Delegado

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Source:

DataGridViewEventHandlers.cs

Representa el método que controlará el evento CellToolTipTextNeeded de DataGridView.

C#

public delegate void DataGridViewCellToolTipTextNeededEventHandler(object? sender, DataGridViewCellToolTipTextNeededEventArgs e);

Parámetros

sender

Object

Origen del evento.

e

DataGridViewCellToolTipTextNeededEventArgs

Objeto DataGridViewCellToolTipTextNeededEventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se usa información sobre herramientas para mostrar información adicional sobre el contenido de las celdas de la ReportsTo columna.

C#

private DataTable Populate(string query, bool resetUnsharedCounter)
{
    if (resetUnsharedCounter)
    {
        ResetCounter();
    }

    // Alter the data source as necessary
    SqlDataAdapter adapter = new SqlDataAdapter(query,
        new SqlConnection("Integrated Security=SSPI;Persist Security Info=False;" +
        "Initial Catalog=Northwind;Data Source=localhost"));

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);
    return table;
}

private Label count = new Label();
private int unsharedRowCounter;

private void ResetCounter()
{
    unsharedRowCounter = 0;
    count.Text = unsharedRowCounter.ToString();
}

private void dataGridView1_CellToolTipTextNeeded(object sender,
    DataGridViewCellToolTipTextNeededEventArgs e)
{

    if (theCellImHoveringOver.ColumnIndex == dataGridView1.Columns["ReportsTo"].Index &&
        theCellImHoveringOver.RowIndex > -1)
    {

        string reportsTo = dataGridView1.Rows[theCellImHoveringOver.RowIndex].
            Cells[theCellImHoveringOver.ColumnIndex].Value.ToString();

        if (String.IsNullOrEmpty(reportsTo))
        {
            e.ToolTipText = "The buck stops here!";
        }
        else
        {
            DataTable table = Populate(
                "select firstname, lastname from employees where employeeid = '" +
                dataGridView1.Rows[theCellImHoveringOver.RowIndex].
                Cells[theCellImHoveringOver.ColumnIndex].Value.ToString() +
                "'", false);

            e.ToolTipText = "Reports to " + table.Rows[0].ItemArray[0] + " " +
                table.Rows[0].ItemArray[1];
        }
    }
}

Comentarios

El CellToolTipTextNeeded evento solo se produce cuando se establece la propiedad de DataGridView control DataSource o su VirtualMode propiedad es true.

Al controlar el CellToolTipTextNeeded evento, el texto de información sobre herramientas que especifique en el controlador se muestra cada vez que el puntero del mouse se encuentra sobre una celda y el valor de la propiedad de control ShowCellToolTips es true. El CellToolTipTextNeeded evento es útil cuando desea mostrar información sobre herramientas determinada por el estado actual o el valor de una celda.

El CellToolTipTextNeeded evento también se produce cada vez que se recupera el valor de la DataGridViewCell.ToolTipText propiedad, ya sea mediante programación o cuando el puntero del mouse entra en una celda.

Puede usar las DataGridViewCellEventArgs.ColumnIndex propiedades y RowIndex para determinar el estado o el valor de una celda y usar esta información para establecer la ToolTipText propiedad . Esta propiedad se inicializa con el valor de la propiedad cell ToolTipText , que el valor del evento invalida.

Controle el CellToolTipTextNeeded evento al trabajar con grandes cantidades de datos para evitar las penalizaciones de rendimiento de establecer el valor de celda ToolTipText para varias celdas. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.

Cuando se crea un delegado DataGridViewCellToolTipTextNeededEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador, se debe agregar una instancia del delegado al evento. Siempre que se produce el evento, se llama a su controlador, a menos que se quite el delegado. Para obtener más información sobre los delegados del controlador de eventos, consulte Control y generación de eventos.

Métodos de extensión

Se aplica a

Consulte también

• DataGridView
• CellToolTipTextNeeded
• DataSource
• VirtualMode
• ShowCellToolTips
• DataGridViewCellToolTipTextNeededEventArgs
• ToolTipText
• ToolTipText
• Procedimientos recomendados para ajustar la escala del control DataGridView en formularios Windows Forms