DataGridViewCellToolTipTextNeededEventArgs Classe

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataGridViewCellToolTipTextNeededEventArgs.cs

Fornisce i dati per l'evento CellToolTipTextNeeded.

public ref class DataGridViewCellToolTipTextNeededEventArgs : System::Windows::Forms::DataGridViewCellEventArgs

public class DataGridViewCellToolTipTextNeededEventArgs : System.Windows.Forms.DataGridViewCellEventArgs

type DataGridViewCellToolTipTextNeededEventArgs = class
    inherit DataGridViewCellEventArgs

Public Class DataGridViewCellToolTipTextNeededEventArgs
Inherits DataGridViewCellEventArgs

Ereditarietà

Object

EventArgs

DataGridViewCellEventArgs

DataGridViewCellToolTipTextNeededEventArgs

Esempio

Nell'esempio di codice seguente vengono riempite le ToolTipText informazioni delle celle nascoste in DataGridView.

void dataGridView1_CellToolTipTextNeeded(object sender,
    DataGridViewCellToolTipTextNeededEventArgs e)
{
    string newLine = Environment.NewLine;
    if (e.RowIndex > -1)
    {
        DataGridViewRow dataGridViewRow1 = dataGridView1.Rows[e.RowIndex];

        // Add the employee's ID to the ToolTipText.
        e.ToolTipText = String.Format("EmployeeID {0}:{1}",
            dataGridViewRow1.Cells["EmployeeID"].Value, newLine);

        // Add the employee's name to the ToolTipText.
        e.ToolTipText += String.Format("{0} {1} {2}{3}",
            dataGridViewRow1.Cells["TitleOfCourtesy"].Value.ToString(),
            dataGridViewRow1.Cells["FirstName"].Value.ToString(),
            dataGridViewRow1.Cells["LastName"].Value.ToString(),
            newLine);

        // Add the employee's title to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}",
            dataGridViewRow1.Cells["Title"].Value.ToString(),
            newLine, newLine);

        // Add the employee's contact information to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}, ",
            dataGridViewRow1.Cells["Address"].Value.ToString(), newLine,
            dataGridViewRow1.Cells["City"].Value.ToString());
        if (!String.IsNullOrEmpty(
            dataGridViewRow1.Cells["Region"].Value.ToString()))
        {
            e.ToolTipText += String.Format("{0}, ",
                dataGridViewRow1.Cells["Region"].Value.ToString());
        }
        e.ToolTipText += String.Format("{0}, {1}{2}{3} EXT:{4}{5}{6}",
            dataGridViewRow1.Cells["Country"].Value.ToString(),
            dataGridViewRow1.Cells["PostalCode"].Value.ToString(),
            newLine, dataGridViewRow1.Cells["HomePhone"].Value.ToString(),
            dataGridViewRow1.Cells["Extension"].Value.ToString(),
            newLine, newLine);

        // Add employee information to the ToolTipText.
        DateTime HireDate =
            (DateTime)dataGridViewRow1.Cells["HireDate"].Value;
        e.ToolTipText +=
            String.Format("Employee since: {0}/{1}/{2}{3}Manager: {4}",
            HireDate.Month.ToString(), HireDate.Day.ToString(),
            HireDate.Year.ToString(), newLine,
            dataGridViewRow1.Cells["Manager"].Value.ToString());
    }
}

Public Sub dataGridView1_CellToolTipTextNeeded(ByVal sender As Object, _
    ByVal e As DataGridViewCellToolTipTextNeededEventArgs) _
    Handles dataGridView1.CellToolTipTextNeeded

    Dim newLine As String = Environment.NewLine
    If e.RowIndex > -1 Then
        Dim dataGridViewRow1 As DataGridViewRow = _
        dataGridView1.Rows(e.RowIndex)

        ' Add the employee's ID to the ToolTipText.
        e.ToolTipText = String.Format("EmployeeID {0}: {1}", _
            dataGridViewRow1.Cells("EmployeeID").Value.ToString(), _
            newLine)

        ' Add the employee's name to the ToolTipText.
        e.ToolTipText += String.Format("{0} {1} {2} {3}", _
            dataGridViewRow1.Cells("TitleOfCourtesy").Value.ToString(), _
            dataGridViewRow1.Cells("FirstName").Value.ToString(), _
            dataGridViewRow1.Cells("LastName").Value.ToString(), _
            newLine)

        ' Add the employee's title to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}", _
            dataGridViewRow1.Cells("Title").Value.ToString(), _
            newLine, newLine)

        ' Add the employee's contact information to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}, ", _
            dataGridViewRow1.Cells("Address").Value.ToString(), newLine, _
            dataGridViewRow1.Cells("City").Value.ToString())
        If Not String.IsNullOrEmpty( _
            dataGridViewRow1.Cells("Region").Value.ToString())

            e.ToolTipText += String.Format("{0}, ", _
               dataGridViewRow1.Cells("Region").Value.ToString())
        End If
        e.ToolTipText += String.Format("{0}, {1}{2}{3} EXT:{4}{5}{6}", _
            dataGridViewRow1.Cells("Country").Value.ToString(), _
            dataGridViewRow1.Cells("PostalCode").Value.ToString(), _
            newLine, _
            dataGridViewRow1.Cells("HomePhone").Value.ToString(), _
            dataGridViewRow1.Cells("Extension").Value.ToString(), _
            newLine, newLine)

        ' Add employee information to the ToolTipText.
        Dim HireDate As DateTime = _
            CType(dataGridViewRow1.Cells("HireDate").Value, DateTime)
        e.ToolTipText += _
            String.Format("Employee since: {0}/{1}/{2}{3}Manager: {4}", _
                HireDate.Month.ToString(), HireDate.Day.ToString(), _
                HireDate.Year.ToString(), newLine, _
                dataGridViewRow1.Cells("Manager").Value.ToString())
    End If
End Sub

Commenti

L'evento CellToolTipTextNeeded si verifica solo quando la proprietà del DataGridView controllo DataSource è impostata o la relativa VirtualMode proprietà è true.

Quando si gestisce l'evento CellToolTipTextNeeded , il testo della descrizione comando specificato nel gestore viene visualizzato ogni volta che il puntatore del mouse si trova su una cella e il valore della proprietà del controllo ShowCellToolTips è true. L'evento CellToolTipTextNeeded è utile quando si desidera visualizzare descrizioni comando determinate dallo stato corrente o dal valore di una cella.

L'evento CellToolTipTextNeeded si verifica anche ogni volta che viene recuperato il valore della proprietà, a livello di DataGridViewCell.ToolTipText codice o quando il puntatore del mouse entra in una cella.

È possibile utilizzare le ColumnIndex proprietà e RowIndex per determinare lo stato o il valore di una cella e utilizzare queste informazioni per impostare la ToolTipText proprietà . Questa proprietà viene inizializzata con il valore della proprietà cell ToolTipText , di cui viene eseguito l'override del valore dell'evento.

Gestire l'evento CellToolTipTextNeeded quando si usano grandi quantità di dati per evitare le penalità delle prestazioni dell'impostazione del valore della cella ToolTipText per più celle. Per altre informazioni, vedere Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form.

Per altre informazioni su come gestire gli eventi, vedere Gestione e generazione di eventi.

Proprietà

Nome	Descrizione
ColumnIndex	Ottiene un valore che indica l'indice di colonna della cella per cui si verifica l'evento. (Ereditato da DataGridViewCellEventArgs)
RowIndex	Ottiene un valore che indica l'indice di riga della cella per cui si verifica l'evento. (Ereditato da DataGridViewCellEventArgs)
ToolTipText	Ottiene o imposta il testo della descrizione comando.

Vedi anche

• DataGridView
• CellToolTipTextNeeded
• DataSource
• VirtualMode
• ShowCellToolTips
• OnCellToolTipTextNeeded(DataGridViewCellToolTipTextNeededEventArgs)
• DataGridViewCellToolTipTextNeededEventHandler
• ToolTipText
• ToolTipText
• Procedure consigliate per il ridimensionamento del controllo DataGridView di Windows Form