Udostępnij za pośrednictwem


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

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ń dla CellFormatting 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 (Instrukcje: dodawanie etykietek narzędzi do poszczególnych komórek w kontrolce 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

Uwagi

Wartość tej właściwości jest wyświetlana jako etykietka narzędzia komórki, 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ść zostanie obcięta na ekranie komórki. W przeciwnym razie komórka nie wyświetli etykietki narzędzia. Można również uniemożliwić wyświetlanie etykietki narzędzia, ustawiając DataGridView.ShowCellToolTips właściwość na false.

Gdy właściwość kontrolki DataGridViewDataSource 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 jej wartość domyślną Empty.

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

Zmiana tej właściwości powoduje wywołanie CellToolTipTextChangedDataGridViewzdarzenia na własność , jeśli istnieje.

Dotyczy

Zobacz też