DataGridViewLinkColumn Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une colonne des cellules qui contiennent des liens dans un contrôle DataGridView.
public ref class DataGridViewLinkColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn
- Héritage
- Attributs
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 de l’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, comme 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 un associé DataGridViewLinkCell dans chaque DataGridViewRow qui le croise.
Le mode de tri par défaut pour ce type de colonne est NotSortable.
Pour répondre aux clics de lien de l’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 de DataGridViewLinkColumn et ajoutez de 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
DataGridViewLinkColumn() |
Initialise une nouvelle instance de la classe DataGridViewLinkColumn. |
Propriétés
ActiveLinkColor |
Obtient ou définit la couleur utilisée pour afficher un lien actif dans des cellules de la colonne. |
AutoSizeMode |
Obtient ou définit le mode qui permet à la colonne de modifier automatiquement sa largeur. (Hérité de DataGridViewColumn) |
CellTemplate |
Obtient ou définit le modèle utilisé pour créer des 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 pour la colonne. (Hérité de DataGridViewColumn) |
DataGridView |
Obtient le contrôle DataGridView 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 DataGridViewColumn est lié. (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 à l'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 séparateur de colonne. (Hérité de DataGridViewColumn) |
FillWeight |
Obtient ou définit une valeur qui représente la largeur de la colonne en mode de remplissage par rapport aux largeurs des autres colonnes en mode de remplissage contenues 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 horizontalement le contrôle DataGridView. (Hérité de DataGridViewColumn) |
HasDefaultCellStyle |
Obtient une valeur indiquant si la propriété DefaultCellStyle a été définie. (Hérité de DataGridViewBand) |
HeaderCell |
Obtient ou définit DataGridViewColumnHeaderCell 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 pour la cellule d'en-tête de la colonne. (Hérité de DataGridViewColumn) |
Index |
Obtient la position relative de la bande dans le contrôle DataGridView. (Hérité de DataGridViewBand) |
InheritedAutoSizeMode |
Obtient le mode de dimensionnement défini 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 situés dans des cellules de la colonne. |
LinkColor |
Obtient ou définit la couleur utilisée pour afficher un lien non sélectionné dans des 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 peut être redimensionnée. (Hérité de DataGridViewColumn) |
Selected |
Obtient ou définit une valeur indiquant si la bande se trouve dans un état sélectionné d'interface utilisateur. (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 d'interface utilisateur de l'élément. (Hérité de DataGridViewElement) |
Tag |
Obtient ou définit l'objet qui contient les données à associer à la bande. (Hérité de DataGridViewBand) |
Text |
Obtient ou définit le texte de lien affiché dans les cellules d'une colonne si UseColumnTextForLinkValue est |
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 comme texte de lien. |
ValueType |
Obtient ou définit le type de données des valeurs stockées dans les cellules de la colonne. (Hérité de DataGridViewColumn) |
Visible |
Obtient ou définit une valeur qui indique si la colonne est visible. (Hérité de DataGridViewColumn) |
VisitedLinkColor |
Obtient ou définit la couleur utilisée pour afficher un lien précédemment visité. |
Width |
Obtient ou définit la largeur actuelle de la colonne. (Hérité de DataGridViewColumn) |
Méthodes
Clone() |
Crée une copie exacte de cette colonne. |
Dispose() |
Libère toutes les ressources utilisées par DataGridViewBand. (Hérité de DataGridViewBand) |
Dispose(Boolean) |
Libère les ressources non managées utilisées par DataGridViewBand et libère éventuellement les ressources managées. (Hérité de DataGridViewColumn) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) |
Calcule la largeur idéale de la colonne en fonction des critères spécifiés. (Hérité de DataGridViewColumn) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
OnDataGridViewChanged() |
Appelé lorsque la bande est associée à un DataGridView différent. (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
Disposed |
Se produit lorsque DataGridViewColumn est supprimé. (Hérité de DataGridViewColumn) |