Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

LinkArea structure

 

Date de publication : novembre 2016

Représente une zone dans un LinkLabel contrôle qui représente un lien hypertexte dans le contrôle.

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

[SerializableAttribute]
[TypeConverterAttribute(typeof(LinkArea.LinkAreaConverter))]
public struct LinkArea

NomDescription
System_CAPS_pubmethodLinkArea(Int32, Int32)

Initialise une nouvelle instance de la classe LinkArea.

NomDescription
System_CAPS_pubpropertyIsEmpty

Obtient une valeur indiquant si la LinkArea est vide.

System_CAPS_pubpropertyLength

Obtient ou définit le nombre de caractères dans la zone de lien.

System_CAPS_pubpropertyStart

Obtient ou définit l’emplacement de départ de la zone de lien dans le texte de la LinkLabel.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si cette LinkArea est égal à l’objet spécifié.(Remplace ValueType.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage de cette instance.(Remplace ValueType.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne le nom de type qualifié complet de cette instance.(Remplace ValueType.ToString().)

NomDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(LinkArea, LinkArea)

Retourne une valeur indiquant si deux instances de la classe LinkArea sont égales.

System_CAPS_puboperatorSystem_CAPS_staticInequality(LinkArea, LinkArea)

Retourne une valeur indiquant si deux instances de la classe LinkArea ne sont pas égales.

Il existe deux façons d’ajouter un lien hypertexte au texte d’un LinkLabel contrôle. Vous pouvez accéder à la Add méthode du LinkLabel.LinkCollection par le biais du Links propriété de la LinkLabel pour ajouter plusieurs liens hypertexte au texte du contrôle. Si vous devez uniquement ajouter un lien hypertexte au texte du contrôle, vous pouvez utiliser le LinkArea propriété de la LinkLabel. Cette propriété accepte un LinkArea qui définit l’emplacement du lien hypertexte dans le texte du contrôle. Lorsqu’un lien hypertexte est spécifié à l’aide de la LinkArea propriété, la zone de lien est ensuite ajoutée à la LinkLabel.LinkCollection de la même manière que l’ajout de la liaison à l’aide la Add Procédé de la LinkLabel.LinkCollection.

Le Length propriété spécifie le nombre de caractères dans le texte de la LinkLabel à inclure dans la zone de lien. Le Start propriété spécifie le premier caractère du texte de contrôle à inclure dans le lien hypertexte. Si vous souhaitez déterminer si un spécifique LinkArea est vide, vous pouvez utiliser le IsEmpty au lieu de vérifier les valeurs de propriété de la Start et Length Propriétés.

L’exemple de code suivant montre comment utiliser la LinkLabel classe, avec plusieurs LinkArea sections définies, pour afficher une étiquette sur un formulaire. Montre comment définir le AutoSize, LinkBehavior, DisabledLinkColor, LinkColor, et VisitedLinkColor Propriétés pour personnaliser l’apparence de la LinkLabel. Le premier LinkArea est spécifié en utilisant le LinkLabel.LinkArea propriété. Des liens supplémentaires sont ajoutés à la LinkLabel à l’aide de la LinkLabel.LinkCollection.Add méthode. L’exemple gère le LinkClicked événements en démarrant le navigateur Web pour les liens hypertexte et en affichant un MessageBox pour d’autres liens.

using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private System.Windows.Forms.LinkLabel linkLabel1;

    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        // Create the LinkLabel.
        this.linkLabel1 = new System.Windows.Forms.LinkLabel();

        // Configure the LinkLabel's size and location. Specify that the
        // size should be automatically determined by the content.
        this.linkLabel1.Location = new System.Drawing.Point(34, 56);
        this.linkLabel1.Size = new System.Drawing.Size(224, 16);
        this.linkLabel1.AutoSize = true;

        // Configure the appearance. 
        // Set the DisabledLinkColor so that a disabled link will show up against the form's background.
        this.linkLabel1.DisabledLinkColor = System.Drawing.Color.Red;
        this.linkLabel1.VisitedLinkColor = System.Drawing.Color.Blue;
        this.linkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline;
        this.linkLabel1.LinkColor = System.Drawing.Color.Navy;

        this.linkLabel1.TabIndex = 0;
        this.linkLabel1.TabStop = true;


        // Add an event handler to do something when the links are clicked.
        this.linkLabel1.LinkClicked += new System.Windows.Forms.LinkLabelLinkClickedEventHandler(this.linkLabel1_LinkClicked);

        // Identify what the first Link is.
        this.linkLabel1.LinkArea = new System.Windows.Forms.LinkArea(0, 8);

        // Identify that the first link is visited already.
        this.linkLabel1.Links[0].Visited = true;

        // Set the Text property to a string.
        this.linkLabel1.Text = "Register Online.  Visit Microsoft.  Visit MSN.";

        // Create new links using the Add method of the LinkCollection class.
        // Underline the appropriate words in the LinkLabel's Text property.
        // The words 'Register', 'Microsoft', and 'MSN' will 
        // all be underlined and behave as hyperlinks.

        // First check that the Text property is long enough to accommodate
        // the desired hyperlinked areas.  If it's not, don't add hyperlinks.
        if(this.linkLabel1.Text.Length >= 45)
        {
            this.linkLabel1.Links[0].LinkData = "Register";
            this.linkLabel1.Links.Add(24, 9, "www.microsoft.com");
            this.linkLabel1.Links.Add(42, 3, "www.msn.com");
        //  The second link is disabled and will appear as red.
            this.linkLabel1.Links[1].Enabled = false;
        }

        // Set up how the form should be displayed and add the controls to the form.
        this.ClientSize = new System.Drawing.Size(292, 266);
        this.Controls.AddRange(new System.Windows.Forms.Control[] {this.linkLabel1});
        this.Text = "Link Label Example";
    }

    private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)
    {
        // Determine which link was clicked within the LinkLabel.
        this.linkLabel1.Links[linkLabel1.Links.IndexOf(e.Link)].Visited = true;

        // Display the appropriate link based on the value of the 
        // LinkData property of the Link object.
        string target = e.Link.LinkData as string;

        // If the value looks like a URL, navigate to it.
        // Otherwise, display it in a message box.
        if(null != target && target.StartsWith("www"))
        {
            System.Diagnostics.Process.Start(target);
        }
        else
        {    
            MessageBox.Show("Item clicked: " + target);
        }
    }
}

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: