Cette documentation est archivée et n’est pas conservée.

DataGridViewCellToolTipTextNeededEventArgs, classe

Mise à jour : novembre 2007

Fournit des données pour l'événement CellToolTipTextNeeded.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public class DataGridViewCellToolTipTextNeededEventArgs : DataGridViewCellEventArgs
public class DataGridViewCellToolTipTextNeededEventArgs extends DataGridViewCellEventArgs
public class DataGridViewCellToolTipTextNeededEventArgs extends DataGridViewCellEventArgs

L'événement CellToolTipTextNeeded se produit uniquement lorsque la propriété DataSource du contrôle DataGridView est définie ou lorsque la valeur de sa propriété VirtualMode est true.

Lorsque vous gérez l'événement CellToolTipTextNeeded, le texte info-bulle que vous spécifiez dans le gestionnaire est affiché à chaque fois que le pointeur de la souris se trouve sur une cellule et que la valeur de propriété ShowCellToolTips de contrôle est true. L'événement CellToolTipTextNeeded est utile lorsque vous souhaitez afficher des info-bulles déterminées par l'état actuel ou la valeur d'une cellule.

L'événement CellToolTipTextNeeded se produit également à chaque fois que la valeur de la propriété DataGridViewCell.ToolTipText est récupérée, soit par programme soit lorsque le pointeur de la souris se trouve sur une cellule.

Vous pouvez utiliser les propriétés ColumnIndex et RowIndex pour déterminer l'état ou la valeur d'une cellule et utilisez cette information pour définir la propriété ToolTipText. Cette propriété est initialisée avec la valeur de la propriété ToolTipText de la cellule, que la valeur d'événement substitue.

Gérez l'événement CellToolTipTextNeeded lorsque vous utilisez de grandes quantités de données pour éviter une altération des performances due à la définition de la valeur de ToolTipText de la cellule pour plusieurs cellules. Pour plus d'informations, consultez Méthodes conseillées pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Pour plus d'informations sur la gestion des événements, consultez Consommation d'événements.

L'exemple de code suivant remplit ToolTipText avec les informations provenant des cellules masquées de DataGridView.

void dataGridView1_CellToolTipTextNeeded(object sender,
    DataGridViewCellToolTipTextNeededEventArgs e)
{
    string newLine = Environment.NewLine;
    if (e.RowIndex > -1)
    {
        DataGridViewRow dataGridViewRow1 = dataGridView1.Rows[e.RowIndex];

        // Add the employee's ID to the ToolTipText.
        e.ToolTipText = String.Format("EmployeeID {0}:{1}",
            dataGridViewRow1.Cells["EmployeeID"].Value, newLine);

        // Add the employee's name to the ToolTipText.
        e.ToolTipText += String.Format("{0} {1} {2}{3}",
            dataGridViewRow1.Cells["TitleOfCourtesy"].Value.ToString(),
            dataGridViewRow1.Cells["FirstName"].Value.ToString(),
            dataGridViewRow1.Cells["LastName"].Value.ToString(),
            newLine);

        // Add the employee's title to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}",
            dataGridViewRow1.Cells["Title"].Value.ToString(),
            newLine, newLine);

        // Add the employee's contact information to the ToolTipText.
        e.ToolTipText += String.Format("{0}{1}{2}, ",
            dataGridViewRow1.Cells["Address"].Value.ToString(), newLine,
            dataGridViewRow1.Cells["City"].Value.ToString());
        if (!String.IsNullOrEmpty(
            dataGridViewRow1.Cells["Region"].Value.ToString()))
        {
            e.ToolTipText += String.Format("{0}, ",
                dataGridViewRow1.Cells["Region"].Value.ToString());
        }
        e.ToolTipText += String.Format("{0}, {1}{2}{3} EXT:{4}{5}{6}",
            dataGridViewRow1.Cells["Country"].Value.ToString(),
            dataGridViewRow1.Cells["PostalCode"].Value.ToString(),
            newLine, dataGridViewRow1.Cells["HomePhone"].Value.ToString(),
            dataGridViewRow1.Cells["Extension"].Value.ToString(),
            newLine, newLine);

        // Add employee information to the ToolTipText.
        DateTime HireDate =
            (DateTime)dataGridViewRow1.Cells["HireDate"].Value;
        e.ToolTipText +=
            String.Format("Employee since: {0}/{1}/{2}{3}Manager: {4}",
            HireDate.Month.ToString(), HireDate.Day.ToString(),
            HireDate.Year.ToString(), newLine,
            dataGridViewRow1.Cells["Manager"].Value.ToString());
    }
}


System.Object
  System.EventArgs
    System.Windows.Forms.DataGridViewCellEventArgs
      System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: