System.Windows.Forms
1.0.5000.0
2.0.0.0
System.Windows.Forms.Label
System.Windows.Forms.IButtonControl
System.ComponentModel.ToolboxItem("System.Windows.Forms.Design.AutoSizeToolboxItem,System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")
System.Runtime.InteropServices.ComVisible(true)
System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)
System.ComponentModel.DefaultEvent("LinkClicked")
The control replaces and adds functionality to the and controls. However, the and controls are retained for both backward compatibility and future use, if you choose.
The control is similar to a control with the exception that it can display a hyperlink. Multiple hyperlinks can be specified in the text of the control. Each hyperlink can perform a different task within an application. For example, you can use a hyperlink to display a Web site in Microsoft Internet Explorer or to load a log file associated with an application.
Each hyperlink displayed in the control is an instance of the class. The class defines display information, state, and location of the hyperlink. In addition, the property of the class enables you to associate information, such as a URL to display, with the hyperlink. When a user clicks a hyperlink within the control, the event is raised, and the object representing the hyperlink that was clicked is passed as part of the object that is passed as a parameter to the event handler. You can use this object to obtain the object associated with the hyperlink that was clicked by the user. All hyperlinks contained within the control are stored in the class instance for the control.
There are two ways to add a hyperlink to the control. The quickest way is to specify a and assign it to the property. This enables you to specify a single hyperlink within the text of the control. To add multiple hyperlinks, you can use the method of the class by accessing the collection through the property.
When a control is created, a default hyperlink that contains all the text within the control is added to the . You can override this default link by specifying a new link area with the property, or specify a link using the method of the . You can also remove the default hyperlink by using the method of the class.
The property is true by default, as long as there is at least one link of greater than zero length in the collection. The control has a single value. However, each link of greater than zero length gets its own tab stop, in left-to-right order. To prevent tab navigation to the control, set the property to false. However, be aware that adding new links to the collection will automatically set the property to true again.
The provides a number of properties that enable you to define the display appearance of hyperlinks in the control. The , , , and properties define the colors used when displaying a hyperlink in various states. The property defines the display of the underline that is associated with a hyperlink.
Represents a Windows label control that can display hyperlinks.
Constructor
To be added.
Initializes a new default instance of the class.
1.0.5000.0
2.0.0.0
Property
System.Drawing.Color
To be added.
An active link is a link that is in the process of being clicked. This is similar to the depressed state of a 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 specifies the color of all links displayed in the control. The property enables you to specify the color of a link after it has been visited by the user. When a link is disabled, the is used to display the link in a disabled state.
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.
Gets or sets the color used to display an active link.
1.0.5000.0
2.0.0.0
Method
System.Windows.Forms.AccessibleObject
If you do not explicitly call the method, it will be called when the property is referenced.
Note: To get or set the property, you must add a reference to the Accessibility assembly installed with the .NET Framework.
Notes to Inheritors: When overriding in a derived class, you should not call the base class's method.
Creates a new accessibility object for the control.
A new for the control.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Creates a handle for this control. This method is called by the .NET Framework, this should not be called. Inheriting classes should always call base.createHandle when overriding this method.
1.0.5000.0
2.0.0.0
Property
System.Drawing.Color
To be added.
This property enables you to specify the color for links that are disabled in the . Disabled links do not cause the event to be raised.
There are a number of colors associated with a link. All links in the are initially displayed with the color defined in the property. The property enables you to specify the color of the link when it is in the process of being clicked. The property enables you to specify the color of a link after it has been visited by the user.
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 disabled.
Gets or sets the color used when displaying a disabled link.
1.0.5000.0
2.0.0.0
Property
1.0.5000.0
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)
System.ComponentModel.Browsable(false)
System.Windows.Forms.FlatStyle
To be added.
This property is not relevant to this class.
Gets or sets the flat style appearance of the .
Property
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
System.ComponentModel.Editor("System.Windows.Forms.Design.LinkAreaEditor, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a", typeof(System.Drawing.Design.UITypeEditor))
System.ComponentModel.Localizable(true)
System.Windows.Forms.LinkArea
To be added.
The property provides a quick way to specify a single hyperlink to display in the text of the control. The object provides properties that specify the starting position of the link within the text of the control and the length of text for the hyperlink. When a hyperlink is specified using the property, the hyperlink is added to the of the control. The property converts the object assigned to it to a object that is stored within the collection.
To add multiple hyperlinks to the text of the control, you can use the property. The property enables you to access the properties and methods of the , which stores the links specified for the control. This method of adding links to the also enables you to specify data in the property that is associated with the link being created. The value of the property can be used to store the location of a file to display or the address of a Web site.
When a control is created, a default hyperlink that contains all the text within the control is added to the . You can override this default link by specifying a new link area with the property, or specify a link using the method of the . You can also remove the default hyperlink by using the method of the class.
The property always returns the first item in the , regardless of how the hyperlink was added to the collection.
The property on will differ if you call , and the property contains double-byte characters. If you call , it will return the number of bytes in the string. Otherwise, it will return the number of actual characters.
Gets or sets the range in the text to treat as a link.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DefaultValue(System.Windows.Forms.LinkBehavior.SystemDefault)
System.Windows.Forms.LinkBehavior
To be added.
This property enables you to specify the behavior of links when they are displayed in the control. For example, if you want links to be displayed with an underline only when the mouse pointer is over a link, you can set this property to LinkBehavior.HoverUnderline. For more information on the types of behaviors that can be associated with a link, see .
Gets or sets a value that represents the behavior of a link.
1.0.5000.0
2.0.0.0
Event
System.Windows.Forms.LinkLabelLinkClickedEventHandler
Typically, the event is handled to perform tasks when the user clicks on a link in the control. The event handler for the event is passed an instance of the class that contains a object that is associated with the link that was clicked. You can use information specified in the property of class to determine which link was clicked or what type of task to perform when the link is clicked. For example, if a control has a object defined with its property set to the string www.microsoft.com, you can use this information in an event handler for the event to display the Web site.
For more information about handling events, see Consuming Events.
Occurs when a link is clicked within the control.
1.0.5000.0
2.0.0.0
Property
System.Drawing.Color
To be added.
This property enables you to specify the color that is initially displayed for all links in the .
There are a number of colors associated with a link. The property enables you to specify the color of the link when it is in the process of being clicked. The property enables you to specify the color of a link after it has been visited by the user. When a link is disabled, the is used to display the link in a disabled state.
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 of the link is not shown properly.
Gets or sets the color used when displaying a normal link.
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
System.ComponentModel.Browsable(false)
System.Windows.Forms.LinkLabel+LinkCollection
To be added.
A control can display any number of links within the text of the control. This property enables you to access the instance associated with the that represents the collection of links displayed in the control. You can then use the members of the class to add, remove, and find links in the collection. For more information on the types of tasks you can perform with the link collection, see .
When a control is created, a default hyperlink that contains all the text within the control is added to the . You can override this default link by specifying a new link area with the property, or specify a link using the method of the . You can also remove the default hyperlink by using the method of the class.
If you do not need to specify more than one link to display within the , you can use the property.
Gets the collection of links contained within the .
1.0.5000.0
2.0.0.0
Property
System.ComponentModel.DefaultValue(false)
System.Boolean
To be added.
A control does not automatically denote that a link is a visited link. To display the link as a visited link, you can set the value of this property to true in an event handler for the event of a . A visited link is displayed using the color specified in the property of the control. Once the form containing the control is closed, the "all display" state associated with the link is deleted. In order to retain the display state of the link, you need to store the display state of the link in a registry setting associated with your application.
This property only affects the first link defined in the control. If you have more than one link specified in the control, use the property of the class. You can access all the links defined in the by using the property.
Gets or sets a value indicating whether a link should be displayed as though it were visited.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
An that contains the event data.
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Provides handling for the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
2.0.0.0
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
The method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Raises the event.
An that contains the event data.
Method
System.Void
Raising an event invokes the event handler through a delegate. For more information, see Raising an Event.
Raises the event.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Paints the background of the control.
A that contains the event data.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
Provides handling for the event.
An that contains the event data.
1.0.5000.0
2.0.0.0
Property
System.Windows.Forms.Cursor
To be added.
To be added.
Gets or sets the mouse pointer to use when the mouse pointer is within the bounds of the .
1.0.5000.0
2.0.0.0
Property
2.0.0.0
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
System.Windows.Forms.Padding
To be added.
To be added.
Gets or sets the interior spacing, in pixels, between the edges of a and its contents.
Method
System.Windows.Forms.LinkLabel+Link
This method enables you to determine whether a link is located at a specific point within a control. You can use this method in an event handler for the event of the control to determine whether the mouse pointer is hovering over a link in the control. Once you have determined that the mouse pointer is over a link, you can then display additional information about the link to the user through text or a .
Gets the link located at the specified client coordinates.
A representing the link located at the specified coordinates. If the point does not contain a link, null is returned.
The horizontal coordinate of the point to search for a link.
The vertical coordinate of the point to search for a link.
1.0.5000.0
2.0.0.0
Method
System.Boolean
This method is called during message pre-processing to handle dialog characters, such as TAB, RETURN, ESCAPE, and arrow keys. This method is called only if the isInputKey method indicates that the control isn't interested in the key. processDialogKey simply sends the character to the parent's processDialogKey method, or returns false if the control has no parent. The Form class overrides this method to perform actual processing of dialog keys. When overriding processDialogKey, a control should return true to indicate that it has processed the key. For keys that aren't processed by the control, the result of base.processDialogChar should be returned. Controls will seldom, if ever, need to override this method.
Processes a dialog key.
true to consume the key; false to allow further processing.
Key code and modifier flags.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0
Method
System.Void
Inheriting classes can override this function to add size restrictions. Inheriting classes must call base.setBoundsCore to actually cause the bounds of the control to change.
Performs the work of setting the bounds of this control.
New left of the control.
New right of the control.
New width of the control.
New height of the control.
Which values were specified. This parameter reflects user intent, not which values have changed.
1.0.5000.0
2.0.0.0
Property
1.0.5000.0
2.0.0.0
System.Windows.Forms.DialogResult
To be added.
This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.
For a description of this member, see .
Method
1.0.5000.0
2.0.0.0
System.Void
A control appears the same regardless of whether it is the default button, so calling this method will not change the appearance or behavior of the .
Notifies the control that it is the default button.
true if the control should behave as a default button; otherwise, false.
Method
1.0.5000.0
2.0.0.0
System.Void
Calling this method causes the first link in the to be clicked.
Generates a event for the control.
Event
2.0.0.0
System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Always)
System.ComponentModel.Browsable(true)
System.EventHandler
For more information about handling events, see Consuming Events.
Occurs when the value of the property changes.
Property
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
System.String
To be added.
To be added.
Gets or sets the text displayed by the .
1.0.5000.0
2.0.0.0
Property
System.Boolean
To be added.
If the property is set to false, the covers the entire text. For example, text such as "abcd " is rendered with the trailing space underlined.
If the property is set to true, the does not cover the entire text.
The UseCompatibleTextRendering property is intended to provide visual compatibility between Windows Forms controls that render text using the class and net_v10_short and net_v11_short applications that perform custom text rendering using the class. In most cases, if your application is not being upgraded from net_v10_short or net_v11_short, it is recommended that you leave UseCompatibleTextRendering set to the default value of false.
The ndptecgdi based class was introduced in the dnprdnlong to improve performance, make text look better, and improve support for international fonts. In earlier versions of the dnprdnshort, the ndptecgdiplus based class was used to perform all text rendering. ndptecgdi calculates character spacing and word wrapping differently from ndptecgdiplus. In a Windows Forms application that uses the class to render text, this could cause the text for controls that use to appear different from the other text in the application. To resolve this incompatibility, you can set the UseCompatibleTextRendering property to true for a specific control. To set UseCompatibleTextRendering to true for all supported controls in the application, call the method with a parameter of true.
Gets or sets a value that determines whether to use the class (ndptecgdiplus) or the class (ndptecgdi) to render text.
2.0.0.0
System.ComponentModel.RefreshProperties(System.ComponentModel.RefreshProperties.Repaint)
Property
System.Drawing.Color
To be added.
This property enables you to specify the color that is displayed for all links in the LinkLabel that have been visited by the user.
There are a number of colors associated with a link. All links in the are initially displayed with the color defined in the property. The property enables you to specify the color of the link when it is in the process of being clicked. When a link is disabled, the is used to display the link in a disabled state.
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 displayed as a visited link.
Gets or sets the color used when displaying a link that that has been previously visited.
1.0.5000.0
2.0.0.0
Method
System.Void
To be added.
To be added.
To be added.
1.0.5000.0
2.0.0.0