Esporta (0) Stampa
Espandi tutto
Espandi Riduci a icona

Evento DataGridView.CellToolTipTextNeeded

Si verifica quando è necessario il testo della descrizione comandi di una cella.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public event DataGridViewCellToolTipTextNeededEventHandler CellToolTipTextNeeded
/** @event */
public void add_CellToolTipTextNeeded (DataGridViewCellToolTipTextNeededEventHandler value)

/** @event */
public void remove_CellToolTipTextNeeded (DataGridViewCellToolTipTextNeededEventHandler value)

In JScript è possibile gestire gli eventi definiti da una classe, ma non è possibile definirne di personalizzati.
Non applicabile.

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

Quando si gestisce l'evento CellToolTipTextNeeded, il testo della descrizione comandi specificato nel gestore verrà visualizzato ogni volta che il puntatore del mouse viene posizionato su una cella e il valore della proprietà ShowCellToolTips del controllo è true. L'evento CellToolTipTextNeeded è utile quando si desidera visualizzare le descrizioni comandi in base allo stato o al valore corrente di una cella.

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

È possibile utilizzare le proprietà DataGridViewCellEventArgs.ColumnIndex e RowIndex per determinare lo stato o il valore di una cella e quindi utilizzare tali informazioni per modificare il valore della proprietà DataGridViewCellToolTipTextNeededEventArgs.ToolTipText. Questa proprietà viene inizializzata sul valore della proprietà ToolTipText della cella, che esegue l'override del valore dell'evento.

Quando si utilizzano grandi quantità di dati, per evitare una diminuzione nelle prestazioni a causa dell'impostazione del valore della proprietà ToolTipText per più celle, si consiglia di gestire l'evento CellToolTipTextNeeded. Per ulteriori informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Per ulteriori informazioni sulla gestione di eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare un gestore eventi CellToolTipTextNeeded per visualizzare informazioni contenute nelle colonne nascoste di un controllo DataGridView con associazione a dati.

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());
    }
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft