DataGridViewCell.ToolTipText Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta il testo della descrizione comandi associato a questa cella.

public:
 property System::String ^ ToolTipText { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string ToolTipText { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.ToolTipText : string with get, set

Public Property ToolTipText As String

Valore della proprietà

String

Testo della descrizione comandi associato a questa cella. Il valore predefinito è Empty.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la ToolTipText proprietà all'interno di un gestore eventi per l'evento CellFormatting . Questo esempio fa parte di un esempio di codice più ampio fornito in Procedura: Aggiungere descrizioni comando a singole celle in un controllo DataGridView Windows Forms.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}

' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

Commenti

Il valore di questa proprietà viene visualizzato come descrizione comando della cella quando il puntatore del mouse si trova sulla cella e il valore della proprietà non Emptyè . Se il valore di questa proprietà è Empty, la cella visualizzerà una descrizione comando contenente il valore della cella se il valore viene troncato nella visualizzazione della cella; in caso contrario, la cella non visualizzerà una descrizione comando. È anche possibile impedire la visualizzazione di una descrizione comando impostando la DataGridView.ShowCellToolTips proprietà su false.

Quando la proprietà del DataGridView controllo DataSource è impostata o la relativa VirtualMode proprietà è true, ottenere il valore della ToolTipText proprietà genera l'evento CellToolTipTextNeeded del controllo e restituisce il valore della DataGridViewCellToolTipTextNeededEventArgs.ToolTipText proprietà come specificato nel gestore eventi. Se non sono presenti gestori per l'evento, ottenere il valore della ToolTipText proprietà restituisce il valore specificato in precedenza o il valore predefinito di Empty.

La gestione dell'evento CellToolTipTextNeeded è particolarmente utile quando si usano grandi quantità di dati per evitare sanzioni sulle prestazioni quando si imposta il valore della cella ToolTipText per più celle. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Se si modifica questa proprietà, viene generato l'evento CellToolTipTextChangedDataGridViewproprietario, se presente.

Vedi anche

• DataGridView
• ShowCellToolTips
• CellToolTipTextChanged
• CellToolTipTextNeeded
• DataSource
• VirtualMode