DataGridViewLinkColumn Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewLinkColumn.cs

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

public ref class DataGridViewLinkColumn : System::Windows::Forms::DataGridViewColumn

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn

Héritage

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Attributs

ToolboxBitmapAttribute DynamicallyAccessedMembersAttribute

Exemples

L’exemple de code suivant définit des propriétés sur un DataGridViewLinkColumn. Cet exemple fait partie d’un exemple plus large disponible dans la rubrique vue d’ensemble de la DataGridViewComboBoxColumn classe.

private:
    void AddLinkColumn()
    {
        DataGridViewLinkColumn^ links = gcnew DataGridViewLinkColumn();

        links->UseColumnTextForLinkValue = true;
        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);
    }

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

    links.UseColumnTextForLinkValue = true;
    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);
}

Private Sub AddLinkColumn()

    Dim links As New DataGridViewLinkColumn()
    With links
        .UseColumnTextForLinkValue = True
        .HeaderText = ColumnName.ReportsTo.ToString()
        .DataPropertyName = ColumnName.ReportsTo.ToString()
        .ActiveLinkColor = Color.White
        .LinkBehavior = LinkBehavior.SystemDefault
        .LinkColor = Color.Blue
        .TrackVisitedState = True
        .VisitedLinkColor = Color.YellowGreen
    End With
    DataGridView1.Columns.Add(links)
End Sub

Remarques

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

Pour afficher le même texte de lien pour chaque cellule, définissez la UseColumnTextForLinkValue propriété true sur et définissez la Text propriété sur le texte de lien souhaité.

A DataGridViewLinkColumn est associé DataGridViewLinkCell à chaque DataGridViewRow élément qui l’croise.

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

Pour répondre aux clics de lien utilisateur, gérez l’événement DataGridView.CellContentClick . Vous pouvez également utiliser l’événement DataGridView.CellClick pour répondre aux clics n’importe où dans la cellule.

Notes pour les héritiers

Lorsque vous dérivez et ajoutez de DataGridViewLinkColumn nouvelles propriétés à la classe dérivée, veillez à remplacer la Clone() méthode pour copier les nouvelles propriétés pendant les opérations de clonage. Vous devez également appeler la méthode de la classe de Clone() base afin que les propriétés de la classe de base soient copiées dans la nouvelle cellule.

Constructeurs

Nom	Description
DataGridViewLinkColumn()	Initialise une nouvelle instance de la classe DataGridViewLinkColumn.

Propriétés

Nom	Description
ActiveLinkColor	Obtient ou définit la couleur utilisée pour afficher un lien actif dans les cellules de la colonne.
AutoSizeMode	Obtient ou définit le mode par lequel la colonne ajuste automatiquement sa largeur. (Hérité de DataGridViewColumn)
CellTemplate	Obtient ou définit le modèle utilisé pour créer de nouvelles cellules.
CellType	Obtient le type d’exécution du modèle de cellule. (Hérité de DataGridViewColumn)
ContextMenuStrip	Obtient ou définit le menu contextuel de la colonne. (Hérité de DataGridViewColumn)
DataGridView	Obtient le DataGridView contrôle associé à cet élément. (Hérité de DataGridViewElement)
DataPropertyName	Obtient ou définit le nom de la propriété de source de données ou de la colonne de base de données à laquelle la DataGridViewColumn propriété est liée. (Hérité de DataGridViewColumn)
DefaultCellStyle	Obtient ou définit le style de cellule par défaut de la colonne. (Hérité de DataGridViewColumn)
DefaultHeaderCellType	Obtient ou définit le type d’exécution de la cellule d’en-tête par défaut. (Hérité de DataGridViewBand)
Displayed	Obtient une valeur indiquant si la bande est actuellement affichée à l’écran. (Hérité de DataGridViewBand)
DisplayIndex	Obtient ou définit l’ordre d’affichage de la colonne par rapport aux colonnes actuellement affichées. (Hérité de DataGridViewColumn)
DividerWidth	Obtient ou définit la largeur, en pixels, du diviseur de colonne. (Hérité de DataGridViewColumn)
FillWeight	Obtient ou définit une valeur qui représente la largeur de la colonne lorsqu’elle est en mode de remplissage par rapport aux largeurs des autres colonnes en mode remplissage dans le contrôle. (Hérité de DataGridViewColumn)
Frozen	Obtient ou définit une valeur indiquant si une colonne se déplace lorsqu’un utilisateur fait défiler le DataGridView contrôle horizontalement. (Hérité de DataGridViewColumn)
HasDefaultCellStyle	Obtient une valeur indiquant si la DefaultCellStyle propriété a été définie. (Hérité de DataGridViewBand)
HeaderCell	Obtient ou définit l’en-tête DataGridViewColumnHeaderCell de colonne qui représente l’en-tête de colonne. (Hérité de DataGridViewColumn)
HeaderCellCore	Obtient ou définit la cellule d’en-tête du DataGridViewBand. (Hérité de DataGridViewBand)
HeaderText	Obtient ou définit le texte de légende dans la cellule d’en-tête de la colonne. (Hérité de DataGridViewColumn)
Index	Obtient la position relative de la bande dans le DataGridView contrôle. (Hérité de DataGridViewBand)
InheritedAutoSizeMode	Obtient le mode de dimensionnement en vigueur pour la colonne. (Hérité de DataGridViewColumn)
InheritedStyle	Obtient le style de cellule actuellement appliqué à la colonne. (Hérité de DataGridViewColumn)
IsDataBound	Obtient une valeur indiquant si la colonne est liée à une source de données. (Hérité de DataGridViewColumn)
IsRow	Obtient une valeur indiquant si la bande représente une ligne. (Hérité de DataGridViewBand)
LinkBehavior	Obtient ou définit une valeur qui représente le comportement des liens dans les cellules de la colonne.
LinkColor	Obtient ou définit la couleur utilisée pour afficher un lien non sélectionné dans les cellules de la colonne.
MinimumWidth	Obtient ou définit la largeur minimale, en pixels, de la colonne. (Hérité de DataGridViewColumn)
Name	Obtient ou définit le nom de la colonne. (Hérité de DataGridViewColumn)
ReadOnly	Obtient ou définit une valeur indiquant si l’utilisateur peut modifier les cellules de la colonne. (Hérité de DataGridViewColumn)
Resizable	Obtient ou définit une valeur indiquant si la colonne est redimensionnable. (Hérité de DataGridViewColumn)
Selected	Obtient ou définit une valeur indiquant si la bande est dans un état d’interface utilisateur sélectionné. (Hérité de DataGridViewBand)
Site	Obtient ou définit le site de la colonne. (Hérité de DataGridViewColumn)
SortMode	Obtient ou définit le mode de tri de la colonne. (Hérité de DataGridViewColumn)
State	Obtient l’état de l’interface utilisateur de l’élément. (Hérité de DataGridViewElement)
Tag	Obtient ou définit l’objet qui contient des données à associer à la bande. (Hérité de DataGridViewBand)
Text	Obtient ou définit le texte du lien affiché dans les cellules d’une colonne si UseColumnTextForLinkValue c’est le cas true.
ToolTipText	Obtient ou définit le texte utilisé pour les info-bulles. (Hérité de DataGridViewColumn)
TrackVisitedState	Obtient ou définit une valeur indiquant si le lien change de couleur s’il a été visité.
UseColumnTextForLinkValue	Obtient ou définit une valeur indiquant si la valeur de propriété Text est affichée en tant que texte du lien.
ValueType	Obtient ou définit le type de données des valeurs dans les cellules de la colonne. (Hérité de DataGridViewColumn)
Visible	Obtient ou définit une valeur indiquant si la colonne est visible. (Hérité de DataGridViewColumn)
VisitedLinkColor	Obtient ou définit la couleur utilisée pour afficher un lien qui a été visité précédemment.
Width	Obtient ou définit la largeur actuelle de la colonne. (Hérité de DataGridViewColumn)

Méthodes

Nom	Description
Clone()	Crée une copie exacte de cette colonne.
Dispose()	Libère toutes les ressources utilisées par le DataGridViewBand. (Hérité de DataGridViewBand)
Dispose(Boolean)	Libère les ressources non managées utilisées par les DataGridViewBand ressources gérées et libère éventuellement les ressources managées. (Hérité de DataGridViewColumn)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Calcule la largeur idéale de la colonne en fonction des critères spécifiés. (Hérité de DataGridViewColumn)
OnDataGridViewChanged()	Appelé lorsque la bande est associée à un autre DataGridView. (Hérité de DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Déclenche l’événement CellClick. (Hérité de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentClick. (Hérité de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentDoubleClick. (Hérité de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Déclenche l’événement CellValueChanged. (Hérité de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Déclenche l’événement DataError. (Hérité de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Déclenche l’événement MouseWheel. (Hérité de DataGridViewElement)
ToString()	Obtient une chaîne qui décrit la colonne.

Événements

Nom	Description
Disposed	Se produit lorsque l’objet DataGridViewColumn est supprimé. (Hérité de DataGridViewColumn)

Voir aussi

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewButtonColumn
• DataGridViewLinkCell
• SortMode
• CellContentClick
• CellClick
• UseColumnTextForLinkValue
• Text