DataGridViewCell.ToolTipText Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den dieser Zelle zugeordneten QuickInfo-Text ab oder legt diesen fest.

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

Eigenschaftswert

String

Der der Zelle zugeordnete QuickInfo-Text. Der Standardwert ist Empty.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die ToolTipText -Eigenschaft in einem Ereignishandler für das CellFormatting Ereignis festgelegt wird. Dieses Beispiel ist Teil eines größeren Codebeispiels unter Vorgehensweise: Hinzufügen von QuickInfos zu einzelnen Zellen in einem Windows Forms DataGridView-Steuerelement.

// 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

Hinweise

Der Wert dieser Eigenschaft wird als QuickInfo der Zelle angezeigt, wenn sich der Mauszeiger über der Zelle befindet und der Eigenschaftswert nicht Emptyist. Wenn der Wert dieser Eigenschaft ist Empty, zeigt die Zelle eine QuickInfo mit dem Wert der Zelle an, wenn der Wert in der Zellenanzeige abgeschnitten ist. Andernfalls zeigt die Zelle keine QuickInfo an. Sie können auch die Anzeige einer QuickInfo verhindern, indem Sie die DataGridView.ShowCellToolTips -Eigenschaft auf falsefestlegen.

Wenn die DataGridView Steuerelementeigenschaft DataSource festgelegt ist oder ihre VirtualMode Eigenschaft ist true, löst das Abrufen des Werts der ToolTipText -Eigenschaft das CellToolTipTextNeeded -Ereignis des Steuerelements aus und gibt den Wert der DataGridViewCellToolTipTextNeededEventArgs.ToolTipText -Eigenschaft zurück, wie im Ereignishandler angegeben. Wenn keine Handler für das Ereignis vorhanden sind, gibt das Abrufen des Werts der ToolTipText -Eigenschaft den zuvor angegebenen Wert oder den Standardwert von Emptyzurück.

Die Behandlung des Ereignisses CellToolTipTextNeeded ist in erster Linie beim Arbeiten mit großen Datenmengen nützlich, um Leistungseinbußen beim Festlegen des Zellwerts ToolTipText für mehrere Zellen zu vermeiden. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Wenn Sie diese Eigenschaft ändern, wird das CellToolTipTextChanged -Ereignis für den besitzenden DataGridViewausgelöst, sofern vorhanden.

Gilt für:

Freigeben über