DataGridViewCell.ToolTipText Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el texto de información sobre herramientas asociado a esta celda.

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 de propiedad

String

Texto de información sobre herramientas asociado a la celda. De manera predeterminada, es Empty.

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la ToolTipText propiedad dentro de un controlador de eventos para el CellFormatting evento. Este ejemplo forma parte de un ejemplo de código más grande que se proporciona en 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

Comentarios

El valor de esta propiedad se muestra como la información sobre herramientas de celda cuando el puntero del mouse está sobre la celda y el valor de la propiedad no Emptyes . Si el valor de esta propiedad es Empty, la celda mostrará una información sobre herramientas que contiene el valor de la celda si el valor se trunca en la pantalla de celda; de lo contrario, la celda no mostrará información sobre herramientas. También puede evitar la presentación de una información sobre herramientas estableciendo la DataGridView.ShowCellToolTips propiedad en false.

Cuando se establece la DataGridView propiedad de control DataSource o su VirtualMode propiedad es true, obtener el valor de la ToolTipText propiedad genera el CellToolTipTextNeeded evento del control y devuelve el valor de la DataGridViewCellToolTipTextNeededEventArgs.ToolTipText propiedad tal y como se especifica en el controlador de eventos. Si no hay controladores para el evento, obtener el valor de la ToolTipText propiedad devuelve el valor especificado anteriormente o su valor predeterminado de Empty.

Controlar el CellToolTipTextNeeded evento es principalmente útil cuando se trabaja con grandes cantidades de datos para evitar penalizaciones de rendimiento al establecer el valor de celda ToolTipText para varias celdas. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.

Al cambiar esta propiedad, se genera el CellToolTipTextChanged evento en el propietario DataGridView, si existe uno.

Consulte también

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