DataGridViewCell.ToolTipText Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewCell.cs

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

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 события. Этот пример является частью более крупного примера кода, предоставленного в разделе "Практическое руководство. Добавление подсказок в отдельные ячейки в элементе управления 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

Комментарии

Значение этого свойства отображается в виде подсказки ячейки, когда указатель мыши находится над ячейкой, а значение свойства не 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