many concepts relating to Windows Help including:\par
\par
\li816\fi-456 \ATXnt1 BULLET1.BMP\ATXnt0 Various design ideas for Help Topics\par
\li0\fi0 \par
\li816\fi-456 \ATXnt2 BULLET1.BMP\ATXnt0 Basic elements of Windows help including help wind
ows, non-scrolling regions, formatting help text, formatting paragraphs, hypertext links, graphics, multimedia audio and video, browse sequences, and more\par
\li0\fi0 \par
\li816\fi-456 \ATXnt3 BULLET1.BMP\ATXnt0 Advanced elements of Windows Help in
cluding macro programming, standard and customized buttons, authorable buttons, shortcut buttons, and more\par
\par
\li0\fi0 \par
We include this demonstration file and its source file (demo95.hlx) with Help Magician Pro 95 in the directory \\DEMO95.
Feel free to disect this file within Help Magician to learn how some of these ideas are implemented.\par
[ETX]
[EHT]
[PK]
051513040003
[EPK]
[PT]
Types of Help Topics
[EPT]
[KW4]
KTypes of Help Topics000003;
[EKW4]
[MC]
M
[EMC]
[J3]
01410005000200001
[EJ3]
[P3]
0141000400001000101410006000010002
[EP3]
[MT]
[EMT]
[PG]
001002
[EPG]
[BI]
[EBI]
[CN]
3
[ECN]
[CS]
Types_of_Help_Topics
[ECS]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw11124 \margr0\margl0 \plain \fs20 \ATXts720\qc\ATXpt2\sl240 \f1 \fs28 \cf4 Types of Help Topics\par
\ql\ATXpt0 \fs20 \cf0 \par
As a help author, there are many w
ays that you can structure your help topics. Remember that each "page" in Help Magician is a different topic, no matter what it's function is. You have control over the look and function of each topic page. You can optionally define which window a top
ic page will be shown in. Within each topic page, you can define its title, context id number, context string, and keywords. Below is a listing of the types of help topics used in help authoring.\par
\par
\par
\li2880\fi-2880 \b \ATXul3074 \cf2 \ATXht10001 Definition Topic\b0 \ATXul0 \cf0 \ATXht0 A topic that is the destination of a popup that usually contains a definition of a word. It could also serve as the definition of a word contained in a glossary.\par
\par
\b \ATXul1026 \cf2 \ATXht1 Gloss
ary\b0 \ATXul0 \cf0 \ATXht0 A topic that contains a glossary consisting of a non-scrolling region with buttons a-z and a close button. The scrolling region contains words in alphabetical order with popup links to other help topics containing the actual
definitions. The glossary topic is usually displayed in its own secondary window. Help Magician Pro has a glossary wizard that generates a complete glossary template in a few mouse clicks.\par
\par
\b \ATXul3074 \cf2 \ATXht10002 What's This? Topic
\b0 \ATXul0 \cf0 \ATXht0 A topic that has a short description of a dialog box control, toolbar button, or menu item within an application. Depending how it is programmed, a What's This? help could be invoked by right clicking the mouse on the element of
interest and a What's This? command appears. When the user clicks on the What's This? command, a unique context id number is passed from the application to WinHelp. WinHelp displays the help topic in a small popup window.\par
\li0\fi0 \par
\li2880\fi-2880 \b Procedure Topic\b0 Procedure Topics are the most prevalent form of help. They serve the central role in documentation: explaining the purpose of tasks, how to carry them out, and what the special issues are. They may contain a topic heading, a d
escriptive conceptual paragraph, a subheading, the steps to carry out a specific task, and additional notes.\par
\par
\b Command Topic\b0 A Command Topic provides a functional description of a command and its dialog box elements. It is similar to Wha
t's This? except it provides help for all the elements of a dialog box on one topic page. A Command Topic could be displayed when the user hits the F1 key while inside a dialog box, or by pressing a Help button in a dialog box. The link from the applic
ation to the Command Topic is usually done through the Context ID number passed to WinHelp.\par
\par
\b List Topic\b0 A List Topic basically contains a list of jumps to other Help topics. Many help systems use List Topics as a form of navigation. So
me List Topics contain a paragraph above the list of jumps, hence they are hybrids of Overview and List Topics. By indenting List Topics, it is possible to show a hierarchy within a help system. \par
\par
\b Overview Topic\b0 An Overview Topic is a t
ype of topic that explains conceptual knowledge about a specific task or group of procedural topics. It may contain a jump to another topic showing an example of a concept.\par
\par
\b Screen Region Topic\b0 A Screen Region Topic consists mainly of a
graphic of a major interface element such as an application's main workspace, a tool palette, a dialog box, or a toolbar. Typically, this graphic is composed of multiple hotspots, each of which, when clicked, displays a pop-up that identifies and explai
ns a particular command button, check box, or other similar interface element on the major one. By using a Screen Region Topic, hotspots on each of the main menu elements, and picture of each of the menu options on a separate popup topic page, it is pos
sible to simulate a menu being pulled down on a main window, with help for each of the menu elements.\par
\par
\b Keyboard Shortcut Topic\b0 A Keyboard Shortcut Topic is a topic that contains a list of keyboard shortcuts for specific tasks associated
with an application. Shortcut Topics can be organized into function groups, depending on the complexity and number of keyboard shortcuts.\par
\par
\b Error Message Topic\b0 When error-message topics are included in Help, they generally supplement the
system messages that appear in message boxes within the application's interface. An application would generate a messagebox containing an error message, an OK button, and a Help button.\par
\par
\b Troubleshooting Topics\b0 Troubleshooting Topics le
ad the user through a set of diagnostic and/or recommendation topics to help the user through a troubleshooting situation. The topic may start out with a general diagnostic, lead to a specific diagnostic, then finally to a recommendation or hints/sugges
This section will familiarize you with the basic elements of Windows Help. Click on the section
you want to know more about.\par
\par
\par
\pard\tx1200\ATXts720\li720\sl240\ATXbrdr0 \ATXnt1 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht1 Help Windows\ATXul0 \cf0 \ATXht0 - Where do you want to display your help topics\par
\par
\ATXnt2 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht2 Screen Layout\ATXul0 \cf0 \ATXht0 - Formatting ideas for your help topics\par
\li3240\fi-2520 \b Main Windows\b0 Many of the help topics displayed in WinHelp goes into the ma
in window. The main window is the window that you see this text displayed in. There can be only one main window in Windows Help. The main window has the menus (File, Edit, Bookmark, Options, and Help) and beneath them, a button toolbar. The toolbar n
ormally features the Help Topics, Back, Print, and Browse command buttons. You cannot delete items in the menus, but you can add items to them using macros. You can configure the button toolbar quite easily with the Help Magician, without any macro pro
gramming. You have control over the size and placement of the main window. The "Help Windows" text above is contained in a non-scrolling region and this text is in a scrolling region.\par
\par
\par
\b Secondary Windows\b0 Secondary windows are used
to augment the main window. They can also be used by themselves when showing training card help or other specific tasks. They can contain a button toolbar, fully programmable by the help author. A secondary window can even be automatically "sized to
fit" the length of its topic. Like the main window, secondary windows can contain non-scrolling regions, graphics, multimedia, and hypertext links to other topics. You have control over the size and placement of secondary windows. Up to 255 secondary
windows can be defined, and out of them, up to 9 can be displayed simultaneously. Click on the different examples of secondary windows below. \par
\par
\ATXul1026 \cf2 \ATXht1 Secondary window without a button bar\par
\ATXul0 \cf0 \ATXht0 \ATXul1026 \cf2 \ATXht2 Secondary window with a button bar\par
\ATXul0 \cf0 \ATXht0 \ATXul1026 \cf2 \ATXht3 Secondary window set for automatically sizing to fit topic\par
\ATXul0 \cf0 \ATXht0 \ATXul1026 \cf2 \ATXht4 Secondary window that plays a .wav file when
displayed\par
\ATXul0 \cf0 \ATXht0 \par
\par
\b Popup Windows\b0 Pop-up windows are used extensively for word definitions, lists of related topics with hypertext jumps, or other text, where the main or secondary windows would be overkill. Popup wind
ows do not have menus, button toolbar, or scrolling regions. They can contain graphics or hypertext links to other topics or multimedia. You have no control over the size and placement of popup windows. \ATXul3074 \cf2 \ATXht10001 Click on this text
to see a popup window.\par
\li0\fi0 \ATXul0 \cf0 \ATXht0 \par
\par
\li720 Help Magician Pro 95 allows you to visually create your windows. If you are currently viewing the help source of this file under Help Magician Pro 95, click on Options...Window
s to see the list of defined windows for this demo.
WinHelp and Help Magician Pro 95 support many types of hypertext links. Hypertext links (or "hot
spots") are what allows you to move from one topic to another or run a WinHelp macro. Hotspots may appear within text or be sectioned off within a graphic. The mouse cursor typically changes to a hand when the user moves the cursor over a hotspot. Wit
hin a hotspot definition, you can optionally specify which window the destination topic will appear in. The different types of hotspots are demonstrated below.\par
\par
\li900\fi-360 \ATXnt1 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht3 Jump to Another
Topic\ATXul0 \cf0 \ATXht0 - The simplest form of link to another topic within the same help file.\par
\par
\ATXnt2 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht2 Jump to Another Help File\ATXul0 \cf0 \ATXht0 - This type of link allows you to display a
topic in another help file. You specify which help file and what its context id number is. Click on this hotspot to see the help for Windows 95.\par
\par
\ATXnt3 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht4 Jump to a Mid-Topic\ATXul0 \cf0 \ATXht0 -
With Mid-Topic jumps, it's possible to link to an "anchor" point within a specified topic (such as a glossary). \par
\par
\ATXnt4 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht1 Jump to a Keyword\ATXul0 \cf0 \ATXht0 - The Jump to Keyword link will allow
a user to jump to a topic containing the specified keyword. If more than one topic contains the keyword, then a list of topics will appear and the user can select which topic to jump to.\par
ump to a Macro\ATXul0 \cf0 \ATXht0 - When the user clicks on a hotspot containing this type of jump, a predefined WinHelp macro is executed. Macros allow you to run other programs, play multimedia, create buttons that run other macros, create menu item
s, etc. Clicking on this example will run the calculator in Windows 95.\par
\par
\ATXnt6 BULLET1.BMP\ATXnt0 \ATXul3074 \cf2 \ATXht10001 Popups\ATXul0 \cf0 \ATXht0 - Popup hotspots cause the destination topic to appear in a small popup window near t
he hotspot. Popups are frequently used for definitions, as well as "About" boxes. Popup windows can contain text, graphics, and hotspots.\par
Putting graphics into your help files adds a new dimension to displaying your help file. However
, graphics will use memory. You should decide on what kind of graphic you want in your help topic. 16-color graphics will work across all video display systems and provides the most compatability and uses the least amount of memory. 256-color graphics
are good for showing photo-quality images. However, 256-color images take up twice the memory as the same size 16-color image. 256-color images will not display properly with systems that can only display 16 colors (standard VGA mode). Most systems to
day have the capability of displaying 256-color images. Higher resolution color images (more than 256-color) take even more memory and probably will not be displayable on most systems.\par
\par
\par
\li900\fi-360 \ATXnt1 BULLET1.BMP\ATXnt0 File Fo
rmats - WinHelp supports primarily .bmp and .wmf images. Help Magician Pro 95 reads other image formats (.tif, .tga, .pcx, .gif, .bmp, .ico, .wmf) and converts them to the WinHelp suitable format.\par
\par
\ATXnt2 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht1 Static Graphics\ATXul0 \cf0 \ATXht0 - Regular bitmaps (or metafiles) that are displayed with character alignment, left alignment, or right alignment.\par
\par
\ATXnt3 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht5 Hotspot Graphics\ATXul0 \cf0 \ATXht0 - These types of graphics contain hotspots. The hotspot may cover the entire graphic or a portion of the graphic. Use the SHED.EXE editor to make SHG files with hotspots from bitmaps.\par
\par
\ATXnt4 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht4 P
re-defined Bitmaps\ATXul0 \cf0 \ATXht0 - A set of predefined WinHelp bitmaps that you have at your disposal.\par
\par
\ATXnt5 BULLET1.BMP\ATXnt0 \ATXul1026 \cf2 \ATXht2 Transparent Bitmaps\ATXul0 \cf0 \ATXht0 - A 16-color bitmap in which WinHelp re
places the white pixels with the color of the bacground of the current Help window. They are commonly used to displaying images that aren't rectangular against a colored window background.\par
You can include many different multimedia elements within your help system. They may be played w
hen the help file first starts up, when a topic is about to be displayed, or when a user clicks on a hotspot. Help Magician makes it easy for you to insert multimedia elements into your help. You do not need to learn macro programming. It takes care o
f that for you.\par
\par
Click on each element below for a demonstration.\par
\par
\par
\ATXul1026 \cf2 \ATXht1 Sound\ATXul0 \cf0 \ATXht0 - Plays .wav files using the standard Windows multimedia drivers on your PC.\par
\par
\ATXul1026 \cf2 \ATXht2 Animation\ATXul0 \cf0 \ATXht0 - Plays .mmm files, although this format is not used much these days.\par
\par
\ATXul1026 \cf2 Video\ATXul0 \cf0 - Plays .avi files in a small window that appears on top of WinHelp. AVI files can contain video clips
or screen animation. This option doesn't work in this demo because we needed to make this file smaller for web distribution. It is available on the demo CDROM and the distribution version.\par
\par
\ATXul1026 \cf2 \ATXht4 Embedded Video\ATXul0 \cf0 \ATXht0 - A Windows 95 feature that plays .avi files within a WinHelp window.\par
\f1 Browse Sequences are used to define groups of help topics that are related to each other. When b
rowse sequences have been defined, WinHelp will show the << (previous) and >> (next) buttons. The user can click on these buttons to move forward or backward within a browse group and view those related topics in the group.\par
\par
For example, you m
ight have a hypertext file containing creatures of the world. One browse sequence could contain a group of topics that show all the species of mammals, another could show all the birds, and another could show all the fish. In this example, you could de
fine the mammals in alphabetical order within the browse group.\par
\par
It is up to the help author to determine how the help topics will be grouped together in a browse group. Help Magician makes it easy to define browse groups and re-order topics i
n that group. It will also generate the necessary macro to show the browse buttons.\par
\par
This topic is the first of three topics that have been defined in a hypothetical browse group. The other two topics are other help topics that appear in this
file (the "area" topics for the hotspot graphics demo). You can see how this sample browse sequence has been defined by selecting Links...Browse Sequences from Help Magician's menu.\par
Macro programming for WinHelp can be technically demanding, depending on what you want to d
o. Here we'll show you a few common uses for WinHelp macros. This section is not meant as a full tutorial on macro programming. Help Magician Pro 95's macro editor can make programming macros easier.\par
\par
\par
\fs24 \b Controlling When WinHelp
Macros Get Executed\par
\fs20 \par
Project Level\b0 - A macro will get executed when the Help file is first shown. We use a project level macro to initialize DLLs, the Stop Sound button, and to play an opening theme for this demo.\par
\par
\b Topic
Level\b0 - A macro will get executed just before a topic is shown.\par
\par
\b Hotspot Level\b0 - A macro will get executed when a user clicks on a hotspot.\par
\par
\b Window Level\b0 - A macro will get executed just before a specific window is
shown.\par
\par
\b Keyword Level\b0 - A macro will get executed when a user selects a keyword from the Index Tab in the Help Topics browser.\par
\par
\par
\par
\fs24 \b Samples\par
\fs20 \b0 \par
\fi720 \ATXul1026 \cf2 \ATXht2 Running External P
rograms from within your Help file\ATXul0 \cf0 \ATXht0 - This example runs the Windows 95 Calculator program.\par
\par
\ATXul1026 \cf2 \ATXht1 Running an aplet from the Control Panel\ATXul0 \cf0 \ATXht0 - This sample runs the ControlPanel macro that
tells Windows to show the display settings for the screen saver.\par
\par
\ATXul1026 \cf2 \ATXht3 Checking to see if a file exists\ATXul0 \cf0 \ATXht0 - This sample checks to see if the calc.exe program exists. If it does, it is run, else a popup top
ic appears telling that the application doesn't exist.\par
\par
\ATXul1026 \cf2 \ATXht4 Popping up a messagebox\ATXul0 \cf0 \ATXht0 - This sample pops up a messagebox, by calling an API routine in Windows.\par
WinHelp supports many types of buttons. The Standard and Customized buttons appear in the WinHel
p Bar within a WinHelp main or secondary window. The Authorable Buttons appear inside a help topic and will animate when clicked on. Shortcut buttons show a "shortcut arrow" button and run an application. The shortcut button macro is similar to the Ex
ecFile macro, except that in addition to running an application it can also pass standard WM_COMMAND messages to a Windows application.\par
\par
You define which WinHelp macros to execute when a button is pressed.\par
\par
Below is a sample of differ
ent kinds of buttons.\par
\par
\par
\ATXul1026 \cf2 \ATXht3 Standard\ATXul0 \cf0 \ATXht0 - Standard buttons can be defined in the WinHelp bar and can include the Contents, Index, Find, Help Topics, Print, Back, Options, and Browse buttons.\par
\par
\ATXul1026 \cf2 \ATXht2 Customized\ATXul0 \cf0 \ATXht0 - Custom buttons can include any text you want and can be made to run any WinHelp macro. You must define at least one standard button before a custom button. This example shows a secondary wind
ow containing a Calculator Button which runs the ExecCalc macro, showing the calculator.\par
\par
Authorable Buttons - Click on this \ATXht30001 {\object\objemb{\*\objdata
}{\result }}\ATXht0 to run the calculator program.\par
\par
Buttons in Secondary Windows - Both standard and customized buttons can be defined for secondary windows. The examples above do
place the buttons in a secondary window.\par
\par
Shortcut Buttons - These buttons usually appear in "How To" topics and they help the user accomplish their task. Click here \ATXht1 \ATXnt1 SHORTCUT.BMP\ATXht0 \ATXnt0 to see a shortcut demo (that
copies this help topic's text to the clipboard, runs WordPad, and pastes the text into WordPad).\par
[ETX]
[EHT]
[PK]
051513040017
[EPK]
[PT]
Popup Example
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[N3]
0198210000001HELP1.BMP
[EN3]
[PG]
[EPG]
[BI]
[EBI]
[CS]
Popup_Example
[ECS]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw11835 \margr0\margl0 \plain \fs20 \ATXts720\sl240 \f1 \ATXnt1 HELP1.BMP\ATXnt0 This is an example of a popup window with a graphic.\par
[ETX]
[EHT]
[PK]
051513040018
[EPK]
[PT]
Secondary Window without button bar
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[PG]
[EPG]
[BI]
[EBI]
[CN]
31
[ECN]
[CS]
Secondary_Window_without_button_bar
[ECS]
[TW]
4
[ETW]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw12765 \margr0\margl0 \plain \fs20 \ATXts720\sl240 \f1 This is a simple secondary window without a button bar. It does not have a non-scrolling region defined.
\par
[ETX]
[EHT]
[PK]
051513040019
[EPK]
[PT]
Secondary Window with a Button Bar
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[PG]
001002
[EPG]
[BI]
[EBI]
[CN]
32
[ECN]
[CS]
Secondary_Window_with_a_Button_Bar
[ECS]
[TW]
5
[ETW]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw12765 \margr0\margl0 \plain \fs20 \ATXts720\qc\ATXpt2\sl240 \f1 \fs28 \cf4 Secondary Window with a Button Bar\par
Depending on how you set up the windows, you can have the window to automatically resize itself to acco
modate the text appearing in it. The following text is just text to take up space.\par
\par
"Filler text"\par
\fi270 Many of the help topics displayed in WinHelp goes into the main window. The main window is the window that you see this text display
ed in. There can be only one main window in Windows Help. The main window has the menus (File, Edit, Bookmark, Options, and Help) and beneath them, a button toolbar. The toolbar normally features the Help Topics, Back, Print, and Browse command button
s. You cannot delete items in the menus, but you can add items to them using macros. You can configure the button toolbar quite easily with the Help Magician, without any macro programming. You have control over the size and placement of the main wind
ow. The "Help Windows" text above is contained in a non-scrolling region and this text is in a scrolling region.\par
[ETX]
[EHT]
[PK]
051513040021
[EPK]
[PT]
Secondary window that plays a wav file when displayed
When this topic is displayed, a sound clip is played. This is accomplished by defining a multime
dia element within Help Magician and attaching it to a topic. Help Magician does the work of creating the necessary project and topic macros to play the sound. In this example, Help Magician created the macro definition Play_SPACE.WAV_000 which contain
ed the sndPlaySound("space.wav",1) macro. The 1 parameter forces return to WinHelp immediately following the macro call (the sound is played in the background). If this parameter was a 0, the sound would have to be fully played before control is return
\qc \fs46 \b \ATXnt7 SILOG3DC.BMP\ATXnt0 Scrolling Region Area\par
\ql \fs20 \b0 \par
\par
No
n-scrolling regions is an area of a help window that stays in place, even though help text beneath the area can scroll vertically. Non-scrolling regions can contain text, graphics, or anything that the scrolling area can contain. Typically, a non-scrol
ling region can contain a Topic Header, a company logo/information, or anything else that you might want to remain stationary for the duration of the display of a single topic.\par
\par
Help Magician Pro 95 fully supports WYSIWYG non-scrolling regions
and you can instantly switch between the non-scrolling region and the scrolling region for editing.\par
about any way you like in WinHelp. WinHelp supports different styles of fonts, font attributes, and font colors. Keep in mind that if you use a unique font on your system, the target system must also have the same font installed, otherwise Windows wil
l try to do a font substitution and the results may not be what you want. If you are developing a help file that will be seen by a wide audience, it's best to stick with the common fonts supplied with Windows (such as MS Sans Serif, Arial, Symbol, etc.)
. When you are making a jump or popup within Help Magician, do not add your own green underline to the text; Help Magician will do it for you.\par
\par
\fs24 This is normal text.\par
\par
\b This is bold text.\par
\b0 \par
\i This is italic text.
\par
\i0 \par
\b \i This is bold italic text.\par
\b0 \i0 \par
\cf9 This text has a different color.\par
\cf0 \par
\fs30 This text is larger than above.\par
\fs24 \par
\fs16 This text is smaller than above.\par
\fs24 \par
This \fs36 \b \cf4 text\fs24 \b0 \cf0 contains a \i mixture\i0 of \fs30 bigness\fs24 and \cf4 c\cf2 o\cf9 l\cf5 o\cf3 r\cf7 s\cf0 within the same line of text.\par
\fs20 \par
\f2 \fs28 \b This text contains a different font.\par
\f1 \fs20 \b0 \par
\fs24 \par
\fs20
[ETX]
[EHT]
[PK]
051513040024
[EPK]
[PT]
Special Characters
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[PG]
001002
[EPG]
[BI]
[EBI]
[CN]
54
[ECN]
[CS]
Special_Characters
[ECS]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw12060 \margr0\margl0 \plain \fs20 \ATXts720\qc\ATXpt2\sl240 \f1 \fs28 \cf4 Special Characters\par
WinHelp and Help Magician Pro 95 has the capability of displaying speci
al characters including European character sets. You can use these special characters to add trademarks and copyright symbols to your text. Here is some of the symbols that are supported by WinHelp and are directly insertable within Help Magician Pro 9
WinHelp and Help Magician Pro support a variety of paragrap
h formatting options. Within Help Magician Pro 95, you can create paragraph styles and apply these styles to paragraphs. If you made changes to the style, Help Magician Pro would update all paragraphs using the modified style. Below are some examples
of Paragraph Formatting options.\par
\par
\par
\ATXpt1 \b Text Alignment\b0 - Make text left, centered, or right aligned\par
\ATXpt0 This text is left aligned\par
\qc This text is centered.\par
\qr This text is right aligned.\par
\ql \par
\par
\ATXpt1 \b Line Spacing\b0 - you can control the amount of spacing that will be appearing between paragraphs.\par
\ATXpt0\sl360 This line of text is spaced 1.5 lines before the next line\par
Next line\par
\par
\sl240 \par
\ATXpt1 \b Indents\b0 -
Easy to do in Help Magician by using the Ruler Bar.\b \par
\ATXpt0\li1260\fi-1260 \b0 It's easy! Indented text allows for visually appealing paragraphs, columns of text, definitions, etc. Create hanging indents visually by moving the lower marker on t
he Ruler Bar. This paragraph is setup as a hanging indent. A tab character separates the first column with the rest of the hanging indented paragraph.\par
\li0\fi0 \par
\par
\par
\ATXpt1 \b Bullets\b0 - WinHelp and Help Magician support bulleted l
ists like the one below...\par
\ATXpt0\li720\fi-360 \f2 ⌐\f1 Item #1\par
\f2 ⌐\f1 Item #2 \par
\f2 ⌐\f1 Item #3\par
\par
\li0\fi0 \par
\ATXpt1 \b Borders\b0 - Highlight one or more special paragraphs with a border around it. WinHelp supports m
any types of borders.\par
\ATXpt0 \par
\ATXbrdr20 Line Above\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr40 Line Below\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr1 Line on the Left\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr2 Line on t
he Right\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr63 Single Box\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr575 Double Box\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ATXbrdr319 Thick Box\par
\pard\ATXts720\sl240\ATXbrdr0 \par
\ri6216\ATXbrdr2111 Shadowed Box - set the right margin to force a smaller box\par
\pard\ATXts720\ri0\sl240\ATXbrdr0 \par
\li720\ri6216\ATXbrdr543 \b Bold Text in Box\par
\ATXbrdr527 \b0 Put a box around two paragraphs by highlighting both paragraphs and selecting th
e box. You can even indent the box\par
\par
This is another paragraph.\par
\ATXbrdr559 \par
\pard\ATXts720\li0\ri0\sl240\ATXbrdr0 \par
\par
\ATXpt1 \b Tabs & Columns \b0 - Tabs and columns make it easier to organize your data. Make sure that the
text in one column does not get too close to the text in another column- any font differences between systems could cause the text in that column to move to the next column.\par
\ATXpt0 \par
By using right-aligned tabs, you can make numerical data line
up properly as in the following example (notice the box around the data and the larger size heading):\par
WinHelp does not have the capability of directly handling special math symbols, superscript
ed, and subscripted fonts. One way of getting your formulas into WinHelp is by first converting them into a bitmap and then inserting that bitmap into your text, as in the following example.\par
This example shows the destination topic of the Mid-Topic Jump example.\par
\par
some text
\par
\par
more text\par
\par
even more text which shouldn't be shown initially.\par
\par
\cf4 \ATXht20000 #\cf0 \ATXht0 Here is where the mid topic jump will be shown. Notice the # in the Help Magician editor which means a midtopic jump anchor point.
You can scroll back to see the previous text in this topic.\par
Here is an example of a hotspot graphic. As you move the mouse over a hotspot on the graphic, th
e cursor changes to a hand. Clicking on a defined area within the bitmap will bring up different help topics. You define which area is "hot" and which topic (by its context string) it belongs to by using the SHED editor. You can run the shed editor wi
thin Help Magician from the tools menu.\par
\par
\ATXnt1 hotspot.shg\ATXnt0 \par
[ETX]
[EHT]
[PK]
051513040037
[EPK]
[PT]
Area1
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[PG]
[EPG]
[BI]
1:2;
[EBI]
[CN]
61
[ECN]
[CS]
Area1
[ECS]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw11124 \margr0\margl0 \plain \fs20 \ATXts720\sl240 \f1 \fs20 This is area 1 of the hotspot graphic. It has been defined as a jump.\par
[ETX]
[EHT]
[PK]
051513040038
[EPK]
[PT]
Area2
[EPT]
[MC]
M
[EMC]
[MT]
[EMT]
[PG]
[EPG]
[BI]
1:3;
[EBI]
[CN]
62
[ECN]
[CS]
Area2
[ECS]
[TX]
{\fonttbl
{\f0\fswiss\fcharset0 SYSTEM;}
{\f1\fswiss\fcharset0 MS SANS SERIF;}
}
\paperw11124 \margr0\margl0 \plain \fs20 \ATXts720\sl240 \f1 \fs20 This is area 2 of the hotspot graphic and it has been defined as a popup.\par