DataGridViewCell.ToolTipText Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur teks TipsAlat yang terkait dengan sel ini.

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

Nilai Properti

String

Teks TipsAlat yang terkait dengan sel. Default adalah Empty.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut menunjukkan cara mengatur ToolTipText properti dalam penanganan aktivitas untuk peristiwa tersebut CellFormatting . Contoh ini adalah bagian dari contoh kode yang lebih besar yang disediakan dalam Cara: Menambahkan TipsAlat ke Sel Individual dalam Kontrol DataGridView Formulir Windows.

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

Keterangan

Nilai properti ini ditampilkan sebagai TipsAlat sel ketika penunjuk mouse berada di atas sel dan nilai properti bukan Empty. Jika nilai properti ini adalah Empty, sel akan menampilkan TipsAlat yang berisi nilai sel jika nilai dipotok dalam tampilan sel; jika tidak, sel tidak akan menampilkan TipsAlat. Anda juga dapat mencegah tampilan TipsAlat dengan mengatur properti ke DataGridView.ShowCellToolTipsfalse.

DataGridView Ketika properti kontrol DataSource diatur atau propertinya VirtualMode adalah true, mendapatkan nilai ToolTipText properti memunculkan CellToolTipTextNeeded peristiwa kontrol dan mengembalikan nilai DataGridViewCellToolTipTextNeededEventArgs.ToolTipText properti seperti yang ditentukan dalam penanganan aktivitas. Jika tidak ada handler untuk peristiwa, mendapatkan nilai ToolTipText properti mengembalikan nilai yang ditentukan sebelumnya atau nilai defaultnya.Empty

Menangani CellToolTipTextNeeded peristiwa terutama berguna saat bekerja dengan data dalam jumlah besar untuk menghindari penalti performa saat mengatur nilai sel ToolTipText untuk beberapa sel. Untuk informasi selengkapnya, lihat Praktik Terbaik untuk Menskalakan Kontrol Formulir Windows DataGridView.

Mengubah properti ini akan meningkatkan CellToolTipTextChanged peristiwa yang dimiliki DataGridView, jika ada.

Lihat juga

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