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

DataGridViewCell, classe

Mise à jour : novembre 2007

Représente une cellule dans un contrôle DataGridView.

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

public abstract class DataGridViewCell : DataGridViewElement, 
	ICloneable, IDisposable
public abstract class DataGridViewCell extends DataGridViewElement implements ICloneable, 
	IDisposable
public abstract class DataGridViewCell extends DataGridViewElement implements ICloneable, IDisposable

La classe DataGridViewCell représente une cellule dans un contrôle DataGridView. Vous pouvez récupérer des cellules par l'intermédiaire de la collection Cells d'un DataGridViewRow.

La ligne et la colonne de DataGridViewCell identifient l'emplacement de la cellule dans DataGridView. Une cellule standard contient des données spécifiques à la ligne et la colonne dans lesquelles elle est contenue. La cellule peut être personnalisée de plusieurs manières en définissant ses propriétés et en gérant les événements qui lui sont associés.

Remarques à l'attention des héritiers :

Lorsque vous effectuez une dérivation à partir de DataGridViewCell et que vous ajoutez de nouvelles propriétés à la classe dérivée, veillez à substituer la méthode Clone pour copier les nouvelles propriétés au cours des opérations de clonage. Vous devez également appeler la méthode Clone de la classe de base afin que les propriétés de cette classe de base soient copiées dans la nouvelle cellule.

L'exemple de code suivant illustre l'utilisation de ce type. Pour plus d'informations sur cet exemple, consultez Comment : ajouter des info-bulles à des cellules 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 != 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";
        }
    }
}


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: