DataGridViewLinkColumn.UseColumnTextForLinkValue Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Obtient ou définit une valeur indiquant si la valeur de propriété Text est affichée comme texte de lien.

public:
 property bool UseColumnTextForLinkValue { bool get(); void set(bool value); };

public bool UseColumnTextForLinkValue { get; set; }

member this.UseColumnTextForLinkValue : bool with get, set

Public Property UseColumnTextForLinkValue As Boolean

Valeur de propriété

Boolean

true si la valeur de propriété Text est affichée comme texte de lien ; false si la cellule que la valeur de propriété FormattedValue est affichée comme texte de lien. La valeur par défaut est false.

Exceptions

InvalidOperationException

La propriété CellTemplate possède la valeur null.

Exemples

L’exemple de code suivant montre comment définir cette propriété afin que la FormattedValue propriété de chaque cellule, dans ce cas l’ID d’employé du patron de l’employé, s’affiche en tant que lien texte. Après avoir sélectionné le lien, le point de sélection est déplacé vers le nom du patron. 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

L’obtention ou la définition de cette propriété obtient ou définit la UseColumnTextForLinkValue propriété de l’objet retourné par la CellTemplate propriété . La définition de cette propriété définit également la UseColumnTextForLinkValue propriété de chaque cellule de la colonne et actualise l’affichage des colonnes. Pour remplacer la valeur spécifiée pour les cellules individuelles, définissez les valeurs de cellule après avoir défini la valeur de colonne.

S’applique à