Ce sujet n'a pas encore été évalué - Évaluez ce sujet

LinkLabel.LinkVisited, propriété

Mise à jour : novembre 2007

Obtient ou définit une valeur indiquant si un lien doit être affiché comme s'il avait été visité.

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

public bool LinkVisited { get; set; }
/** @property */
public boolean get_LinkVisited()
/** @property */
public  void set_LinkVisited(boolean value)

public function get LinkVisited () : boolean
public function set LinkVisited (value : boolean)

Valeur de propriété

Type : System.Boolean

true si le lien doit être affiché comme s'il avait été visité ; sinon, false. La valeur par défaut est false.

Un contrôle LinkLabel ne détermine pas automatiquement qu'un lien est un lien visité. Pour afficher le lien comme lien visité, vous pouvez affecter la valeur true à cette propriété dans un gestionnaire d'événements pour l'événement LinkClicked de LinkLabel. Un lien visité est affiché avec la couleur spécifiée dans la propriété VisitedLinkColor du contrôle LinkLabel. Une fois que le formulaire contenant le contrôle LinkLabel est fermé, l'état d'affichage complet associé au lien est supprimé. Pour conserver l'état d'affichage du lien, vous devez stocker celui-ci dans un paramètre du Registre associé à votre application.

Remarque :

Cette propriété n'affecte que le premier lien défini dans le contrôle LinkLabel. Si plusieurs liens sont spécifiés dans le contrôle, utilisez la propriété Visited de la classe LinkLabel.Link. Vous pouvez accéder à tous les liens définis dans LinkLabel en utilisant la propriété Links.

L'exemple suivant illustre la définition de la propriété LinkBehavior à l'aide de l'énumération LinkBehavior. Il illustre aussi la définition des propriétés ActiveLinkColor, LinkColor et LinkVisited. Pour exécuter cet exemple, collez-le dans un formulaire vierge et appelez InitializeLinkLabel depuis le constructeur du formulaire ou la méthode Load.


	// Declare the LinkLabel object.
	internal System.Windows.Forms.LinkLabel LinkLabel1;

	// Declare keywords array to identify links
	string[] keywords;

	private void InitializeLinkLabel()
	{
		this.LinkLabel1 = new System.Windows.Forms.LinkLabel();
                this.LinkLabel1.Links.Clear();

		// Set the location, name and size.
		this.LinkLabel1.Location = new System.Drawing.Point(10, 20);
		this.LinkLabel1.Name = "CompanyLinks";
		this.LinkLabel1.Size = new System.Drawing.Size(104, 150);

		// Set the LinkBehavior property to show underline when mouse
		// hovers over the links.
		this.LinkLabel1.LinkBehavior = System.Windows.Forms.LinkBehavior.HoverUnderline;
		string textString = "For more information see our" +
			" company website or the research page at Contoso Ltd. ";

		// Set the text property.
		this.LinkLabel1.Text = textString;

		// Set the color of the links to black, unless the mouse
		// is hovering over a link.
		this.LinkLabel1.LinkColor = System.Drawing.Color.Black;
		this.LinkLabel1.ActiveLinkColor = System.Drawing.Color.Blue;

		// Associate the event-handling method with the LinkClicked
		// event.
		this.LinkLabel1.LinkClicked += 
			new LinkLabelLinkClickedEventHandler(LinkLabel1_LinkClicked);

		// Add links to the LinkCollection using starting index and
		// length of keywords.
		keywords = new string[]{"company", "research"};
		foreach ( string keyword in keywords )
		{
			this.LinkLabel1.Links.Add(textString.IndexOf(keyword), keyword.Length);
		}

		// Add the label to the form.
		this.Controls.Add(this.LinkLabel1);
	}

	private void LinkLabel1_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
	{

		string url = "";

		// Determine which link was clicked and set the appropriate url.
		switch(LinkLabel1.Links.IndexOf(e.Link))
		{
			case 0:
				url = "www.microsoft.com";

				break;
			case 1:
				url = "www.contoso.com/research";
				break;
		}

		// Set the visited property to True. This will change
		// the color of the link.
		e.Link.Visited = true;

		// Open Internet Explorer to the correct url.
		System.Diagnostics.Process.Start("IExplore.exe", url);
	}


// Declare the LinkLabel object.
private System.Windows.Forms.LinkLabel linkLabel1;

// Declare keywords array to identify links
private String keywords[];

private void InitializeLinkLabel()
{
    this.linkLabel1 = new System.Windows.Forms.LinkLabel();
    // Set the location, name and size.
    this.linkLabel1.set_Location(new System.Drawing.Point(10, 20));
    this.linkLabel1.set_Name("CompanyLinks");
    this.linkLabel1.set_Size(new System.Drawing.Size(104, 150));
    // Set the LinkBehavior property to show underline when mouse
    // hovers over the links.
    this.linkLabel1.set_LinkBehavior(
        System.Windows.Forms.LinkBehavior.HoverUnderline);
    String textString = "For more information see our" 
        + " company website or the research page at Contoso Ltd. ";
    // Set the text property.
    this.linkLabel1.set_Text(textString);
    // Set the color of the links to black, unless the mouse
    // is hovering over a link.
    this.linkLabel1.set_LinkColor(System.Drawing.Color.get_Black());
    this.linkLabel1.set_ActiveLinkColor(System.Drawing.Color.get_Blue());
    // Associate the event-handling method with the LinkClicked
    // event.
    this.linkLabel1.add_LinkClicked(new LinkLabelLinkClickedEventHandler(
        linkLabel1_LinkClicked));
    // Add links to the LinkCollection using starting index and
    // length of keywords.
    keywords = new String[] { "company", "research" };
    for (int iCtr = 0; iCtr < keywords.length; iCtr++) {
        String keyword = keywords[iCtr];
        this.linkLabel1.get_Links().Add(textString.IndexOf(keyword), 
            keyword.get_Length());
    }
    // Add the label to the form.
    this.get_Controls().Add(this.linkLabel1);
} //InitializeLinkLabel

private void linkLabel1_LinkClicked(Object sender, 
    LinkLabelLinkClickedEventArgs e)
{
    String url = "";
    // Determine which link was clicked and set the appropriate url.
    switch (linkLabel1.get_Links().IndexOf(e.get_Link())) {
        case 0:
            url = "www.microsoft.com";
            break;

        case 1:
            url = "www.contoso.com/research";
            break;
    }
    // Set the visited property to True. This will change
    // the color of the link.
    e.get_Link().set_Visited(true);
    // Open Internet Explorer to the correct url.
    System.Diagnostics.Process.Start("IExplore.exe", url);
} //linkLabel1_LinkClicked


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Cela vous a-t-il été utile ?
(1500 caractères restants)

Ajouts de la communauté

AJOUTER
© 2013 Microsoft. Tous droits réservés.