DataGridViewCell.ToolTipText Propriété

Définition

Obtient ou définit le texte d'info-bulle associé à cette cellule.

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

Valeur de propriété

String

Texte d'info-bulle associé à la cellule. La valeur par défaut est Empty.

Attributs

Exemples

L’exemple de code suivant montre comment définir la ToolTipText propriété dans un gestionnaire d’événements pour l’événement CellFormatting . Cet exemple fait partie d’un exemple de code plus volumineux fourni dans 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

Remarques

La valeur de cette propriété s’affiche comme info-bulle de cellule lorsque le pointeur de la souris est sur la cellule et que la valeur de la propriété n’est pas Empty. Si la valeur de cette propriété est Empty, la cellule affiche une info-bulle contenant la valeur de la cellule si la valeur est tronquée dans l’affichage de la cellule ; sinon, la cellule n’affiche pas d’info-bulle. Vous pouvez également empêcher l’affichage d’une info-bulle en définissant la DataGridView.ShowCellToolTips propriété falsesur .

Lorsque la DataGridView propriété de contrôle DataSource est définie ou que sa VirtualMode propriété est truedéfinie, l’obtention de la valeur de la ToolTipText propriété déclenche CellToolTipTextNeeded l’événement du contrôle et retourne la valeur de la DataGridViewCellToolTipTextNeededEventArgs.ToolTipText propriété comme spécifié dans le gestionnaire d’événements. S’il n’existe aucun gestionnaire pour l’événement, l’obtention de la valeur de la ToolTipText propriété retourne la valeur spécifiée précédemment ou sa valeur par défaut .Empty

La gestion de l’événement est principalement utile lors de l’utilisation CellToolTipTextNeeded de grandes quantités de données pour éviter les pénalités de performances lors de la définition de la valeur de cellule ToolTipText pour plusieurs cellules. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

La modification de cette propriété déclenche l’événement CellToolTipTextChanged sur le propriétaire DataGridView, s’il en existe un.

S’applique à

Voir aussi