Hyperlink controls [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{tag>category:"presentation server" }}

====== Hyperlink controls ======

=== Published 25 JUL 2013 at 12:01:23AM ===

== Updated on 23 JUL 2013 at 12:01:23AM ==

Following on from the [[http://revdevx.wordpress.com/2013/07/23/label-controls/|previous post]] on Label controls another new item we've added to OpenInsight is the Hyperlink control, which is essentially a specialized Label control that allows you to implement clickable links on your forms.

[caption id="attachment_983" align="aligncenter" width="289"][[http://revdevx.files.wordpress.com/2013/07/st_hyperlink1.png|{{16643.0009606481_1.png}}]] Hyperlink Control[/caption]

Barring HTML rendering it supports all the other properties of a Label control as well as adding a few others:

  * **AUTOUNDERLINE**
  * **LINK**
  * **LINKCURSOR**
  * **LINKRESULT**
  * **SHOWVISITED**
  * **VISITEDFORECOLOR**

==== AUTOUNDERLINE property ====

If this property is TRUE then the control ensures the text is underlined when the mouse hovers over it.

==== LINK property ====

This property contains the command string to execute when the link is (single) clicked. it can be any valid Windows command string (internally it is passed to the Windows [[http://msdn.microsoft.com/en-us/library/windows/desktop/bb762153(v=vs.85).aspx|ShellExecute]] function).

Note that that the **CLICK** and **DBLCLK** events are still fired as normal even if the **LINK** property is blank, so you still have full control over the hyperlink target.

==== LINKCURSOR property ====

This specifies the cursor to use when the mouse is over the link text.  It defaults to the standard "hand" cursor but can be set in the same way as the normal OpenInsight **CURSOR** property.

==== LINKRESULT property ====

When the command string in the **LINK** property is executed the result of the operation (as returned from the ShellExecute function) is placed in the **LINKRESULT** property for further examination if you wish (ShellExecute normally returns a value < 32 if there is a problem executing a command).

==== SHOWVISITED property ====

If this property is TRUE the link will be displayed using the **VISITEDFORECOLOR** property when it has been clicked at least once.

==== VISITEDFORECOLOR property ====

This property specifies the color to use for visited links (i.e. those that have been clicked and have a **SHOWVISITED** property of TRUE).

==== The GO method ====

The Hyperlink control also supports a new **GO** method that executes the contents of the **LINK** property as though it had been clicked.  The return value from this method is the same as the value returned in the **LINKRESULT** property.

//(Disclaimer: This article is based on preliminary information and may be subject to change in the final release version of OpenInsight 10).//


=== Comments ===





== Original ID: revdevx.wordpress.com/?p=927 ==