DataGridViewCell.ToolTipText Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCell.cs

Získá nebo nastaví text popisu přidružený 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 popisku přidružený k buňce Výchozí hodnota je Empty.

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje, jak nastavit ToolTipText vlastnost v obslužné rutině CellFormatting události pro událost. Tento příklad je součástí většího příkladu kódu uvedeného v části Postupy: Přidání popisů do jednotlivých buněk v ovládacím prvku Windows Forms DataGridView.

// 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 na buňku 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 zkrácena v zobrazení buňky. 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 falsehodnotu .

DataGridView Pokud je vlastnost ovládacího prvku DataSource nastavena nebo jeho 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 uvedeno v obslužné rutině události. Pokud neexistují žádné obslužné rutiny pro událost, získání hodnoty ToolTipText vlastnosti vrátí dříve zadanou hodnotu nebo její 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 zabránilo sankcím za výkon při nastavování hodnoty buňky ToolTipText pro více buněk. Další informace naleznete v tématu Osvědčené postupy pro škálování ovládacího prvku Windows Forms DataGridView.

Změna této vlastnosti vyvolá CellToolTipTextChanged událost ve vlastnictví DataGridView, pokud existuje.

Viz také

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