\HHypertext Capabilities\h

    In addition to formatted text display, the cshypertext control, as its name implies, also supports hypertext functionality. Any word or phrase can be defined as either a jump or hotspot. Jumps and hotspots are borrowed from the terminology used by the Windows help system. Typically, jump text implies movement to another screen of information while a hotspot brings up a temorary window of text without changing the context of the control.
Jumps and popups are created in the text using the same sort of escape codes used to format text. There are three additional codes: J, P and K.

\\J, \\j	Jump. Formats the text as a jumpPopup_Jump, and fires a _Jump event when the user clicks on it.

\\K, \\k	Key. Text between \\K and \\k will not be displayed. This	attribute can be used to hide internal jump or popup topic information (see examples below). It must appear immediately after \\J or \\P. This text is passed as the Key parameter to the JumpTopic_Jump and PopupTopic_Popup events.

\\P, \\p	Popup. Formats the text as a popupPopup_Popup, and fires a _Popup event when the user clicks on it.

A \\J\\K1234\\kjump\\j sample.	A \C00FF00\Ujump\c\u sample.

In the last example, a "key" (the string "1234") is included in the jump text. The key text is passed as the Key parameter of the _Jump event, and contains information that the user doesn't see. This can be useful if you want to index your jump topics by some means other than the visible text.

Jumps and hotspots are displayed in cshypertext in the same way they are displayed in help files facilitating a recognizable interface for your users. Using the HotSpotColors property, you can choose to use the color scheme of the help engine, the Multimedia Viewer or to set your own custom colors for jumps and popups.

In the Windows help engine a pointing hand is displayed whenever the cursor is over a jump or hotspot. This is the default behavior of cshypertext. However, it is also possible to set a custom cursor for jumps and popups using the JumpCursor and PopupCursor properties.
When the user clicks on either a jump or popup, the Jump or Popup event is fired. The text, or caption, is passed as well as the embedded key string if one was defined for this particular hotspot.

\HEscape Codes\h

    Text may be displayed with any combination of font attributes by using escape codes. Escape codes are also used to switch between base and heading fonts.

    Escape codes consist of a backslash character ('\\') followed by a single character indicating the attribute. An uppercase letter used for an attribute indicates that it should be enabled, while a lowercase letter indicates that it should be disabled. An escape code takes effect immediately, affecting all text following it.
Note	To display a single backslash character in the text, you must use two in succession ('\\\\').

\BEscape Codes\b
\\B, \\b	Bold. Enables/disables the Bold font attribute
\\C, \\c	Color. \\C must be followed by a 6 digit hexadecimal value
\\H, \\h	Font switch. \\H switches to the heading font
\\I, \\i	Italic. Enables/disables the Italic font attribute
\\S, \\s	Strikethru. Enables/disables the Strikethru font attribute
\\U, \\u	Underline. Enables/disables the Underline font attribute

Here are a few samples:
A \\Bbold\\b word.	A \Bbold\b word.
Some \\B\\Ibold\\b with italics\\i.	Some \B\Ibold\b with italics\i.
A \\C0000FFcolor\\c example.	A \C0000FFcolor\c example.

\HCSHyperText\h
custom control contained in CSHT.VBX

\BPurpose:\b
The CSHypertext control is a replacement for the standard VB label with a number of additional features including \J\KDEMO2\kformatted text\j, scrolling and \J\KDEMO3\khypertext\j capabilities.

\BObjectType:\b
CSHyperText

\BOverview:\b
At its most fundamental level, the csHypertext control is a label that provides support for text formatting including attributes, colors, tabs and headlines. In addition, the control supports scrolling when text exceeds the display area. However, the csHypertext control goes much further by providing sophisticated hypertext capability in an easy to use interface.

\BProperties:\b
AutoSize	Label sizes to text when True
BackColor	Standard Property
BorderStyle	Standard Property
DataField	Standard Property
DataSource	Standard Property
DragIcon	Standard Property
DragMode	Standard Property
DrawFocusRect	Draw a rectangle around the control when it has focus
Enabled	Standard Property
FontBold	Standard Property
FontItalic	Standard Property
FontName	Standard Property
FontSize	Standard Property
FontStrikethru	Standard Property
FontUnderline	Standard Property
ForeColor	Standard Property
HeadingBold	Specifies bold type for heading font style
HeadingColor	Specifies color of type for heading font style
HeadingItalic	Specifies italic type for heading font style
HeadingSize	Specifies size of type for heading font style
HeadingStrikethru	Specifies strike through type for heading font style
HeadingUnderline	Specifies underline type for heading font style
Height	Standard Property
HelpContextID	Standard Property
HotspotColors	Specifies which color scheme is used to display hotspots
hWnd	Standard Property
Index	Standard Property
JumpColor	custom jump color if HotspotColors = 2
JumpCursor	specifies custom cursor over jumps, default like winhelp
Left	Standard Property
Name	Standard Property
NormalCursor	specifies custom cursor over normal portion of the control
Parent	Standard Property
PopupColor	custom popup color if HotspotColors = 2
PopupCursor	specifies custom cursor over popups, default like winhelp
RawText	returns the text of the control with formatting codes stripped out
TabIndex	Standard Property
TabStop	Standard Property
TabWidth	specifies the width in characters of tab columns
Tag	Standard Property
Text	Standard Property
Top	Standard Property
Visible	Standard Property
Width	Standard Property
WordWrap	Standard Property

\HFormatted Text\h

    Similar to a label control, the csHypertext control provides word wrapping of text. In addition, cshypertext allows for scrolling of larger text, making it ideal as a miniature browser. Text size is limited to 32k.
	
    Buiding on the functionality of a standard label, the cshypertext control allows you to display formatted text mixing \P\KDEMO4\kfont attributes\p and colors. Text is displayed in a single font, although you may use 2 different sizes and modify font attributes on the fly.
	
    Two different initial font characteristics can be specified: the base font and the Heading font. Base and heading fonts cannot be used on the same line.
	
    The base font is set using the familiar font properties (FontName, FontSize, etc.). The heading font is set using properties whose names begin with "Heading". There is a corresponding Heading property for each standard property except for FontName in other words, the heading font has the same typeface as the base font.

    Text may be displayed with any combination of font attributes by using \J\KDEMO5\kescape codes\j. Escape codes are also used to switch between base and heading fonts.
