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

DataGridViewLinkColumn, classe

Représente une colonne des cellules qui contiennent des liens dans un contrôle DataGridView.

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

public class DataGridViewLinkColumn : DataGridViewColumn
public class DataGridViewLinkColumn extends DataGridViewColumn
public class DataGridViewLinkColumn extends DataGridViewColumn
Non applicable.

La classe DataGridViewLinkColumn est un type spécialisé de la classe DataGridViewColumn utilisé pour héberger logiquement des cellules qui répondent aux clics d'utilisateur. La classe DataGridViewLinkColumn est similaire à la classe DataGridViewButtonColumn, mais elle fournit une expérience utilisateur différente qui peut être plus appropriée dans certaines situations, comme l'affichage d'une URL stockée dans une table de base de données.

Pour afficher le même texte du lien pour chaque cellule, affectez la valeur true à la propriété UseColumnTextForLinkValue et affectez la propriété Text au texte de lien souhaité.

DataGridViewLinkColumn est associé à DataGridViewLinkCell dans chaque DataGridViewRow qui le croise.

Le mode de tri par défaut de ce type de colonne est NotSortable.

Pour répondre aux clics de l'utilisateur sur le lien, gérez l'événement DataGridView.CellContentClick. Vous pouvez également utiliser l'événement DataGridView.CellClick pour répondre aux clics effectués dans la cellule.

Remarques à l'attention des héritiers : Lorsque vous effectuez une dérivation à partir de DataGridViewLinkColumn et 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 soient copiées dans la nouvelle cellule.

L'exemple de code suivant affecte une valeur DataGridViewLinkColumn aux propriétés. Cet exemple fait partie d'un exemple plus développé disponible dans la rubrique sur la vue d'ensemble de la classe DataGridViewComboBoxColumn.

private void AddLinkColumn()
{
    DataGridViewLinkColumn links = new DataGridViewLinkColumn();

    links.HeaderText = ColumnName.ReportsTo.ToString();
    links.DataPropertyName = ColumnName.ReportsTo.ToString();
    links.ActiveLinkColor = Color.White;
    links.LinkBehavior = LinkBehavior.SystemDefault;
    links.LinkColor = Color.Blue;
    links.TrackVisitedState = true;
    links.VisitedLinkColor = Color.YellowGreen;

    DataGridView1.Columns.Add(links);
}

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Afficher: