DataGridViewCell.ToolTipText Właściwość

Definicja

Pobiera lub ustawia tekst etykietki narzędzia skojarzony z tą komórką.

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

Wartość właściwości

String

Tekst etykietki narzędzia skojarzony z komórką. Wartość domyślna to Empty.

Atrybuty

Przykłady

Poniższy przykład kodu pokazuje, jak ustawić ToolTipText właściwość w programie obsługi zdarzeń CellFormatting dla zdarzenia. Ten przykład jest częścią większego przykładu kodu przedstawionego w temacie How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control (Dodawanie etykietek narzędzi do poszczególnych komórek w kontrolce 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

Uwagi

Wartość tej właściwości jest wyświetlana jako komórka ToolTip, gdy wskaźnik myszy znajduje się nad komórką, a wartość właściwości nie Emptyjest . Jeśli wartość tej właściwości to Empty, komórka wyświetli etykietkę narzędzia zawierającą wartość komórki, jeśli wartość jest obcięta na ekranie komórki; w przeciwnym razie komórka nie wyświetli etykietki narzędzia. Można również zapobiec wyświetlaniu etykietki narzędzia, ustawiając DataGridView.ShowCellToolTips właściwość na false.

DataGridView Gdy właściwość kontrolki DataSource jest ustawiona lub jej VirtualMode właściwość to true, uzyskanie wartości ToolTipText właściwości zgłasza CellToolTipTextNeeded zdarzenie kontrolki i zwraca wartość DataGridViewCellToolTipTextNeededEventArgs.ToolTipText właściwości określonej w procedurze obsługi zdarzeń. Jeśli dla zdarzenia nie ma żadnych procedur obsługi, pobranie wartości ToolTipText właściwości zwraca wcześniej określoną wartość lub jego wartość domyślną .Empty

Obsługa zdarzenia CellToolTipTextNeeded jest przede wszystkim przydatna podczas pracy z dużymi ilościami danych, aby uniknąć kar za wydajność podczas ustawiania wartości komórki ToolTipText dla wielu komórek. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące skalowania kontrolki Windows Forms DataGridView.

Zmiana tej właściwości powoduje podniesienie CellToolTipTextChanged zdarzenia na własność DataGridView, jeśli istnieje.

Dotyczy

Zobacz też