Export (0) Print
Expand All

LinkLabel.ActiveLinkColor Property

Gets or sets the color used to display an active link.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public Color ActiveLinkColor { get; set; }

Property Value

Type: System.Drawing.Color
A Color that represents the color to display an active link. The default color is specified by the system, typically this color is Color.Red.

An active link is a link that is in the process of being clicked. This is similar to the depressed state of a Button control. You can use this property to specify the color that the link is displayed in when the link is in the process of being clicked.

There are a number of colors associated with a link. The LinkColor specifies the color of all links displayed in the LinkLabel control. The VisitedLinkColor property enables you to specify the color of a link after it has been visited by the user. When a link is disabled, the DisabledLinkColor is used to display the link in a disabled state.

NoteNote:

When setting this property, ensure that the color you are setting the property to does not conflict with the color of the control's background or the text does not display properly. For example, if the background color of the control is Color.Red and this property is set to Color.Red, the text is not shown properly when the link is in the process of being clicked.

The following example demonstrates setting the LinkBehavior property using the LinkBehavior enumeration. It also demonstrates setting the ActiveLinkColor, LinkColor and LinkVisited properties. To run this sample paste it in a blank form and call InitializeLinkLabel from the form's constructor or Load method.

	// 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);
	}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft