Hyperlink property

Remarks

Specifies a connection from your program to another location: it can be an Internet URL, an E-mail address or even another program.

The hyperlink is activated when the user clicks the control using the left mouse button or using the Enter key.

Note: Do not enter E-mail addresses containing the ":" (colon) character

Get / Set functions

BSTR abmGetHyperlink (

HWND hWndBtn

);

void abmSetHyperlink (

HWND hWndBtn,

LPCTSTR strHyperlink

);

Parameters	Description
hWndBtn	Windows handle associated to the button.
strHyperlink	String that specifies the hyperlink associated to the button pressure.

Notes

If using the abmGetHyperlink function from within Visual Basic 6, remember to convert the returned value from UNICODE using the StrConv function and its related vbFromUnicode option, as in the sample below:

MsgBox StrConv(abmGetHyperlink(Command1.hwnd), vbFromUnicode)

Hyperlink property value	Effect
http://yoursite.com/index.html	The button pressure will launch the user default web browser and will open the index.html Web page located on yoursite.com Web site
http://yoursite.com/image.gif	The button pressure will launch the user default web browser and will open the image.gif image located on yoursite.com Web site
ftp://username:password@yoursite.com/img.gif	The button pressure will launch the user default web browser and will open the image.gif image located on yoursite.com Web site using the given username and password
someone@yoursite.com	The button pressure will launch the user default E-mail program and will initialise the To field to someone@yoursite.com
c:\program files\yourprogram.exe	The button pressure will launch the program yourprogram.exe located on drive c in the program files folder