Hyperlink Control

The Hyperlink control displays a HTML link to an address, which opens in the default browser for the computer. Links are not supported for protocols other than HTML.

Windows Installer 4.5 or earlier: Not supported. This Control is available beginning with Windows Installer 5.0.

The Text value of the HyperLink control uses the anchor <a> tag and the HREF attribute value to specify the URL and displayed text of the link.

<a href="https://www.blueyonderairlines.com">Blue Yonder Airlines</a>

Control Attributes

You can use the following attributes with the Hyperlink control. To change the value of an attribute using an event, subscribe the control to a ControlEvent in the EventMapping table and list the attribute's identifier in the Attribute column. Enter the identifier of the ControlEvent in the Event column.

Attribute identifier Hexadecimal bit Description
Position Position of control in the dialog box. Enter the control's width, height, and coordinates of the control's left corner into the Width, Height, X, and Y columns of the Control table or BBControl table. Use installer units for length and distance.
Text Text displayed by the control. To set the font and font style of a text string, prefix the string of displayed characters with {\style} or {&style}. Where style is an identifier listed in the TextStyle column of the TextStyle table. If neither of these are present, but the DefaultUIFont property is defined as a valid text style, that font will be used. The text value will also resolve [Property] to the referenced property.
Visible 0x00000000 0x00000001
Hidden control. Visible control.
Include this bit in the bit word of the Attributes column in the Control table or BBControl table.to make the control visible or hidden upon its creation.
You can also hide or show a control by using the ControlCondition table.
Enabled 0x00000000 0x00000002
Control in a disabled state. Control in an enabled state.
Include this bit in the bit word in the Attributes column of the Control or BBControl tables to enable the control on creation.
You can also enable or disable a control by using the ControlCondition table.
Sunken 0x00000000 0x00000004
Displays the default visual style. Displays the control with a sunken, 3-D, look.
Include these bits in the bit word in the Attributes column of the Control table.
Transparent 0x00000000 0x00010000
Opaque control. Background shows through control. The control has the WS_EX_TRANSPARENT style.
Include this bit in the Attributes column of the Control or BBControl tables.

 

Remarks

This control can be created from the WC_LINK class by using the CreateWindowEx function. It has the WS_CHILD, WS_TABSTOP and WS_GROUP styles.

Do not place transparent Text controls on top of colored bitmaps. The text may not be visible if the user changes the display color scheme. For example, text may become invisible if the user sets the high contrast parameter for accessibility reasons.

If the text in the control is longer than the control width, the text wraps or truncates, depending on whether the height is sufficient to fit the wrapped text.