DataGridViewCellToolTipTextNeededEventHandler Delegar

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

DataGridViewEventHandlers.cs

Representa o método que manipulará o evento de CellToolTipTextNeeded de DataGridView.

C#

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

Parâmetros

sender

Object

A fonte do evento.

e

DataGridViewCellToolTipTextNeededEventArgs

Um DataGridViewCellToolTipTextNeededEventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir usa Dicas de Ferramenta para exibir informações adicionais sobre o conteúdo da célula na ReportsTo coluna.

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];
        }
    }
}

Comentários

O CellToolTipTextNeeded evento ocorre somente quando a DataGridView propriedade de controle DataSource é definida ou sua VirtualMode propriedade é true.

Quando você manipula o CellToolTipTextNeeded evento, o texto tooltip especificado no manipulador é mostrado sempre que o ponteiro do mouse está sobre uma célula e o valor da propriedade de controle ShowCellToolTips é true. O CellToolTipTextNeeded evento é útil quando você deseja exibir Dicas de Ferramenta determinadas pelo estado ou valor atual de uma célula.

O CellToolTipTextNeeded evento também ocorre sempre que o valor da DataGridViewCell.ToolTipText propriedade é recuperado, seja programaticamente ou quando o ponteiro do mouse entra em uma célula.

Você pode usar as DataGridViewCellEventArgs.ColumnIndex propriedades e RowIndex para determinar o estado ou o valor de uma célula e usar essas informações para definir a ToolTipText propriedade. Essa propriedade é inicializada com o valor da propriedade de célula ToolTipText , que o valor do evento substitui.

Manipule o CellToolTipTextNeeded evento ao trabalhar com grandes quantidades de dados para evitar as penalidades de desempenho de definir o valor da célula ToolTipText para várias células. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Ao criar um DataGridViewCellToolTipTextNeededEventHandler delegado, você identifica o método que manipulará o evento. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento. O manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o representante. Para obter mais informações sobre delegados do manipulador de eventos, consulte Manipulando e gerando eventos.

Métodos de Extensão

Aplica-se a

Confira também

• DataGridView
• CellToolTipTextNeeded
• DataSource
• VirtualMode
• ShowCellToolTips
• DataGridViewCellToolTipTextNeededEventArgs
• ToolTipText
• ToolTipText
• Práticas recomendadas para dimensionamento do controle DataGridView dos Windows Forms