DataGridViewCell.ToolTipText Propriedade

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o texto de ToolTip associado à célula.

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

Valor da propriedade

String

O texto de ToolTip associado à célula. O padrão é Empty.

Atributos: BrowsableAttribute

Exemplos

O exemplo de código a seguir mostra como definir a ToolTipText propriedade dentro de um manipulador de eventos para o CellFormatting evento. Este exemplo faz parte de um exemplo de código maior fornecido em 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

Comentários

O valor dessa propriedade é exibido como a Dica de Ferramenta da célula quando o ponteiro do mouse está sobre a célula e o valor da propriedade não Emptyé . Se o valor dessa propriedade for Empty, a célula exibirá uma Dica de Ferramenta contendo o valor da célula se o valor for truncado na exibição da célula; caso contrário, a célula não exibirá uma Dica de Ferramenta. Você também pode impedir a exibição de uma Dica de Ferramenta definindo a DataGridView.ShowCellToolTips propriedade como false.

Quando a DataGridView propriedade de controle DataSource é definida ou sua VirtualMode propriedade é true, obter o valor da ToolTipText propriedade gera o CellToolTipTextNeeded evento do controle e retorna o valor da DataGridViewCellToolTipTextNeededEventArgs.ToolTipText propriedade conforme especificado no manipulador de eventos. Se não houver manipuladores para o evento, obter o valor da ToolTipText propriedade retornará o valor especificado anteriormente ou seu valor padrão de Empty.

Lidar com o CellToolTipTextNeeded evento é útil principalmente ao trabalhar com grandes quantidades de dados para evitar penalidades de desempenho ao definir o valor da célula ToolTipText para várias células. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

Alterar essa propriedade gera o CellToolTipTextChanged evento na propriedade DataGridView, se houver.

Aplica-se a

Partilhar via