DataGridViewCell.ToolTipText Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví text popisu tlačítka přidruženého k této buňce.

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

Hodnota vlastnosti

String

Text popisu tlačítka přidružený k buňce Výchozí formát je Empty.

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje, jak nastavit ToolTipText vlastnost v rámci obslužné rutiny CellFormatting události pro událost. Tento příklad je součástí větší příklad kódu uvedený v How to: Add ToolTips to individual cells in a model Windows Forms DataGridView Control.

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

Poznámky

Hodnota této vlastnosti se zobrazí jako popis buňky, když je ukazatel myši nad buňkou a hodnota vlastnosti není Empty. Pokud je Emptyhodnota této vlastnosti , zobrazí se v buňce popis obsahující hodnotu buňky, pokud je hodnota v zobrazení buňky zkrácena. V opačném případě se v buňce nezobrazí popis. Zobrazení popisu můžete také zabránit nastavením DataGridView.ShowCellToolTips vlastnosti na false.

DataGridView Pokud je vlastnost ovládacího prvku DataSource nastavena nebo je její VirtualMode vlastnost je true, získání hodnoty ToolTipText vlastnosti vyvolá CellToolTipTextNeeded událost ovládacího prvku a vrátí hodnotu DataGridViewCellToolTipTextNeededEventArgs.ToolTipText vlastnosti, jak je zadána v obslužné rutině události. Pokud pro událost neexistují žádné obslužné rutiny, načtení hodnoty ToolTipText vlastnosti vrátí dříve zadanou hodnotu nebo výchozí hodnotu Empty.

CellToolTipTextNeeded Zpracování události je primárně užitečné při práci s velkými objemy dat, aby se při nastavování hodnoty buňky ToolTipText pro více buněk zabránilo snížení výkonu. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Změna této vlastnosti vyvolá CellToolTipTextChanged událost u vlastnícího DataGridViewobjektu , pokud existuje.

Viz také

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