DataGridViewCell.ToolTipText Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает текст всплывающей подсказки, связанной с этой ячейкой.

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

Значение свойства

String

Текст всплывающей подсказки, связанной с ячейкой. Значение по умолчанию — Empty.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере кода показано, как задать ToolTipText свойство в обработчике CellFormatting событий для события. Этот пример является частью более крупного примера кода, приведенного в разделе How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

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

Комментарии

Значение этого свойства отображается как подсказка ячейки, если указатель мыши находится на ячейке, а значение свойства не Emptyравно . Если значение этого свойства равно Empty, в ячейке будет отображаться подсказка, содержащая значение ячейки, если значение усечено в отображаемой ячейке; в противном случае в ячейке не будет отображаться подсказка. Вы также можете запретить отображение подсказки, задав DataGridView.ShowCellToolTips для свойства значение false.

DataGridView Если свойство элемента управления DataSource задано или его VirtualMode свойство равно true, получение значения ToolTipText свойства вызывает CellToolTipTextNeeded событие элемента управления и возвращает значение свойства, указанное DataGridViewCellToolTipTextNeededEventArgs.ToolTipText в обработчике событий. Если обработчики для события отсутствуют, получение значения ToolTipText свойства возвращает ранее указанное значение или значение Emptyпо умолчанию .

CellToolTipTextNeeded Обработка события в первую очередь полезна при работе с большими объемами данных, чтобы избежать снижения производительности при задании значения ячейки ToolTipText для нескольких ячеек. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

Изменение этого свойства вызывает CellToolTipTextChanged событие в владельце DataGridView, если оно существует.

См. также раздел

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