LinkLabel

Represents a label control that can display hyperlinks.

The LinkLabel control is similar to a Label 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 a full list of properties, methods and events see the API documentation.

Features

Setting the LinkArea property of the LinkLabel control specifies the portion of text that will be shown as a hyperlink to the user.

LinkLabel control with LinkArea property set to display first 4 characters as a link

The behavior of the link can be configured to use one of the preset values:

  • SystemDefault: The behavior of this setting depends on the browser.

  • AlwaysUnderline: The link always displays with underlined text.

  • HoverUnderline: The link displays underlined text only when the mouse is hovered over the link.

  • NeverUnderline: The link text is never underlined.

LinkLabel demonstrating different link behavior settings

Active Color

The LinkLabel selection color can be fully customized using the ActiveLinkColor property:

LinkLabel showing different active link color options

How To

Customize the Appearance

The LinkLabel control is fully customizable through the Font, Text, AllowHTML, and AppearanceKey properties.

Font

Like most other controls in Wisej.NET, the LinkLabel control has a Font property that allows for customization of the size, features, and style of font to use for the control.

LinkLabel with custom font settings

AllowHtml

When set to true, the LinkLabel's Text property will be interpreted as HTML content, allowing for full customization of the control.

LinkLabel with HTML content applied

Appearance Key

The AppearanceKey property of the control can be used to give the LinkLabel a custom look. This can be based off of another control already defined in the theme (i.e. button) or as an entirely new appearance defined in a mixin.

MyLinkLabel.mixin.theme
{
    "appearances": {
        "mylinklabel": {
            "inherit": "linklabel",
            "states": {
                "default": {
                    "styles": {
                        "backgroundColor": "blue"
                    }
                }
            }
        }
    }
}

Advanced

JavaScript Widget

Item
Description

Class name

"wisej.web.LinkLabel"

Theme appearance

"linklabel", inherits appearance from "textlabel". See Themes.

Child components

"linklabel" is the text container. See JavaScript.

Last updated

Was this helpful?