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é

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 Guide pratique pour ajouter des info-bulles à des cellules individuelles dans un contrôle 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

Remarques

La valeur de cette propriété s’affiche sous forme d’info-bulle de cellule lorsque le pointeur de la souris se trouve 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é sur false.

Lorsque la DataGridView propriété de contrôle DataSource est définie ou que sa VirtualMode propriété est true, l’obtention de la valeur de la ToolTipText propriété déclenche l’événement CellToolTipTextNeeded 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 de Empty.

La gestion de l’événement CellToolTipTextNeeded est principalement utile lors de l’utilisation de grandes quantités de données afin d’éviter des 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, le cas échéant.

S’applique à

Voir aussi