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="http://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.
Build date: 8/13/2009
© 2009 Microsoft Corporation. All rights reserved.