{\rtf1\ansi\ansicpg1252\deff0\deftab720{\fonttbl{\f0\fswiss MS Sans Serif;}{\f1\froman\fcharset2 Symbol;}{\f2\froman\fprq2 Times New Roman;}{\f3\froman Times New Roman;}{\f4\froman Times New Roman;}} {\colortbl\red0\green0\blue0;\red128\green0\blue0;\red0\green0\blue255;} \deflang1033\horzdoc{\*\fchars }{\*\lchars }\pard\plain\f2\fs40\cf1\b Hyperlink Classes \par \plain\f2\fs20\cf2\b\ul \par COXStaticHyperLink\plain\f2\fs20 implements a static control that's a hyperlink to any file on your desktop or web. E.g., you can use it in dialog boxes to create hyperlinks to web sites. When clicked, opens the file/URL \par \plain\f2\fs20\cf2\b\ul COXStaticHyperLink\plain\f2\fs20 is based on \plain\f2\fs20\cf2\b\ul COXStatic\plain\f2\fs20 class so you can use all its functions to define control's appearance the way you want. Of course there were added some new features to provide functionality that similar to hyper link on web page. \par Every \plain\f2\fs20\cf2\b\ul COXStaticHyperLink\plain\f2\fs20 have associated \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 that will be executed if user clicks mouse left button when it's over control's window. By default \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 operation is set to "open". \par \par \plain\f2\fs20\cf2\b\ul COXStaticHyperLink\plain\f2\fs20 could be in two state: unvisited and visited (like common hyperlink). Control's state changes in result of user action (left button click) but you can change it programmatically too. \par \par To differentiate \plain\f2\fs20\cf2\b\ul COXStaticHyperLink\plain\f2\fs20 from other CStatic controls we use special cursor. By default we use "hand cursor" that could be found in "OXBitmapButton.rc" file (supplied with the Ultimate Toolbox). So, you have to include reference to "OXBitmapButton.rc" resource in the resource file of your application. Of course you can set whatever cursor you need \par \par To simplify process of using \plain\f2\fs20\cf2\b\ul COXStaticHyperLink\plain\f2\fs20 object you can use window text as \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 ::m_sFile. \par \par At the moment 6 type of actions are defined: \par \pard\li720\fi-360\plain\f2\fs20\b 1.\tab None\plain\f2\fs20 - use this type if you need functionality this control provide but don't want to invoke any action if user clicks on the control. \par \par \plain\f2\fs20\b 2.\tab Userdefined\plain\f2\fs20 - use this type if you want to define your own action that should be taken when a hyperlink is activated. In that case you have to set callback message ID and handle to the recipient window to the corresponding \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 object. In your application you have to define unique message ID. \par \par \plain\f2\fs20\b 3.\tab Open\plain\f2\fs20 - use this type if you want to open the file specified by the \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 ::m_sFile parameter. The file can be an executable file, shortcut or document file. It can also be a folder. Use this action if you want to open the website specified by m_sFile. Use this action if you want to send an e-mail: you can do that setting m_sFile to \plain\f2\fs20\cf2\ul "mailto:address@you.need"\plain\f2\fs20 . \par \par \plain\f2\fs20\b 4.\tab Print\plain\f2\fs20 - use this type if you want to print the file specified by the \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 ::m_sFile parameter. The file should be a document file. \par \plain\f2\fs20\b \par 5.\tab Explore\plain\f2\fs20 - use this type if you want to explore the folder specified by the \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 ::m_sFile parameter. \par \par \plain\f2\fs20\b 6.\tab Email \plain\f2\fs20 - use this type if you want to send a message to a recipient specified by the \plain\f2\fs20\cf2\b\ul COXHyperLinkAction\plain\f2\fs20 ::m_sFile parameter. Defined only for convinience purposes, eventually calls Open action. \par \par \plain\f3\fs20 \par }