DataGridViewCell.ToolTipText Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Bu hücreyle ilişkili Araç İpucu metnini alır veya ayarlar.

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

Özellik Değeri

String

Hücreyle ilişkili Araç İpucu metni. Varsayılan değer: Empty.

Öznitelikler

BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, olay için CellFormatting bir olay işleyicisi içinde özelliğinin ToolTipText nasıl ayarlandığını gösterir. Bu örnek, How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control bölümünde sağlanan daha büyük bir kod örneğinin bir parçasıdır.

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

Açıklamalar

Bu özelliğin değeri, fare işaretçisi hücrenin üzerindeyken ve özellik değeri olmadığında EmptyAraç İpucu hücresi olarak görüntülenir. Bu özelliğin değeri ise Empty, hücre görüntüsünde değer kesilirse hücrenin değerini içeren bir Araç İpucu görüntüler; aksi takdirde, hücre araç ipucu görüntülemez. Özelliğini falseolarak ayarlayarak bir Araç İpucunun görüntülenmesini DataGridView.ShowCellToolTips de önleyebilirsiniz.

DataGridView Denetim DataSource özelliği ayarlandığında veya VirtualMode özelliği olduğundatrue, özelliğinin ToolTipText değerini almak denetimin olayını tetikler CellToolTipTextNeeded ve olay işleyicisinde belirtildiği gibi özelliğinin DataGridViewCellToolTipTextNeededEventArgs.ToolTipText değerini döndürür. Olay için işleyici yoksa, özelliğinin ToolTipText değerini almak daha önce belirtilen değeri veya varsayılan değerini Emptydöndürür.

CellToolTipTextNeeded Olayı işlemek, birden çok hücre için hücre ToolTipText değerini ayarlarken performans cezalarını önlemek için büyük miktarda veriyle çalışırken öncelikli olarak yararlıdır. Daha fazla bilgi için bkz. Windows Forms DataGridView Denetimini Ölçeklendirmeye Yönelik En İyi Yöntemler.

Bu özelliğin CellToolTipTextChanged değiştirilmesi, varsa olayı sahip olan üzerinde tetikler DataGridView.

Ayrıca bkz.

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