Index 49,1570,4783,13727,15431,17686,19920,22294,24809,27036,29220,34139,37148,39309,45666,63995,67335,69866,83689,97035,100925,105939,108562,111771,116218,121288,125681,129282,139812,148249,149757,160712,166124,167587,169052,188880,195012,200051,204778,207189,211917,216278,227209,230425,244463,250555,274013,278283,289262,296466,306153,307664,309921,313466,320305,317212,320600,322348,,339668,45331,355140,359372,369489,372877,383105,386910,391402,396697,405052,408628,53795,358070,358809,344136,4400,05344,3954,20
' Y|N Switch for Yes/No radio buttons: Y = Enable, N = Disable.
' E|N|B Switch to determine if page is displayed in Novice or Expert mode or Both.
' 3|9|B Switch to determine if a page is displayed in Win 3. 1 or 95 mode or Both.
' FocusButton variable used to set the button to have focus when page appears.
' Y|N Switch to mark a page as Primary or Dependent.
' 0 - Not used - Was NNNNN Five character HelpContextID string.
[Introduction]
{NBB3Y296}
Welcome to the Help Wizard.
The Help Wizard will help you learn how to use the Help Magician and guide you through the creation of a help file.
Click on the Next -->> button to continue.
{NNB3N0}
As you use the Help Wizard, I'll put a red box around the button that you should press next.
When possible, I'll also move the mouse cursor to the button so that there is little effort required to move through a category.
Click on the Next -->> button to continue.
{NNB3N0}
The images seen in the lower right hand corner of the information text box will always reflect which version of Windows the category pertains to.
The image with the flag only denotes Windows version 3.1 The image with the flag and "Start" denotes Windows version 95. Both images means both versions.
Click on the Next -->> button to continue.
{NBB3N0}
If you would like the Help Wizard to guide you through a new help file, select "New Help File" from the Category (a-i) menu.
If you would like to learn about a particular form used in the Help Magician, select the form's "Tour" from any of the categories.
Click on the Next -->> button to continue.
{NBB3N0}
The advantage of the Form Tours is that no help file or related files, macros, etc. is necessary to view the tour.
You can also view Windows 3.1 or Windows 95 forms, regardless of the Windows version on your system.
Click on the Next -->> button to continue.
{NBB3N0}
Many of the categories have Assist menus.
These menus provide assistance with the category by walking you through the form(s) related to the category, prompting for user intervention when necessary.
Click on the Next -->> button to continue.
{NNB3N0}
The buttons in the toolbar below are, from left to right: Exit, Go/Multi Purpose, Previous Page, Next Page, and Help.
If the "Quick Help" option is enabled (Options Menu), a small window will display the functionality of each of the buttons as the mouse cursor passes over it.
Click on the Next -->> button to continue.
{NNB3N0}
In addition to the command buttons, there are shortcut keys to navigate through topics in the Help Wizard.
Ctrl+B and Ctrl+F arrow pages backward and foreword through a category.
Ctrl+Home moves to the first page of a category.
Click on the Next -->> button to continue.
{NBB3N0}
If the mouse cursor moves to the controls too quickly or too slowly on your system, set a different speed by selecting the Options menu, Cursor Speed sub menu.
Click on the Next -->> button to continue.
{NNB3Y0}
Click on the Next and Previous buttons to move through a category. These buttons are only enabled when the relative pages contain information and no commands are executed.
You can jump to any of the categories at any time by selecting it from the Category menu.
Click on the Next -->> button to continue.
{NBB1N0;SGo to Category: Help Magician Tutorial;}
Don't jump around the categories until you become familiar with the Help Wizard.
Now would be a good time to let the Help Wizard walk you through the Tutorial.
Click on the Go button to continue or select one of the categories from the category menus.
[New Help File]
{NE91N0;SWant File in Editor: False;SAuto Hide Wizard: True;SActivate Menu: &Options, &Compiler;SWait For Form: CompilerForm;S'Show Form: CompilerForm;SPause: 1;CNFrame1(0) ;SPointer to Control;SAuto Hide Wizard: False;SFocus Form;SAuto Next;}
I am going to help you enter all the necessary fields for a new help file.
First we're going to go set some options in the Compiler Form.
Click on the Go button to continue.
{NBB3N0}
The first option you'll need to set is the compiler version. This depends on the version of Windows you're using and the Windows version of the target audience.
Click on the Next -->> button to continue.
{NBB3N0}
Set the compiler version to Windows 3.1 if you are working under Windows 3.1 or if you're working under Windows 95 but compiling for a Windows 3.1 audience.
Click on the Next -->> button to continue.
{NBB1N0;SSet ActiveTab: 5;SAuto Next;}
The path to your compiler will be changed in the Paths form. A path and compiler switches are maintained for each compiler version.
Make your selection then click on the Go button to continue.
{NBB3N0}
Map options
A "map" is a file that contains a table of the relationships between context strings and context numbers.
Click on the Next -->> button to continue.
{NBB3N0}
Map options, cont'd.
The "Put in Project File" option is the default. This causes the Help Magician to write the context sensitivity map to the project (.HPJ) file.
Click on the Next -->> button to continue.
{NBB3N0}
Map options, cont'd.
When the Write #include file option is selected, the context sensitivity information is written to a separate file (.H). A #include statement is entered in the project (.HPJ) file that references the .H file.
Click on the Next -->> button to continue.
{NBB3N0}
Map options, cont'd.
Use the Write #include File option if you are working on a Project with two or more files.
Click on the Next -->> button to continue.
{NBB3N0}
Map options, cont'd.
Select the Use Existing File option if you are working with the application developers to establish context sensitivity. The developers would usually provide the map for this purpose.
If Write #include File or Use Existing File is selected, a Map File Path and Name will be required in the text box below the options.
Select the Map option then click on the Go button to continue.
{NBB1N296;SAuto Hide Wizard: True;SActivate Menu: &Options, &Appearance;SWait For Form: AppearanceForm;S'Show Form: AppearanceForm;CNText1 ;SPointer to Control;SAuto Hide Wizard: False;SFocus Form;SAuto Next;}
Now we're going to set the options on the Appearance Form.
Click on the Go button to continue.
{NBB1N296;CYText2 ;SPointer to Control;SFocus Form;SAuto Next;}
The first options is the Icon Filename. The icon file name refers to the bitmap that will be displayed as the icon when the help file being displayed with WinHelp is minimized.
Enter the icon path and name or use the Browse button to locate the file.
Enter the Icon Filename then click on the
Go button to continue.
{NBB1N0;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
The next option is the Copyright Notice. The text entered here will be displayed as the copyright notice in the About window in the help system. Note that you cannot change any other text in the About box (limitation set by Microsoft).
Enter the Copyright Notice, if desired, then click on the Go button to continue.
{NBB1N0;CYText4 ;SPointer to Control;SFocus Form;SAuto Next;}
Now, the Help System Title. What you type in here will be displayed at the top of the help window when the help system is viewed with WINHELP.EXE.
Enter the Title then click on the Go button to continue.
The citation text is appended to the end of any text that is copied through WinHelp. A citation may contain a copyright, warning, or any message you want.
Enter the Citation, if desired, then click on the Go button to continue.
{NBB1N75;SAuto Hide Wizard: True;SActivate Menu: &Options, &Paths;SWait For Form: PathForm;S'Show Form: PathForm;CYText1 ;SPointer to Control;SAuto Hide Wizard: False;SFocus Form;SAuto Next;}
Next, we're going to enter the fields on the Path form.
Click on the Go button to continue.
{NBB1N75;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
Enter the full path and name of the compiler to be used with the current Windows version setting on the Compiler form. Use the Browse button, if necessary. The current Windows version is noted at the end of the label above the text box.
Enter the path then click on the Go button to continue.
{NBB1N296;CYText6 ;SPointer to Control;SFocus Form;SAuto Next;}
Enter the compiler switches, if any. With rare exceptions, no switches should be used with the 3.1 compiler. The default switches for the 95 compiler will already be entered for you and, in most cases, you will not need to change them.
Enter the switches then click on the Go button to continue.
{NBB1N296;SPointer Close;SAuto Next;}
Enter the WinHelp path and name of the compiler to be used with the current Windows version setting on the Compiler form. Use the Browse button, if necessary. The current Windows version is noted at the end of the label above the text box.
Enter the path and then click on the Go button to continue.
The rest of the paths do not have to be set at this time but you can fill them in if you like.
The form cannot be closed with the Accept button if any of the paths or filenames cannot be found.
Click on the Go button to continue.
{NBB1N0;CYText1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now, we'll fill in the necessary fields on the main form.
Click on the Go button to continue.
{NBB1N12;CYToolbar2_AutoContextString ;SPointer to Control;SFocus Form;SAuto Next;}
A temporary title is constructed for every new topic. You can edit the title to reflect the functionality of the topic. The title will be seen by the end user in the search dialog.
Edit the title then click on the Go button to continue.
{NBB1N0;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
The Auto Context String button will automatically enter a context string for you (constructed from the title).
You will have to confirm the replacement of the current context string.
Click on this button or click on the Go button to continue.
{NBB1N12;CYToolbar2_AutoContextNumber ;SPointer to Control;SFocus Form;SAuto Next;}
If you didn't enter the context string automatically you can now type in your own. Context Strings are not allowed to have spaces in them. The spaces are replaced by an underscore.
When you are satisfied with the context string, click on the Go button to continue.
{NBB1N0;CYContextNumberText ;SPointer to Control;SFocus Form;SAuto Next;}
If you want the Help Magician to automatically enter a context number, you can press this button, and the Help Magician will enter the next available number.
You will have the opportunity to enter it manually on the next page.
When ready, click on the Go button to continue.
{NBB1N296;CYTextBoxScroll ;SPointer to Control;SFocus Form;SAuto Next;}
If you did not enter the context number automatically you can enter it yourself now. Duplicate context numbers are not allowed.
When you're satisfied with the context number, click on the Go button to continue.
{NBB1N0;SPointer Close;SAuto Next;}
Now, enter a topic title in the text editor. If you want the same title that is in the topic title text box, then press the T button and the Help Magician will put in the title for you.
If you don't want the same title then you can type it in yourself, and assign the style you want.
The Authorable Button form makes it easy to create buttons and add them to your help text.
A replica of the button that will be seen when viewing the file with WinHelp will be placed in the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Sample Button
When you create a button, the Sample Button will show you what the button will look like in the editor and in WinHelp.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
Button Caption: Text Box
You will enter the caption for the button in this text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAcceptCmd ;SPointer to Control;SAuto Next;}
Macro definition List Box
You will assign one of the macro definitions in this list to the button. See Defining Macros for information on creating macros.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Accept Button
When you have entered the button caption and selected the macros definition to execute, click on the "Accept" button and the button you have created will appear in the editor.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Add Button form.
Select the "Authorable Button" menu, "Assist: Adding Authorable Buttons" sub menu for assistance in adding buttons in your own help file.
[Adding Authorable Buttons]
{NBB3N299}
The "Authorable Button" feature will add a functional button anywhere in your help text and run the associated macro(s) when the user clicks on the button. I'm going to assist you in the creation of a custom button to include in your help text.
This topic requires macros, if you do not have any macros in your file I will create a simple macro called About_Macro.
The Alias section of the help project file is used to map specified context strings to other context strings.
Click on the Help button for a detailed explanation of the Alias section.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWriteAliasCheck ;SPointer to Control;SAuto Next;}
The Help Magician writes a new project file (.HPJ) every time you build your help file so that all the information is current.
The code entered on this form will be written to the Alias section of your help file's project file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
(ALIAS) - Write to Project File Check Box
You can store the alias information on this form but elect not to include it in the project file by leaving this check box unchecked. This is useful if you are compiling two different versions of your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Alias Text Box
This is a free form editing text box where you will enter your Alias information.
Again, click on the Help button for a detailed explanation of the Alias section.
Click on the Go button to continue.
{NBB1Y0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
Context Strings Button
Click on the "Context Strings" button to display a list of all of the context strings used in your help file.
When you select a context string from the list, it is entered into the text box at the current cursor location.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Close Button
When you have finished entering the Alias information, click on the "Close" button to close the form and store the data.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Alias form.
Select the "Alias" menu, "Assist: Entering the Alias Section" sub menu for assistance in entering an alias section in your own help file.
[Entering the Alias Section]
{NBB1Y286;SWant File in Editor: True;SAuto Hide Wizard: True;S'Show Form: AliasForm;SActivate Menu: Bui&ld, Alias &Section;SWait For Form: AliasForm;SAuto Hide Wizard: False;SAuto Next;}
Entering the Alias Section
I am going to show you how to enter Alias Sections in your help file.
Click on the Go button to continue.
{NNB3N0}
The [ALIAS] section associates one set of context strings with an alternate set of context strings. The alias strings correspond to context strings assigned to topics in the Help Magician.
Context sensitive help to a topic can be redirected to another topic with the [ALIAS] section.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNWriteAliasCheck ;SPointer to Control;SSet Ctl.Value True;SAuto Next;}
I'm going to help you enter the [ALIAS] section but, if you're not familiar with the syntax of the Alias section, click on the Help button for a detailed explanation.
You may want to print a copy of the topic for your reference while you fill out the section.
Click on the Go button to continue.
{NBB1N0;CYText1 ;SPointer to Control;SFocus Form;SAuto Next;}
(ALIAS) - Write to Project File Check Box
I made sure the check box was checked for you so that the Alias section will be written to the project file.
Click on the Go button to continue.
{NBB1N0;SWizard Not On Top;CYText1 ;K^{End};SFocus Form;SAuto Next;}
Alias Text Box
Now, let's enter the Alias information into the text box.
You can type in the Context String or use the "Context Strings" command button to display a list of the context strings in your help file.
Click on the Go button to continue.
{NBB1N0;SWizard Not On Top;CYText1 ;K{End};SFocus Form;SAuto Next;}
Now, enter the context string of a destination topic that you want to redirect to another topic.
Then, enter an equal sign (=) after the context string.
When you're done, click on the Go button to continue.
Now, enter the context string of the new destination topic for the hot spot after the equal sign (=).
When you're done, click on the Go button to continue.
{NBB5Y0}
Congratulations, you have entered an Alias.
You can continue to enter alias information, select another category, or close the Wizard.
[Appearance Form Tour]
{NBB1Y84;TAppearance Form Tour;SAuto Hide Wizard: True;SShow Form: AppearanceForm;SWait For Form: AppearanceForm;SEnable All Controls;SAuto Disable Form: True;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Hide Wizard: False;SAuto Next;}
The Appearance form is used to set the visual appearance of your compiled help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Icon Filename
The icon file name refers to the bitmap that will be displayed as the icon when the help file being displayed with WinHelp is minimized.
Click on the Go button to continue.
{NNB1N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
Browse Button
When defining the Appearance Options, you can click on the Browse button to bring up a file dialog from which you can select the icon file for the help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Copyright Notice
The text entered here will be displayed as the copyright notice in the About window in the help system. Note that you cannot change any other text in the About box (limitation set by Microsoft).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText4 ;SPointer to Control;SAuto Next;}
Help System Title
The text entered here will be displayed at the top of the help window when the help system is viewed with WINHELP.EXE.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
Citation
The citation text is appended to the end of any text that is copied through WinHelp. A citation may contain a copyright, warning, or whatever message you want.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
Accept Button
When defining the Appearance Options, you would click on the Accept button to record the changes and close the form.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Cancel Button
When defining the Appearance Options, you can click on the Cancel button to close the form without recording the changes.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Appearance form.
Select the "Appearance Options" menu, "Assist: Entering Appearance Options" sub menu for assistance in entering appearance options in your own help file.
[Entering Appearance Options]
{NBB1Y84;TAppearance Form Tour;SWant File in Editor: True;SAuto Disable Form: False;SAuto Hide Wizard: True;S'Show Form: AppearanceForm;SActivate Menu: &Options, &Appearance;SWait For Form: AppearanceForm;SAuto Hide Wizard: False;SAuto Next;}
Entering Appearance Options
I'm going to assist you in entering Appearance Options. I'll bring up the form for you.
Click on the Go button to continue.
{NBB1N0;CYText1 ;SHighlight Text: -1;SPointer to Control;SFocus Form;SAuto Next;}
First we'll enter the Icon Filename.
If you choose not to enter a icon filename the default Icon will be displayed.
Click on the Go button to continue.
{NBB1N0;CYText2 ;SHighlight Text: -1;SPointer to Control;SFocus Form;SAuto Next;}
If you know the path then you can enter it in now, and skip the next page.
If you don't know the path then click on the Browse button and locate the icon with the file dialog.
When you're done, click on the Go button to continue.
{NBB1N0;CYText3 ;SHighlight Text: -1;SPointer to Control;SFocus Form;SAuto Next;}
Now, we're going to enter the text you want in the Copyright Notice text box.
What you type will be displayed in the About window in your help file. You can leave this field blank.
When you're done, click on the Go button to continue.
{NBB1N0;CYText4 ;SHighlight Text: -1;SPointer to Control;SFocus Form;SAuto Next;}
Next, let's enter the Help System Title.
The name you type in this box will appear at the top of your help file when viewed with WINHELP.EXE. You can enter the title or accept the default for this field.
When ready, click on the Go button to continue.
{NBB3N296}
Lastly, we'll enter text in the Citation field.
The Citation text is displayed in the Help file's Copy Topic dialog box.
Bookmarks are used to store the cursor position in a topic and return to that position at any time.
The page number, the cursor position, and the region (scrolling or nonscrolling) are all stored with the bookmark.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBookmarkText ;SPointer to Control;SAuto Next;}
Up to ten bookmarks can be set in a help file.
The bookmarks are saved with each file and can be accessed after opening a file in which bookmarks were set.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBookmarkList ;SPointer to Control;SAuto Next;}
Before selecting one of the bookmark buttons, you would enter a description for the bookmark and press Return to add it to the listbox..
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBookMarkCmd0 ;SPointer to Control;SAuto Next;}
The listbox contains the descriptions you entered for each bookmark or "Empty" if you didn't enter a description.
When you click on an item in the list, the corresponding bookmark button will receive the focus.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D2 ;SPointer to Control;SAuto Next;}
After you have entered the description, select one of the bookmark buttons.
Buttons that are already assigned will have red numbers while unassigned buttons will be blue. In "Goto" mode, buttons that are unassigned will be disabled.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D1 ;SPointer to Control;SAuto Next;}
The "Clear All" button will erase all of the bookmarks and their descriptions.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The "Cancel" button closes the bookmark form without any further action.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Bookmark form.
Because of the simplicity of the Bookmark form, there is no "Assist: Setting/Goto Bookmarks" category for this topic.
[Browse Form Tour]
{NBB1Y55;TBrowse Form Tour;SAuto Hide Wizard: True;SSet WIN95 Mode;SShow Form: BrowseForm;SPause: 1;SEnable All Controls;SAuto Disable Form: True;SAuto Hide Wizard: False;SAuto Next;}
The Browse form makes it easy to setup, maintain, and reorder browse groups.
Click on the Go button to continue.
{NNB1N0;SAuto Next;}
Browse groups are groups of topics that are related to each other in some way.
When the help files is compiled, the end user can "browse" through these topics with the browse buttons (<< and >>) on the WinHelp tool bar.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
The Browse form is divided into two sections, "Groups" and "Titles".
I'll explain the controls on the "Groups" side first.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
The textbox under the "Groups" label is a locator field, used on many forms throughout the Help Magician.
It helps you locate topic titles, context strings, or anything else that could be in the list box below it by moving the highlighted bar to the selection that matches the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
The Groups list box will contain a list of the browse group definitions that have been defined in the current file.
When you click on a group, the members of that group will be displayed in the list box to the right.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Add button is used to add new browse group definitions to the current file.
An input dialog will request the name of the browse group and it will be added to the list.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
The Rename button is used to change the name of the browse group currently highlighted in the Groups listbox.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
The Delete button is used to remove the currently selected browse group from the list.
Members of that group are also released and can be added to other groups.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList2 ;SPointer to Control;SAuto Next;}
The Titles Locator is used to find topics in the Titles listbox.
The highlighted bar moves to the selection that matches the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton4 ;SPointer to Control;SAuto Next;}
The Titles listbox will contain a list of the members belonging to the currently selected browse group in the listbox to the left.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton5 ;SPointer to Control;SAuto Next;}
The Add button on the Titles side of the form is used to add topics from your help file to the browse group currently highlighted in the listbox to the left.
A form with a list of the available topics will allow single or multiple selection of topics.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton6 ;SPointer to Control;SAuto Next;}
The Delete button on the Titles side of the form is used to remove members from the currently selected browse group.
The members will be released from the group and become available to add to other browse groups.
Click on the Go button to continue.
{NBB3N0}
The Move button is used to move a topic in the list to reorder the sequence of the topics in the current group.
You would select the topic in the list, press the Move button, use the up and down cursor keys to position the topic, and press the Move button again.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton7 ;SPointer to Control;SAuto Next;}
Topics can also be reordered with the mouse. Press and hold the left mouse button on the topic to be moved. Then drag the topic to the new position and release the mouse button.
Members of browse groups are displayed in the compiled help file in the order in which they appear in this list.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CYCmdButton8 ;SPointer to Control;SAuto Next;}
The Help button will call the Help Magician's own help system and display the Browse group topic.
Click on the Go button to continue.
{NBB1Y0;SPointer Close;SClose All Forms;SAuto Next;}
The Close button closes the browse group form.
All changes are recorded in the database.
Click on the Go button to continue.
{NBB5N0}
This concludes the Tour of the Browse form.
Select the "Browse" menu, "Assist: Creating Browse Sequences" sub menu for assistance in creating browse sequences in your own help file.
[Creating Browse Sequences]
{NBB1N0;SWant File in Editor: True;SAuto Disable Form: False;SAuto Next;}
Creating Browse Sequences
In this category, we're going to define browse groups in your own help file.
Browse Groups are groups of topics that are related to each other by definition. When viewing your help file, the user can "browse" back and forth through these topics by pressing the Browse buttons (<< and >>) in the WinHelp toolbar.
I'll open the Browse form by clicking on the Browse button in the toolbar.
Click on the Go button to continue.
{NBB3Y0}
We're going to add a group definition by pressing the Add button under the Groups section.
You will be entering the definition name for the group in the text box. The name should reflect, in some way, the type of topics that will be included in the group.
Note that the topics in a Browse Sequence are displayed in the order in which they appear in the list.
You can reorder the list by clicking on a topic, holding the left mouse button down, and dragging the topic to the new location in the list.
Click on the Go button to continue.
{NBB5N0}
Congratulations! You have created a Browse Sequence.
This concludes the "Assist" section of the Browse category.
You can continue to add Browse Sequences, go to another category, or close the Wizard.
[Building the Help File]
{NBB3N86}
Building the Help File
There are four sub menus available from the Build menu used to build a help file.
I'll explain the purpose for each of them and you can choose which menus to use.
Click on the Next -->> button to continue.
{NBB3N0}
Write RTF for Compiler
This sub menu writes the source help text out to RTF (Rich Text Format). This is the format required by the Help Compiler.
Click on the Next -->> button to continue.
{NBB3N0}
Write RTF for Compiler, cont'd
Use this option if there is more than one source file in your project such as project management or multiple file builds.
Write the RTF for all of the members of the project then use the Compile menu to create the help file.
Click on the Next -->> button to continue.
{NBB3N0}
Run Compiler
This option compiles the RTF that was written out with the Write RTF for Compiler option. Again, this would be used where there is more than one source file in the project.
Click on the Next -->> button to continue.
{NBB3N0}
Rebuild All
Use this option to write the RTF file and compile it all in one step. This option writes the RTF file without checking if it is up to date. It then compiles the help file and offers options to view the file with WinHelp.
Click on the Next -->> button to continue.
{NBB3N0}
Rebuild All, cont'd
Note that there is a Build All button on the Project form to write the RTF files for all of the members of a project. Using the Rebuild All menu in project mode would only compile the current file in memory.
Click on the Next -->> button to continue.
{NBB3N0}
One Page Preview
This option treats the current page or topic in the help file as a complete help file. It writes out a temporary RTF file and compiles it. This is a much faster way to view the compiled results of a topic than to rebuild the entire help file.
Click on the Next -->> button to continue.
{NBB5N0}
That's all there is to build a help file.
Select one or more of the menu options for your help file and view it with WinHelp.
At this point, you could select another category or close the Wizard.
The Build Tag Manager automates the handling of Build Tags and Build Expressions.
Build Tags are used to determine which selected portions of a help system will be compiled. With Build Tags, you can compile different versions of a help system from one source.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBuildTagList ;SPointer to Control;SAuto Next;}
Build Tags Edit Box
When actually defining Build Tags, you would enter the names of new Build Tags or rename existing Build tags with this text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAddCmd ;SPointer to Control;SAuto Next;}
Build Tags List Box
This list box will contain the names of all of the Build Tags currently defined in the help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRenameCmd ;SPointer to Control;SAuto Next;}
Add Button
Clicking on this button will add the tag in the Build Tags (Edit) text box to the Build Tag list. Pressing the Return key while the text box has focus has the same effect.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDeleteCmd ;SPointer to Control;SAuto Next;}
Rename Button
Clicking on this button will rename the currently selected Build Tag with the name specified in the Build Tags (Edit) text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Delete Button
Clicking this button will remove the currently selected Build Tag from the list and remove all references to it in the help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTopicList ;SPointer to Control;SAuto Next;}
Assigned to Topic(s) Locator Box
Use this text box to locate any of the topics listed in the list box below. As you type, the highlighted selection will be based on a match of the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAddToTopicCmd ;SPointer to Control;SAuto Next;}
Assigned to Topic(s) List Box
This list box will contain a list of all of the topics in the help system. When viewing assignments, topics that have the currently selected Build Tag assigned to them will be highlighted.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRemoveFromTopicCmd ;SPointer to Control;SAuto Next;}
>>> Button (Assign Tags)
The Assign Tags button assigns the tag(s) selected in the Build Tag list box to the title(s) selected in the Topic Title list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAssignModeRadio ;SPointer to Control;SAuto Next;}
<<< Button (Remove Tags)
The Remove Tags button removes the assignment of the tag(s) selected in the Build Tag list box from the title(s) selected in the Topic Title list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNViewModeRadio ;SPointer to Control;SAuto Next;}
Assign Tags Radio Button
This button puts the Build Tag Manager into Assign Tags mode where the tag(s) selected in the Build Tag list box will be assigned to the title(s) selected in the Topic Title list box when the >>> (Assign) button is pressed.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAnd ;SPointer to Control;SAuto Next;}
View Assignments Radio Button
This button puts the Build Tag Manager into View Tags mode where you can click on a topic and the assigned build tag(s) will be highlighted in the Build Tag List box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOr ;SPointer to Control;SAuto Next;}
And Button
Inserts the And symbol '&' with the appropriate spacing into the editor. Used to logical 'And' two build tags.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNNot ;SPointer to Control;SAuto Next;}
Or Button
Inserts the Or symbol '|' with the appropriate spacing into the editor. Used to logical 'Or' two build tags.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CN>>> ;SPointer to Control;SAuto Next;}
Not Button
Inserts the Not symbol '~' with the appropriate spacing into the editor. Used to local 'Not' (or exclude) a build tag.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CN(And) ;SPointer to Control;SAuto Next;}
>>> Button
Insert the single Build Tag selected in the Build Tag list box into the editor. This button can only be selected if a single Build Tag is selected in the Build Tag list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CN(Or) ;SPointer to Control;SAuto Next;}
(And) Button
Insert two Build Tags, in parenthesis, separated with the And symbol '&' into the editor with the appropriate spacing (BETA & FINAL). This button can only be selected if two Build Tags are selected in the Build Tag list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNExpressionNumberSpin ;SPointer to Control;SAuto Next;}
(Or) Button
Insert two Build Tags, in parenthesis, separated with the Or symbol '|' into the editor with the appropriate spacing (BETA | FINAL). This button can only be selected if two Build Tags are selected in the Build Tag list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNHelpCmd ;SPointer to Control;SAuto Next;}
Expression Number Spin
Click on the up or down arrows on the spin button to enter, edit, or select the desired Build Expression. The number of the Build Expression is displayed in the label above the spin button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCloseCmd ;SPointer to Control;SAuto Next;}
Help Button
This button displays the Help Magicians own on line help system opened to the Build Tags topic.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Close Button
Press the close button to close the Build Tag Manager and record the changes.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Build Tag form.
At this point, you can select another category or close the Wizard.
[Compiler Form Tour]
{NBB1Y76;SAuto Hide Wizard: True;SShow Form: CompilerForm;S'Wait For Open: True;SPause: 1;SEnable All Controls;SAuto Hide Wizard: False;SAuto Disable Form: True;SAuto Next;}
The Compiler Options form contains a number of options that effect the way in which your help file will be compiled and the way in which it will function when compiled.
I'll explain all of the options on each tab in the order in which they appear.
The first option you'll need to set is the compiler version. This depends on the version of Windows you're using and the Windows version of the target audience.
Set the compiler version to Windows 3.1 if you are working under Windows 3.1 or if you're working under Windows 95 but compiling for a Windows 3.1 audience.
The path to your compiler will be changed in the Paths form. A path and compiler switches are maintained for each compiler version.
Click on the Go button to continue.
{NB31N0;SPointer Close;SSet ActiveTab: 1;SEnable All Controls;SAuto Next;}
Set the Windows 95 radio button only if you're working under Windows 95 and the target audience of your help system is Windows 95.
Note: The 3.0 option is maintained for backward compatibility.
Click on the Go button to continue.
{NB91N0;SPointer Close;SSet ActiveTab: 2;SEnable All Controls;SAuto Next;}
Set the Windows 95 radio button only if you're working under Windows 95 and the target audience of your help system is Windows 95.
Note: The 3.0 option is maintained for backward compatibility.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNWarning1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Warning Tab.
The warning options tell the help compiler what level of errors to include in the report: severe, intermediate, or all.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNWarning2 ;SPointer to Control;SAuto Next;}
Set the Severe radio button if you want the compiler to report only the most severe errors.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNWarning3 ;SPointer to Control;SAuto Next;}
Set the Intermediate warning radio button to instruct the compiler to report intermediate warnings. The report will also include severe warnings.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;SSet ActiveTab: 2;SEnable All Controls;CNFrame1(2) ;CN'RTFCompatibility1 ;SPointer to Control;SAuto Next;}
Set the All warnings radio button to include all warnings in the report from the compiler.
This is the default and recommended setting.
Click on the Go button to continue.
{NB31N0;SPointer Close;SSet ActiveTab: 4;SEnable All Controls;SAuto Next;}
The options on the RTF Tab determine how the RTF code is written.
Select the RTF Compatibility option for the version of Word for Windows, if any, you are using. No word processor is necessary with the Help Magician but you can export to and import from a word processor if you like.
Click on the Go button to continue.
{NB91N0;SPointer Close;SSet ActiveTab: 3;SEnable All Controls;SAuto Next;}
Now let's look at the options on the RTF Tab.
Select the RTF Compatibility option for the version of Word for Windows, if any, you are using. No word processor is necessary with the Help Magician but you can export to and import from a word processor if you like.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNFrame1(3) ;SPointer to Control;SAuto Next;}
The settings on the Baggage Tab determine whether the selected file type will be included in the compiled help file.
If these files are not included in the help file, you will need to distribute them with the help system.
Click on the Go button to continue.
{NB31N0;SPointer Close;SSet ActiveTab: 5;SEnable All Controls;SAuto Next;}
Put an X in the box to the left of the file type that you want compiled into the help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;SSet ActiveTab: 3;CNCompression1 ;SPointer to Control;SAuto Next;}
The options on the Compression Tab determine the degree and type of compression the compiler will use when you compile the source.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompression2 ;SPointer to Control;SAuto Next;}
The "None" option instructs the compiler not to perform any type of compression on the help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompression3 ;SPointer to Control;SAuto Next;}
Best Possible Radio Button
With this option, the help compiler determines the optimal compression.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompression4 ;SPointer to Control;SAuto Next;}
Maximum Radio Button
This method uses both Hall and Zeck compression. It takes about three times as long to compile a help file with this compression setting.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompressionType1 ;SPointer to Control;SAuto Next;}
Custom Radio Button
Enables customizing the compression options. As you make your selections, options that cannot coexist will be grayed out.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompressionType2 ;SPointer to Control;SAuto Next;}
Hall (Text) Check Box
Hall compression is more effective for files over 100k.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCompressionType3 ;SPointer to Control;SAuto Next;}
Zeck (Text) Check Box
Zeck compression is slightly less effective than Hall by the help file will compile more quickly than with Hall compression.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOldKeyPhrase4 ;SPointer to Control;SAuto Next;}
Phrase (Text) Check Box
Phrase compression, which is more effective than Hall compression for files that are less than 100K in size. The compiler creates a phrase table file with a .PH extension if one does not already exist in the ROOT directory.
This will decrease the compile time significantly if little has changed between compiles. Because the phrase table file speeds up the time to compile the Help file when little text has been changed since the last rebuild, you may want to keep the .PH file around between compiles.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNMapFile1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Map Tab.
A "map" is a file that contains a table of the relationships between context strings and context numbers.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNMapFile2 ;SPointer to Control;SAuto Next;}
The "Put in Project File" option is the default. This causes the Help Magician to write the context sensitivity map to the project (.HPJ) file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CYMapFile3 ;SPointer to Control;SAuto Next;}
Write #include File Radio Button
When this option is selected, the context sensitivity information is written to a separate file (.H). A #include statement is entered in the project (.HPJ) file that references the .H file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Use Existing File Radio Button
When this option is selected, the Help Magician will read the context sensitivity information from a file (.H or .HM) that you will provide. This is usually done when the help author and the programmer are working together on context sensitivity.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Context String Map File Path and Name Text Box
When either "Write #include file" or "Use existing file" are selected, this is where you will enter the name of the file.
You can use the "Browse" button to invoke a file dialog to find the file on your system.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SSet ActiveTab: 6;SEnable All Controls;SAuto Next;}
The Browse Button is used to locate files for entry into the form, in this case, an external map file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 6;CNTxtHelpIndex ;SPointer to Control;SAuto Next;}
The Index Page is the page, or topic, that will be displayed first when your compiled help file is invoked.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNGridHelpIndex ;SPointer to Control;SAuto Next;}
The Index Page Text Box displays the current Index page, if any.
The text box can also be used as a "Locator". When you enter characters, the highlighted list item is selected based on the characters entered.
Click on the Go button to continue.
{NB31N0;SPointer Close;SSet ActiveTab: 10;SEnable All Controls;SAuto Next;}
The Index Page list box displays all of the topics in the current help file for selection as the Index Page.
When an item is selected in this list, the title will be displayed in the Index Page text box.
Click on the Go button to continue.
{NB91N0;SPointer Close;SSet ActiveTab: 7;SEnable All Controls;SAuto Next;}
The Index Page list box displays all of the topics in the current help file for selection as the Index Page.
When an item is selected in this list, the title will be displayed in the Index Page text box.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNCompress ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Miscellaneous Tab.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNOptCDROM(0) ;SPointer to Control;SAuto Next;}
The Compress Help File check box determines whether the help file is compressed during compilation or not.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNOldKeyPhrase(0) ;SPointer to Control;SAuto Next;}
Optimize for CD ROM
This option optimizes the compiled help file for access from a CD-ROM drive.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNCharSet ;SPointer to Control;SAuto Next;}
Use Old Key Phrase File Check Box
This option tells the compiler to use an existing Key Phrase File rather than writing a new one, saving time in the compile process.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNLanguage(1) ;SPointer to Control;SAuto Next;}
Character Set Text Box
Drop down the list by clicking on the button on the right and select the character set for your help system.
Click on the Go button to continue.
{NB31N0;SClose All Forms;SAuto Next;}
Language to base sorting upon Drop Down Box
Drop down the list by clicking on the button on the right and select the language to base sorting upon for your help system.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCharSet1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Fonts Tab.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Default Text Character Set Drop Down Box
Use this drop down box to select the character set that will be used for the fonts in the compiled Help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
Font Name Text Box
Set the font name for the dialog boxes used by WinHelp for your Help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCharSet2 ;SPointer to Control;SAuto Next;}
Font Size Text Box
Set the font size for the dialog boxes used by WinHelp for your Help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CYText1 ;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Char Set Drop Down Box
Set the character set for the dialog boxes used by WinHelp for your Help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CYText2 ;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Other Fonts Button
The Other Fonts Button brings up the Font dialog, from this dialog you would pick another font.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;SSet ActiveTab: 8;SEnable All Controls;CNSorting ;SPointer to Control;SAuto Next;}
Other Sizes Button
The Other Sizes Button brings up the Font dialog, from this dialog you would pick another size for your font.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNLanguage(0) ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Sorting Tab.
The Sort using language Check Box when checked will sort your text by the language you have selected.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNSorting1 ;SPointer to Control;SAuto Next;}
Language to base sorting upon Drop Down Box
If you intend to use a language other than English in your Help file, set that language here. This information is used when sorting keywords in the index.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNSorting2 ;SPointer to Control;SAuto Next;}
Non-spacing marks Check Box
Check the "Non-spacing marks" to ignore spacing.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Symbols Check Box
Check the "Symbols" to ignore symbols.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;SSet ActiveTab: 9;SEnable All Controls;CNGenFTS ;SPointer to Control;SAuto Next;}
Index Entries Separators Text Box
Enter the character used to separate keywords in an entry (for example, "keywords, entering") and the character used to separate keywords in a list. If this option is not used the default comma, semicolon and colon are used.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFTSIncludeTopics ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Text Search Tab.
Generate full text search index Check Box
Check this box to instruct the compiler to generate the index that adds full text search capabilities to your help system.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFTSFunctionality1 ;SPointer to Control;SAuto Next;}
Include untitled topics in index Check Box
Check this box to include untitled topics in the full text search.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFTSFunctionality2 ;SPointer to Control;SAuto Next;}
Search for words only (minimum size) Radio Button
Check this box to minimize the size of the search database by restricting the search to words only.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFTSFunctionality3 ;SPointer to Control;SAuto Next;}
Search for phrases Radio Button
Allows users to search for phrases such as a persons first and last name.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFTSFunctionality4 ;SPointer to Control;SAuto Next;}
Display matching phrases Radio Button
Enables users to see matching phrases as they type them.
This option takes longer to build an index and increases the size of the database.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;SSet ActiveTab: 11;CNOptCDROM(1) ;SPointer to Control;SAuto Next;}
Search for similar topics (max functionality) Radio Button
Enables users to mark help topics for later reference.
This is the highest degree of functionality but it also creates the largest database.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNDisplayNotes ;SPointer to Control;SAuto Next;}
Now let's look at the option on the Miscellaneous Tab.
Optimize for CDROM Check Box
Select this option to instruct the compiler to optimize the Help file for maximum performance when accessed on a CDROM.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNBitmapDirTag ;SPointer to Control;SAuto Next;}
Display Notes Check Box
Select this option to have the compiler display note-level error messages while compiling. Note-level error messages are informational messages to the Help author.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNIgnoreErrorsList ;SPointer to Control;SAuto Next;}
Ignore Errors Text Box
Enter any error message numbers here that you want the compiler to ignore during a build. Key in an error number in the text box and click on the Add Error button to add it to the list. To delete an error number from the list, simply select it in the list and click on the Delete Error button.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdAddError ;SPointer to Control;SAuto Next;}
The Ignore Errors List Box displays the errors you have entered that you want the compiler to ignore during a build.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdDeleteError ;SPointer to Control;SAuto Next;}
The Add Error Button adds the error you have entered in the text box to the list below.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
The Delete Error Button will delete the selected error from the list.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Browse Button can be used on the Map tab when you need to enter a path.
Click on the Go button to continue.
{NB91Y0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
The Accept Button accepts and records the changes you have made.
Click on the Go button to continue.
{NB91N0;SPointer Close;SAuto Next;}
The Cancel Button cancels and does not record the changes you have made.
Click on the Go button to continue.
{NBB5N0}
This concludes the Tour of the Compiler form.
At this point, you can select another category or close the Wizard.
The Create Button form is used to quickly and easily add buttons to the button bar when you help system is viewed with WinHelp.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Button ID: Text Box
This is where you would enter an unique name, or ID for the button in the Button Id field. This name is used internally by WinHelp.Exe and in low level macro programming.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNMacroList ;SPointer to Control;SAuto Next;}
Button Caption: Text Box
This is where you would enter the caption that will appear on the button when the help system is viewed with WinHelp.Exe.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
Macro to Execute: Text Box
You would select the macro to be executed when the button is pressed from the list of macros in the drop down box. The macros selected for this list box are limited to macros that do not require arguments or additional information.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Defined Buttons: List Box
All of the buttons you have created will be listed in the Defined Buttons list box. Clicking on a defined button updates the display of the individual fields for that button. You can edit the fields for any of the defined buttons when the button is selected.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
Add Button
To add a button to the list, fill in the fields as described above and press the Add button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
Delete Button
To delete a button from the list, highlight the entry in the Defined Buttons list box and press the Delete button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton5 ;SPointer to Control;SAuto Next;}
Update Button
To change the definition of a button, edit the fields and press the Update button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton6 ;SPointer to Control;SAuto Next;}
Help Button
Displays the Help Magicians help file beginning at the Create Button page.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNHelpLabel ;SPointer to Control;SAuto Next;}
Close Button
When you are finished creating or editing buttons for the help system, press the Close button. All entries will be recorded in the Macro database.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Help Label
Various quick help messages are displayed in this label as the mouse cursor passes over the controls on the form.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Create Button form.
Select the "Create Button" menu, "Assist: Creating Buttons" sub menu for assistance in creating buttons in your own help file.
The Create Button form is used to quickly and easily add buttons to the button bar when you help system is viewed with WinHelp.
I'm going to assist you in the creation of a button.
Click on the Go button to continue.
{NBB1N296;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
Button ID: Text Box
Enter an unique name, or ID for the button in the Button Id field. The ID can be any alphanumeric string but I recommend that you use a Btn_ prefix before the name of each button.
Enter the ID then click on the Go button to continue.
{NBB1N0;CYMacroList ;SPointer to Control;SFocus Form;SAuto Next;}
Button Caption: Text Box
Enter the caption that will appear on the button when the help system is viewed with WinHelp.Exe.
Enter the caption then click on the Go button to continue.
{NBB1N0;CYList1 ;SPointer to Control;SFocus Form;SAuto Next;}
Macro to Execute: Text Box
Select the macro to be executed when the button is pressed from the list of macros in the drop down box. The macros selected for this list box are limited to macros that do not require arguments or additional information.
Select the macro then click on the
Go button to continue.
{NBB1N0;CNCmdButton1 ;SPointer to Control;SFocus Form;SAuto Next;}
Defined Buttons: List Box
All of the buttons you have created will be listed in the Defined Buttons list box. Clicking on a defined button updates the display of the individual fields for that button. You can edit the fields for any of the defined buttons when the button is selected.
Click on the Go button to continue.
{NBB1N0;CNCmdButton1 ;SPointer to Control;SLeft Mouse Click:;SAuto Next;}
Add Button
Let's add the button we just defined to the list.
I'll click on the Add button for you.
Click on the Go button to continue.
{NBB1N0;CNCmdButton6 ;SPointer to Control;SLeft Mouse Click:;SAuto Next;}
Close Button
When you are finished creating or editing buttons for the help system, press the Close button. All entries will be recorded in the Macro database.
I'll close the form for you.
Click on the Go button to continue.
{NBB5N0}
Congratulations, you have just created a button for the WinHelp button bar.
At this point, you can select another category or close the Wizard.
The Partial Font Boundary to style conversion option determines how font markers in older HLX files are interpreted. When possible individual font and paragraph formatting in Help Magician versions prior to 3.0 are converted to paragraph tags for use in 3.0/3.1. A paragraph is considered to have font formatting only if the font markers completely encompass the paragraph.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNHLXSaveLabel ;SPointer to Control;SAuto Next;}
Now let's look at the options on the File Save Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSpin3 ;SPointer to Control;SAuto Next;}
HLX Save Label
The File Save option specifies the number of HLX files to automatically back up. The range is one through ten.
You would click on the up arrow to increase the number of backups and the down arrow to decrease it.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWinHelpBarCheck ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Display Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNLinkTargetCheck ;SPointer to Control;SAuto Next;}
WinHelp Bar Check Box
Putting an X in the WinHelp Bar Check Box (by clicking on it with the mouse or pressing the space bar when it has focus) adds a WinHelp button bar above the editor on the Help Magician's main form.
Click on the Go button to continue.
{NBB3N0}
Link Target Check Box
This option toggles the display of the target of a link or hot spot when the mouse cursor is moved over the link.
The target page number, if any, is displayed in the page number text box at the bottom left of the main form.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNQuickHelpCheck ;SPointer to Control;SAuto Next;}
Link Target Check Box, cont'd.
The target title or context string or macro, etc. is displayed in the text box to the right of the page number text box. Letters referring to the type of link are displayed with a > symbol to the target.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D1 ;SPointer to Control;SAuto Next;}
Quick Help Check Box
This check box determines whether to display Quick Help, the small yellow window that appears near a control when the mouse passes over the control.
When this option is checked, the nonscrolling region of the editor will be reduced to one line to provide the maximum amount of editor space for the scrolling region.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNWiz1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Image Import Tab.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNWiz1 ;SPointer to Control;SAuto Next;}
Image Size Label
This setting determines the maximum size of the images that will be actually displayed in the Editor and those that will be referenced by file name. The settings are from 0 to 1024k, and 16k increments.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNLinkToFile ;SPointer to Control;SAuto Next;}
Image Size Spin Button
Click on the Up arrow to increase the value and click on the down arrow to decrease it.
Checking this option instructs the Help Magician to store only the image filename in memory and in the HLX but to display the image in the editor. This method is the most efficient in its use memory and disk space.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDefaultParaCheck ;SPointer to Control;SAuto Next;}
Now let's look at the options on the HLX Conversion Tab.
Click on the Go button to continue.
{NBB3N0}
Apply paragraph formatting Check Box.
Since most of the text in the Help file will be default or normal style, you may or may not want the paragraph formatting to be applied to the paragraphs as they are assigned.
If the applied paragraph formatting to default help text is unchecked only the font attributes will be assigned to the paragraphs as the normal or default style is assigned. If this box is checked, both font and paragraph formatting will be assigned to the paragraphs.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDelimitOption1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Word Delimiter Tab.
The Word Delimiter option determines how the Help Magician finds the beginning and end of a word of phrase when establishing a Jump or a Popup.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDelimitOption2 ;SPointer to Control;SAuto Next;}
Punctuation Radio Button
If the Punctuation option is selected, the Help Magician will search from the current cursor position backward and forward until it finds a space or punctuation character and highlight that portion of the word or phrase.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDelimitOption3 ;SPointer to Control;SAuto Next;}
Space Radio Button
If the Space option is selected the Help Magician will search backward and forward until a space is found and highlight that portion of the word or phrase.
If the selected text option is Selected Text, the user must highlight the portion of the word or phrase that will be used as the jump or Popup text. A warning will be issued if this option is selected and no text is highlighted at the time a Jump or a Popup is established.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNKeyConfig1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Keyboard Tab.
There are two possible keyboard configurations provided to maintain compatibility with earlier versions of the Help Magician and to offer the option to use the new standard keystrokes for cut, copy and paste.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNKeyConfig2 ;SPointer to Control;SAuto Next;}
Configuration 1 Radio Button
Configuration 1 maintains compatibility with earlier versions of the Help Magician:
Configuration 2 provides compatibility with the new cut, copy, and paste keystrokes:
Cut = Ctrl+X Copy = Ctrl+C
Paste = Ctrl+V View/Modify = Ctrl+M
Exit = Ctrl+R
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRightMouseOption1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Mouse Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRightMouseOption2 ;SPointer to Control;SAuto Next;}
Ignore Right Mouse Button Radio Button.
The Ignore Right Mouse Button option is provided to avoid conflicts with certain mouse drivers that provide right mouse button functionality such as left button double click.
By default, the right mouse button is used to quickly bring up the appropriate form to modify a hot link or the attributes of an included image. Uncheck this box to disable this feature.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTickColorCmd1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Tab Ruler Tab.
The default tab ticks visibility is dependent on the quality of the monitor, the display resolution, etc. An option to change the colors used to display the ticks provides visibility on all systems.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTickColorCmd2 ;SPointer to Control;SAuto Next;}
The Inner Button allows you to change the color of the inner tick.
A segment of the ruler and an enlarged view of the ticks displays the changes as you make them.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDisplayCursorLine ;SPointer to Control;SAuto Next;}
The Outer Button allows you to change the color of the outer ticks.
A segment of the ruler and an enlarged view of the ticks displays the changes as you make them.
This check box toggles the display of the cursor line in the ruler. When checked, a vertical line tracks the mouse cursor, showing its location in the tab ruler.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWarningLevelOpt1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Warnings Tab.
Click on the Go button to continue.
{NBB3N0}
Image Field and Hot Tag Warnings Radio Button.
Hot spots and image fields must be separated by at least one space. Image fields cannot be modified in the editor. Their attributes must be modified from the Links menu, View/Modify (right mouse button) sub menu. Note: The Esc key will detach the cursor from a hot spot or image field.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNWarningLevelOpt2 ;SPointer to Control;SAuto Next;}
Image Field and Hot Tag Warnings Radio Button, cont'd.
By default, warnings are issued when you attempt to type inside one of these fields. On hot spots, you have the option to edit the text, detach the cursor from the hot spot, or to cancel. On image fields, you can only select OK and the cursor will be detached from the image field.
If this option is checked, the Help Magician will start at the same screen location and size that existed the last time you exited the program.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextDisplayOpt1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Context Numbers Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextDisplayOpt2 ;SPointer to Control;SAuto Next;}
Display as Decimal Radio Button.
This option will show Context Numbers in the Context Numbers box just above the editor as decimal.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextDisplayOpt3 ;SPointer to Control;SAuto Next;}
Display as C Hex (Ox) Radio Button
This option will show Context Numbers in the Context Numbers box just above the editor as C-style hexadecimal (0x).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCloseCmd ;SPointer to Control;SAuto Next;}
Display as Basic Hex (&H) Radio Button
This option will show Context Numbers in the Context Numbers box just above the editor as Basic-Style hexadecimal (&H).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNHelpCmd ;SPointer to Control;SAuto Next;}
The Close Button will accept and record the changes made.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
The Help Button will give specific help on this topic.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Environment Options form.
Select the "Environment Options" menu, "Assist: Setting Environment Options" sub menu for assistance in setting the environment options for your system.
The Partial Font Boundary to style conversion option determines how font markers in older HLX files are interpreted. When possible individual font and paragraph formatting in Help Magician versions prior to 3.0 are converted to paragraph tags for use in 3.0/3.1. A paragraph is considered to have font formatting only if the font markers completely encompass the paragraph.
Click on the Go button to continue.
{NBB1N0;CNHLXSaveLabel ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the File Save Tab.
Click on the Go button to continue.
{NBB1N0;CNSpin3 ;SPointer to Control;SFocus Form;SAuto Next;}
HLX Save Label
The File Save option specifies the number of HLX files to automatically back up. The range is one through ten.
You would click on the up arrow to increase the number of backups and the down arrow to decrease it.
Click on the Go button to continue.
{NBB1N0;CNWinHelpBarCheck ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Display Tab.
Click on the Go button to continue.
{NBB1N0;CNLinkTargetCheck ;SPointer to Control;SFocus Form;SAuto Next;}
WinHelp Bar Check Box
Putting an X in the WinHelp Bar Check Box (by clicking on it with the mouse or pressing the space bar when it has focus) adds a WinHelp button bar above the editor on the Help Magician's main form.
Click on the Go button to continue.
{NBB3N0}
Link Target Check Box
This option toggles the display of the target of a link or hot spot when the mouse cursor is moved over the link.
The target page number, if any, is displayed in the page number text box at the bottom left of the main form.
Click on the Next -->> button to continue.
{NBB1N0;CNQuickHelpCheck ;SPointer to Control;SFocus Form;SAuto Next;}
Link Target Check Box, cont'd.
The target title or context string or macro, etc. is displayed in the text box to the right of the page number text box. Letters referring to the type of link are displayed with a > symbol to the target.
Click on the Go button to continue.
{NBB1N0;CNCheck3D1 ;SPointer to Control;SFocus Form;SAuto Next;}
Quick Help Check Box
This check box determines whether to display Quick Help, the small yellow window that appears near a control when the mouse passes over the control.
Minimize Non Scrolling Region when Scrolling Region has focus Check Box
When this option is checked, the nonscrolling region of the editor will be reduced to one line to provide the maximum amount of editor space for the scrolling region.
Click on the Go button to continue.
{NBB1N296;CNWiz1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Image Import Tab.
Click on the Go button to continue.
{NBB1N296;CNWiz1 ;SPointer to Control;SFocus Form;SAuto Next;}
Image Size Label
This setting determines the maximum size of the images that will be actually displayed in the Editor and those that will be referenced by file name. The settings are from 0 to 1024k, and 16k increments.
Click on the Go button to continue.
{NBB1N0;CNLinkToFile ;SPointer to Control;SFocus Form;SAuto Next;}
Image Size Spin Button
Click on the Up arrow to increase the value and click on the down arrow to decrease it.
Stores only the image filename in memory and in the HLX but displays the image in the editor. This method is a compromise between the two methods described above.
Click on the Go button to continue.
{NBB1N0;CNDefaultParaCheck ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the HLX Conversion Tab.
Click on the Go button to continue.
{NBB3N0}
Apply paragraph formatting to Default help text Check Box.
Since most of the text in the Help file will be default or normal style, you may or may not want the paragraph formatting to be applied to the paragraphs as they are assigned.
Apply paragraph formatting to Default help text Check Box
If the applied paragraph formatting to default help text is unchecked only the font attributes will be assigned to the paragraphs as the normal or default style is assigned. If this box is checked, both font and paragraph formatting will be assigned to the paragraphs.
Click on the Go button to continue.
{NBB1N0;CNDelimitOption1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Word Delimiter Tab.
The Word Delimiter option determines how the Help Magician finds the beginning and end of a word of phrase when establishing a jump or a Popup.
Click on the Go button to continue.
{NBB1N0;CNDelimitOption2 ;SPointer to Control;SFocus Form;SAuto Next;}
Punctuation Radio Button
If the punctuation option is selected, the Help Magician will search from the current cursor position backward and forward until it finds a space or punctuation character and highlight that portion of the word or phrase.
Click on the Go button to continue.
{NBB1N0;CNDelimitOption3 ;SPointer to Control;SFocus Form;SAuto Next;}
Space Radio Button
If the space option is selected the Help Magician will search backward and forward until a space is found and highlight that portion of the word or phrase.
If the selected text option is selected the user must highlight the portion of the word or phrase that will be used as the jump or Popup text. A warning will be issued if this option is selected and no text is highlighted at the time a jump or a Popup is established.
Click on the Go button to continue.
{NBB1N0;CNKeyConfig1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Keyboard Tab.
There are two possible keyboard configurations provided to maintain compatibility with earlier versions of the Help Magician and to offer the option to use the new standard keystrokes for cut, copy and paste.
Click on the Go button to continue.
{NBB1N0;CNKeyConfig2 ;SPointer to Control;SFocus Form;SAuto Next;}
Configuration 1 Radio Button
Configuration 1 maintains compatibility with earlier versions of the Help Magician:
Configuration 2 provides compatibility with the new cut, copy, and paste keystrokes:
Cut = Ctrl+X Copy = Ctrl+C
Paste = Ctrl+V View/Modify = Ctrl+M
Exit = Ctrl+R
Click on the Go button to continue.
{NBB1N0;CNRightMouseOption1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Mouse Tab.
Click on the Go button to continue.
{NBB1N0;CNRightMouseOption2 ;SPointer to Control;SFocus Form;SAuto Next;}
Ignore Right Mouse Button Radio Button.
The Ignore Right Mouse Button option is provided to avoid conflicts with certain mouse drivers that provide right mouse button functionality such as left button double click.
This check box toggles the display of the cursor line in the ruler. When checked, a vertical line tracks the mouse cursor, showing its location in the tab ruler.
Click on the Go button to continue.
{NBB1N0;CNWarningLevelOpt1 ;SPointer to Control;SFocus Form;SAuto Next;}
Now let's look at the options on the Warnings Tab.
Click on the Go button to continue.
{NBB1N0;CNWarningLevelOpt2 ;SPointer to Control;SFocus Form;SAuto Next;}
Image Field and Hot Tag Warnings Radio Button.
Hot spots and image fields must be separated by at least one space. Image fields cannot be modified in the editor. Their attributes must be modified from the Links menu, View/Modify (right mouse button) sub menu.
Note: The Esc key will detach the cursor from a hot spot or image field.
By default, warnings are issued when you attempt to type (including the Return key) inside one of these fields. On hot spots, you have the option to edit the text, detach the cursor from the hot spot, or to cancel. On image fields, you can only select OK and the cursor will be detached from the image field.
The Export for is used to convert the Help Magician's source data to text or RTF format. We'll look at the options regarding these formats.
Click on the Go button to continue.
{NBB3N0}
Text with Header Radio Button
The title, keywords, multiple keywords, context number, Browse group and the topics included in the Browse group will be written to the file before the help text on every page.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNrbTxtNoHeader ;SPointer to Control;SAuto Next;}
Text with Header Radio Button, cont'd.
Each section is preceded by a header (\Title:, \Keywords:, \Multiple Keywords:, \Context Number:, and \Browse:). The keywords and multiple keywords are separated with commas. The Browse group is separated from the included topics by a colon.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNrbRTF ;SPointer to Control;SAuto Next;}
Text without Header Radio Button
Without the header, only the caption, Title: and the title are included for each page.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNrbWord(0) ;SPointer to Control;SAuto Next;}
RTF Radio Button
The Export RTF option will write an RTF file for the purpose of importing into a word processor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNrbWord(1) ;SPointer to Control;SAuto Next;}
MS Word 2.0/6.0/7.0 Radio Button
Select the version of Word for Windows that you intend to use to import the RTF file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNrbWord(2) ;SPointer to Control;SAuto Next;}
Ami Pro Radio Button
Select this radio button if you intend to import the RTF file into Ami Pro.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNchkNoHelpFormat ;SPointer to Control;SAuto Next;}
Word Perfect Radio Button
Select this radio button if you intend to import the RTF file into Word Perfect for Windows.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNchkNoBitmaps ;SPointer to Control;SAuto Next;}
Omit Help Formatting Information Check Box
If the Omit Help Formatting Information check box is checked, the help formatting such as the hyperlinks for Jumps and Popups will not be written to the RTF file. The resulting RTF file is more suitable for converting a help file to a manual.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNchkNoPageBreaks ;SPointer to Control;SAuto Next;}
Omit Bitmaps Check Box
If the Omit Bitmaps check box is checked, the images in the help source file will not be written to the RTF file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNcmdAccept ;SPointer to Control;SAuto Next;}
Omit Page Breaks Check Box
If this option is checked, hard page breaks will not be written to the RTF file. Your word processor will separate the pages with soft page breaks. You can, of course, add hard page breaks as needed in your word processor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNcmdHelp ;SPointer to Control;SAuto Next;}
The Accept Button accepts and records the changes you made.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNcmdCancel ;SPointer to Control;SAuto Next;}
The Help Button gives specific help on this topic.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
The Cancel Button cancels and does not record the changes you made.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Export form.
At this point, you can select another category or close the Wizard.
The Find/Replace form is used to find and/or replace words or phrases in your help file.
The same form is used for both purposes and controls that do not pertain to the current use would be disabled.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSearchText ;SPointer to Control;SAuto Next;}
All controls are enabled for the purpose of the tour.
We'll look at the search and replace drop down boxes first, then we'll look at the search/replace options.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNClearCmd0 ;SPointer to Control;SAuto Next;}
Find What: drop down box.
You can enter the text to be searched for in the text box or click on the down arrow to drop down a list of the last 10 words entered.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNReplaceText ;SPointer to Control;SAuto Next;}
Find What: Clear Button
The "Clear" button will clear the list of the last 10 words entered.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNClearCmd1 ;SPointer to Control;SAuto Next;}
Replace With: Drop Down box.
This functions the same as the search drop down box.
When in Replace mode, enter the replace text or select from up to 10 of the last words entered.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck1 ;SPointer to Control;SAuto Next;}
Replace With: Clear Button
The "Clear" button will clear the list of the last 10 words entered.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D1 ;SPointer to Control;SAuto Next;}
Whole Word Check Box
The Whole Word option is used to limit the search to a complete word, with a space or punctuation mark on either side.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRemoveHotLink ;SPointer to Control;SAuto Next;}
Beginning of File Check Box
This option is enabled only if the "All Topics" option is selected. This forces the search to start at the beginning of the file rather than the current topic at the current cursor location.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCurrentTopic ;SPointer to Control;SAuto Next;}
Remove Hot Link Check Box
When this check box is checked, no text will be replaced but the hot link for all occurrences of the word specified in the "Find What" text box will be removed.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAllTopics ;SPointer to Control;SAuto Next;}
Current Topic Radio Button
Selecting this radio button restricts the search or replace to the current topic or help page.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNInsensitive ;SPointer to Control;SAuto Next;}
All Topics Radio Button
Select this radio button to search or replace in all of the topics in the help file.
This radio button enables the "Beginning of File" check box. When checked, the search begins at the first topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSensitive ;SPointer to Control;SAuto Next;}
Insensitive Radio Button
Select this radio button if you want the search to ignore the case of the search text and the words found.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNVerify ;SPointer to Control;SAuto Next;}
Sensitive Radio Button
This radio button causes the search to compare words or phrases by case. The text searched my match exactly, including case, to be considered a match.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNReplaceAll ;SPointer to Control;SAuto Next;}
Verify Radio Button
If the "Verify" radio button is selected, you will be prompted to verify the replacement each time the search text is found.
This radio button is only enabled in "Replace" mode.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Replace All Radio Button
When this radio button is selected, all occurrences of the search text will be replaced without stopping for confirmation.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
Accept Button
When you have entered the search text and the replace text, when in replace mode, press the Accept button to initiate the search.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Cancel Button
Pressing the Cancel button cancels the search or replace operation and none of the settings are saved.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Find/Replace form.
Select the "Find/Replace" menu, "Assist: Finding/Replacing Text" sub menu for assistance in finding and replacing text in your own help file.
[Finding/Replacing Text]
{NBB1N0;SWant File in Editor: True;SAuto Hide Wizard: True;S'Show Form: ReplaceForm;SActivate Menu: &Edit, &Find;SWait For Form: ReplaceForm;SAuto Hide Wizard: False;SAuto Next;}
Finding/Replacing Text
I am going to assist you in the use of the Find/Replace form.
You can access the Find/Replace form with the Edit menu or use the hot key CTRL+F3 for Find and Shift+Ctrl+F3 for Replace. We're going to use the menu.
Click on the Go button to continue.
{NBB1N0;CYSearchText ;SPointer to Control;SFocus Form;SAuto Next;}
To find text, you type the word you are searching for in the Find What: text box. The search text can be part or all of a word or phrase.
The last 10 search words are saved and can be accessed by clicking on the down arrow and selecting the word.
Click on the Go button to continue.
{NBB1N0;CYCheck1 ;SPointer to Control;SFocus Form;SAuto Next;}
Please enter the search text now.
DON'T PRESS RETURN.
When you're done, click on the Go button to continue.
{NBB1N0;CNFrame1 ;SPointer to Control;SFocus Form;SAuto Next;}
Next, set the options for the search.
Check the Whole Word option if you want to limit the search to a complete word, with a space or punctuation mark on either side.
When you're done, click on the Go button to continue.
{NBB1N0;CNFrame2 ;SPointer to Control;SFocus Form;SAuto Next;}
Select one of the Search radio buttons. If "Current Topic" is selected, the search will be confined to the current help page.
If "All Topics" is selected, the "Beginning of File" check box will become enabled.
When you're done, click on the Go button
to continue.
{NBB1N0;CNFrame3 ;SPointer to Control;SFocus Form;SAuto Next;}
Select one of the "Case" radio buttons. If you choose Insensitive, the search text will be compared with the text being searched without regard for case.
If you choose Sensitive, the text must match exactly, with regard to the case.
When you're done, click on the Go button
to continue.
{NBB3N0}
The "Condition" options are only used when the form is in "Replace" mode.
If you select "Verify", you will be asked to confirm each replacement.
The Help Magician can import eight different image types:
bmp, gif, ico, pcx, shg, tga, tif, and wmf.
A special file dialog with preview capabilities is used when selecting image files.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFIL_Files ;SPointer to Control;SAuto Next;}
File name: Text Box
This text box will contain either the wildcard specifications for the selected image type (*.bmp) or the name of the currently selected file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCombo1 ;SPointer to Control;SAuto Next;}
The File name: List Box lists all the files of the selected type in the current directory.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDIR_Dirs ;SPointer to Control;SAuto Next;}
List Files of type: Drop Down Box
Select the type of image files to list by clicking on the down arrow under the List Files of Type: label and clicking on the desired file type.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDRV_Drives ;SPointer to Control;SAuto Next;}
The Folders: List Box is used to select the working directory on the selected drive.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNPicBuf1 ;SPointer to Control;SAuto Next;}
The Drives: Drop Down Box is used to select the working drive on your system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand1 ;SPointer to Control;SAuto Next;}
Picture Preview Box
When Auto mode is selected, the currently selected image file will be expanded or shrunk to fit this picture box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNPreviewStateButton ;SPointer to Control;SAuto Next;}
Preview Button
When an image is selected in the file list box, it may be previewed in its actual size by pressing the Preview button, which brings up the image viewer.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBTN_Ok ;SPointer to Control;SAuto Next;}
Auto Button
Clicking on the Auto/Manual button toggles the state of the button. In Auto mode, the images will be displayed in the sample window as they are selected in the file list box. In Manual mode, they will not be displayed as they are selected in the file list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBTN_Cancel ;SPointer to Control;SAuto Next;}
The OK Button accepts and records the changes you made.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D1 ;SPointer to Control;SAuto Next;}
The Cancel Button cancels the operation and does not insert an image into the editor.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
The Help Button gives you specific help on this topic.
Click on the Go button to continue.
{NBB5N52}
This concludes the tour of the Image File Dialog.
At this point, you can select another category or close the Wizard.
The Picture Options form offers options for the Orientation, Display, and Storage of the selected image.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptAlignment(0) ;SPointer to Control;SAuto Next;}
The Filename Label displays the name of the graphic that you are working with.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptAlignment(1) ;SPointer to Control;SAuto Next;}
Character Radio Button
When character orientation is selected, the image will act as any other character in the text.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptAlignment(2) ;SPointer to Control;SAuto Next;}
Left Margin Radio Button
Left orientation will cause the image to stay at the left margin regardless of the flow of the text.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptStorage(0) ;SPointer to Control;SAuto Next;}
Right Margin Radio Button
Right orientation will cause the image to stay at the right margin regardless of the flow of the text.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptStorage(1) ;SPointer to Control;SAuto Next;}
Normal Radio Button
When Normal storage is selected, the data for the image is stored only once in the compiled help file even if the image is used many times. This can result in a slightly slower display time but it reduces the size of the compiled help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptStorage(2) ;SPointer to Control;SAuto Next;}
Inline Radio Button
When Inline storage is selected, the data for the image is stored for each occurrence of the image in the compiled help file. This method produces a faster display of the image but results in a larger compiled help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D1 ;SPointer to Control;SAuto Next;}
Embedded Window Radio Button
When Embedded is selected, the image will be displayed in an embedded window in the topic. This is used primarily for 256 color bitmaps.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptDisplay(0) ;SPointer to Control;SAuto Next;}
Include in Baggage Section Check Box
The Include in Baggage section is used to force the compiler to store the bitmaps in the baggage section of the Help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptDisplay(1) ;SPointer to Control;SAuto Next;}
Show Picture Radio Button
Select the Show Picture option to include the image data in memory and in the HLX (Help Magician source) file. This method produces the fastest load and display but uses the most memory and disk space.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptDisplay(2) ;SPointer to Control;SAuto Next;}
Show Filename Radio Button
When the Show Filename option is selected, the image will not be displayed in the editor, it will not be stored in memory, and it will not be stored in the HLX file. The image filename will be displayed in the editor in red text. The compiled help file will show the image, however.
Click on the Go button to continue.
{NBB3N0}
Link to File Radio Button
The Link to File option provides the best combination of performance, memory conservation, and disk space usage.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand1 ;SPointer to Control;SAuto Next;}
Link to File Radio Button (cont'd)
The data for the image is not stored in the HLX file and the data for images is only stored in memory when the topic containing the image is displayed. Images for other topics are not kept in memory.
Click on the Go button to continue.
{NNB1N0;SDon't Move Cursor;CNCommand2 ;SPointer to Control;SAuto Next;}
The OK Button accepts and records the changes you made.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
The Cancel Button cancels and does not record the changes you made.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Picture Options form.
At this point, you can select another category or close the Wizard.
[Screen Capture Form Tour]
{NBB1Y282;TScreen Capture Form Tour;SAuto Hide Wizard: True;SAuto Disable Form: True;SShow Form: ScrnCap;SWait For Form: ScrnCap;SEnable All Controls;SDon't Move Cursor;CNLabel1 ;SPointer to Control;SAuto Hide Wizard: False;SAuto Next;}
Capture Image Form Tour
The Capture Image form provides the functionality to capture the screen, a selected area of the screen, or a selected window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(1) ;SPointer to Control;SAuto Next;}
When the Window radio button is selected, the Display Label displays the name of the control or window that the cursor is on.
When the Selected Area radio button is selected the Display label displays the coordinates of the selected area.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(2) ;SPointer to Control;SAuto Next;}
Screen Radio Button
When the Screen option is selected, the entire screen will be captured. Note that this will be an extremely large bitmap.
Click on the Go button to continue.
{NBB3N0}
Window Radio Button
The Capture Image tool defaults to Window as the area to be captured. As the mouse is moved around the screen, a frame is drawn around the window under the mouse cursor. To select a window to capture, move the cursor to the window and click on it with the left mouse button.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(3) ;SPointer to Control;SAuto Next;}
Window Radio Button (cont'd)
Note that the Capture and Insert buttons will not be enabled until a window has been selected. As the mouse cursor is moved, the Window ID and some or all of the Window text is displayed in a frame at the top of the Capture image form.
Click on the Go button to continue.
{NBB3N0}
Selected Area Radio Button
To capture a selected region of the screen, select the Selected Area option, move the mouse cursor to the top left corner of the desired area, hold down the left mouse button, drag the cursor to the bottom right corner of the desired area, and release the mouse button.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNOption2(1) ;SPointer to Control;SAuto Next;}
Selected Area Radio Button (cont'd)
Note that the Capture and Insert buttons will not be enabled until an area has been selected. As the mouse cursor is moved, the X and Y coordinates of the cursor are displayed in a frame at the top of the Capture image form.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption2(2) ;SPointer to Control;SAuto Next;}
16 Colors Radio Button
By default, the image will be saved in the color depth of the host system but images with a color depth of more than 256 colors are not supported by the help compiler or the Capture tool so you will have to save the image as 16 or 256 colors.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption2(3) ;SPointer to Control;SAuto Next;}
256 Colors Radio Button
By default, the image will be saved in the color depth of the host system but images with a color depth of more than 256 colors are not supported by the help compiler or the Capture tool so you will have to save the image as 16 or 256 colors.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCaptureCmd ;SPointer to Control;SAuto Next;}
The As Is Radio Button if selected will save the image in its current color depth.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNInsertCmd ;SPointer to Control;SAuto Next;}
Capture Button
When the area to be captured has been defined, click on the Capture button. A file dialog will prompt for a filename for the bitmap. Enter the filename and click on OK. The image will be saved to disk.
Click on the Go button to continue.
{NBB3N0}
Insert Button
Click on the Insert button to insert the image into the Help Magician's editor. The Help Magician's main window will be restored to its previous state and the Image Options dialog will pop up.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNHelpCmd ;SPointer to Control;SAuto Next;}
Insert Button (cont'd)
Select the image options and click on OK. The image will be inserted into the editor. If the image was saved with 256 colors, the image will automatically be inserted as an embedded window (Windows 3.1).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCloseCmd ;SPointer to Control;SAuto Next;}
The Help Button will display the Help Magician's own help file specific to this topic.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Close Button
Click on the Close button to close the Capture tool without capturing or saving an image.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Screen Capture form.
Because of the simplicity of the form, no Assist category is available.
At this point, you can select another category or close the Wizard.
The Import form provides the ability to import data from other sources to be included in your help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportText ;SPointer to Control;SAuto Next;}
The first option you'll have to set is the File Type.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportRTF ;SPointer to Control;SAuto Next;}
Text (.TXT) Radio Button
Select the "Text" option if the data is not formatted. Most word processors have the ability to output documents as text.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption3D1 ;SPointer to Control;SAuto Next;}
Rich Text Format (.RTF) Radio Button
Select the "RTF" option if the data is in RTF format. Again, most word processors have the ability to output documents as RTF. This option keeps the formatting that was applied in the word processor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption3D2 ;SPointer to Control;SAuto Next;}
Keep Returns Radio Button
The "Keep Returns" option means that the Help Magician will maintain the carriage returns in the imported text. This assumes that there are soft returns within a paragraph and hard returns only at the end of a paragraph.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportAppend ;SPointer to Control;SAuto Next;}
Delete Returns Radio Button
The "Delete Returns" option will remove carriage returns except when they are found in pairs of two or more.
This would be used if the original document has hard returns at the end of each line to achieve word wrapping.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportReplace ;SPointer to Control;SAuto Next;}
Append to current file Radio Button
This option is only available if the "Text" File Type option is selected. The imported text will be "appended" to the help file in memory.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportOptions0 ;SPointer to Control;SAuto Next;}
Replace current file Radio Button
This option is forced to checked if the "RTF" File Type" is selected and optional if the "Text" File Type is selected. You will have the opportunity to save the file in memory, if necessary.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportOptions1 ;SPointer to Control;SAuto Next;}
Read from HLX Radio Button
Options that are not written to the RTF file include the Compiler Options, the Appearance Options, the bitmap directories, macros, and window definitions. This radio button instructs the import function to get the "Project Options" from the HLX file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioImportOptions2 ;SPointer to Control;SAuto Next;}
Read form HPJ Radio Button
This radio button instructs the import function to extract the "Project Options" from the HPJ file. This would be useful when importing the RTF from another help authoring system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdImportAccept ;SPointer to Control;SAuto Next;}
Read RTF Only Radio Button
This option instructs the import function to ignore the "Project Options" in both the HLX and the HPJ files.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D1 ;SPointer to Control;SAuto Next;}
Accept Button
When you have set all the options, press the "Accept" button. A file dialog will prompt for the name of the file to be imported.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdImportCancel ;SPointer to Control;SAuto Next;}
Help Button
The "Help" button calls the Help Magicians own help file and displays the Import topic.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Cancel Button
Use the "Cancel" button to abort the entire import process and return to the editor.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Import form.
Select the "Import" menu, "Assist: Importing files" sub menu for assistance in importing files in your own help file.
[Importing Files]
{NBB1N101;SWant File in Editor: False;SAuto Hide Wizard: True;S'Show Form: ImportForm;SActivate Menu: &File, &Import;SWait For Form: ImportForm;SAuto Hide Wizard: False;SAuto Next;}
Importing Files
I going to assist you in the use of the Import form. I'll call the form for you from the File menu.
Click on the Go button to continue.
{NBB1N0;CYFrame3D1 ;SPointer to Control;SFocus Form;SAuto Next;}
First, we'll set all of the options for the import.
Click on the Go button to continue.
{NBB1N0;CYFrame3D3 ;SPointer to Control;SFocus Form;SAuto Next;}
File Type
Select the File Type, Text or RTF. Generally, the extension of the file determines its file type.
When you have made your selection, click on the Go button to continue.
{NBB3N0}
Text Import Options
If you selected Text as the File Type, you'll need to pick one of the "Text Import" options.
Click on the Next -->> button to continue.
{NBB3N0}
Keep Returns Radio Button
The "Keep Returns" option means that the Help Magician will maintain the carriage returns in the imported text. This assumes that there are soft returns within a paragraph and hard returns only at the end of a paragraph.
Click on the Next -->> button to continue.
{NBB1N0;CNFrame3D2 ;SPointer to Control;SFocus Form;SAuto Next;}
Delete Returns Radio Button
The "Delete Returns" option will remove carriage returns except when they are found in pairs of two or more.
This would be used if the original document has hard returns at the end of each line to achieve word wrapping.
Click on the Go button to continue.
{NBB3N0}
If enabled, select one on the Text Import options now.
When you're done, click on the Next -->> button to continue.
{NBB1N0;CNFrame3D4 ;SPointer to Control;SFocus Form;SAuto Next;}
Import Option
The "Append to current file" option will only be enabled if you selected the "Text" File Type. This option is forced to "Replace current file" if the file type is RTF.
Make your selection and click on the Go button to continue.
{NBB3N0}
RTF Import Options
These options will only be enabled if the selected file type is RTF.
Click on the Next -->> button to continue.
{NBB3N0}
Read from HLX Radio Button
Options that are not written to the RTF file include the Compiler Options, the Appearance Options, the bitmap directories, macros, and window definitions. This radio button instructs the import function to get the "Project Options" from the HLX file.
Click on the Next -->> button to continue.
{NBB3N0}
Read form HPJ Radio Button
This radio button instructs the import function to extract the "Project Options" from the HPJ file. This would be useful when importing the RTF from another help authoring system.
Click on the Next -->> button to continue.
{NBB1N0;CNCmdImportAccept ;SPointer to Control;SFocus Form;SAuto Next;}
Read RTF Only Radio Button
This option instructs the import function to ignore the "Project Options" in both the HLX and the HPJ files.
If enabled, select one of the options and click on the Go button to continue.
If you're satisfied with the options, click on the Accept button. This will bring up a file dialog from which you will select the file to import.
When you're done, click on the Go button to continue.
{NBB5N0}
Congratulations, you have imported a file into the Help Magician.
You can use any of the other categories to assist you in making a help file out of the imported data.
[Jump Form Tour]
{NBB1Y50;TJump Form Tour;SAuto Hide Wizard: True;SShow Form: SelJump;SForm Caption: Select Topic to 'Jump To';SPause: 1;SEnable All Controls;SAuto Disable Form: True;SAuto Hide Wizard: False;SAuto Next;}
A Tour of the Jump Form
The Jump (and Popup) form can be invoked in several different ways, by selecting Jump or Popup from the Links menu, by pressing the hot keys Ctrl+J and Ctrl+P, or by clicking on the J and P buttons in the toolbar.
Click on the Go button to continue.
{NBB3N0}
When actually creating a link, you would first select the text in the editor. The Jump form title bar would then display the type of link (jump or popup) and the selected text.
Since we're only touring the Jump form, this does not apply.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;K%d;CNJumpButtons0 ;SPointer to Control;SDon't Move Cursor;CNLabel1 ;SControl Caption: Select Help Topic:;SAuto Next;}
The index tab in the upper left hand corner of the window contains a number of options for the link.
First, I'll explain the option on the "Destination" tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNGrid1 ;SPointer to Control;SAuto Next;}
Click on the "Help Topic" radio button to select a topic in the current help file as the target for the link.
The caption will be "No Topics Available" if there are no topics in the current file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNJumpButtons1 ;SPointer to Control;SDon't Move Cursor;CNLabel1 ;SControl Caption: Select Help File:;SAuto Next;}
When you select "Help Topic", you will select a topic in the current help file from the list box to the right.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTxtHelpFilename ;SPointer to Control;SAuto Next;}
Click on the "Other Help File" radio button to select a topic in another compiled help file as the target for the link.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTxtCString ;SPointer to Control;SAuto Next;}
When you select "Other Help File", you will have to enter the help file name that will be called when the link is executed.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNJumpButtons2 ;SPointer to Control;SDon't Move Cursor;CNLabel1 ;SControl Caption: Select Macro Definition to Execute;SAuto Next;}
You will also have to enter the context string of the topic to be displayed.
Jumping to another help file is a slightly more advanced function and not nearly as common as jumping to a help topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNGrid1 ;SPointer to Control;SAuto Next;}
Click on the "Defined Macro" radio button to select a Macro Definition in the current help file as the target for the link.
When you select "Other Source", you will have to enter the context string for the desired target topic in the other source file or other Project member.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNGrid1 ;SPointer to Control;SAuto Next;}
Click on the "Mid Topic" radio button to select a mid topic context string as the target for the link.
Click on the Go button to continue.
{NB31N0;SDon't Move Cursor;CNJumpButtons6 ;SPointer to Control;SAuto Next;}
When you select "Mid Topic", you will have to select the mid topic context string for the desired target topic in the list box to the right.
When you select "Mid Topic", you will have to select the mid topic context string for the desired target topic in the list box to the right.
Click on the Go button to continue.
{NBB3N0}
When the URL Address destination is selected, you will be required to enter a URL Address as the target for the jump. Enter the address exactly as you would in your net browser (http://www.whatever.com/web_page/).
If you have previously entered web addresses, they will be displayed in the listbox.
Click on the Next -->> button to continue.
{NB91N296;SWin95 Only;SDon't Move Cursor;CNJumpButtons5 ;SPointer to Control;SAuto Next;}
When URL Address destination is selected, you will be required to enter a URL Address as the target for the jump. Enter the address exactly as you would in your net browser (http://www.whatever.com/web_page/).
If you have previously entered web addresses, they will be displayed in the listbox.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNGrid1 ;SPointer to Control;SAuto Next;}
Windows 95 Only.
Click on the "Keyword" radio button to select a keyword in the current source as the target for the link.
Click on the Go button to continue.
{NB93N0}
Windows 95 Only.
When you select "Keyword", you will select the keyword for the desired target from the list box on the right.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;K%p;CNDisplayButtons1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Display tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDisplayButtons2 ;SPointer to Control;SAuto Next;}
Click on the "Color and Underline" radio button to accept the Windows default formatting for jumps (or popups).
Jumps will be green text with green underlining and popups will be green text with dotted underlining.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNDisplayButtons3 ;SPointer to Control;SAuto Next;}
Click on the "No Color" radio button to display the link without the default green color. The text maintain the color of the formatting in the editor and it will still be underlined.
Click on the Go button to continue.
{NBB3N0}
Click on the "No Color or Underlining" radio button to display the link without the default green text and the underlining.
The text will maintain the formatting as seen in the editor.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;K%s;CNThisOccurrenceOnly ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Scope tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOnePerTopic ;SPointer to Control;SAuto Next;}
Select the "This Occurrence" radio button to establish a single link between the text selected in the editor and the target destination.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAllOccurrences ;SPointer to Control;SAuto Next;}
Select the "One Per Topic" radio button to establish a link between one occurrence of the currently selected text on each page of the help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CYJumpCase ;SPointer to Control;SAuto Next;}
Select the "All Occurrences" radio button to establish a link between all occurrences of the currently selected text on every page of the help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CYTxtLocator ;SPointer to Control;SAuto Next;}
Put an X in the "Case Sensitive" check box to limit the search for matching text for a multiple link to text with the same upper/lower case.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNGrid1 ;SPointer to Control;SAuto Next;}
This is a locator field, used on many forms in the Help Magician.
It helps you locate topic titles, context strings, or anything else that could be in the list box below it by moving the highlighted bar to the selection that matches the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNComboSecWin ;SPointer to Control;SAuto Next;}
As discussed earlier, this list box displays your choices of targets for a link based on the radio button selected on the left.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNChkDispWindow ;SPointer to Control;SAuto Next;}
This drop down box will contain a list of windows for the target topic to be displayed in.
These windows must be pre-defined with the Windows dialog, available from the Options menu on the main form.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
Check this box to instruct the Help Magician to display the target topic in the window selected in the drop down box.
Without a check in this box, all topics are displayed in the "Main" window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The "Browse" button will only be enabled when applicable. It will bring up a file dialog from which you can choose a file for the destination of a link.
Click on the Go button to continue.
{NBB3N0}
The "Preview" button will only be enabled when applicable. It will display the topic currently selected in the list box for your reference.
Click on the Next -->> button to continue.
{NBB3N0}
The "Help" button will display the Help Magician's own help file on the topic that pertains to the Jump form.
The "Accept", and "Cancel" buttons are self explanatory.
Click on the Next -->> button to continue.
{NBB1N0;SPointer Close;SClose All Forms;SAuto Next;}
Note that, when the Jump form is used for popups, everything is exactly the same except the following:
You cannot popup a macro. It must be Jump'ed to.
The display for a popup is always determined by WinHelp and you cannot specify a secondary window.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Jump form.
At this point, you can select another category or close the Wizard.
The Keyword form provides functions to add and remove keywords in multiple tables, rename keywords, assign keyword associations, and more. While this form tour will familiarize you with the form, it is recommended that you read the help on this topic.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOptKeywordsTopics ;SPointer to Control;SAuto Next;}
Show Members from all Project Files Check Box
Check this box to show keywords from all project members. Otherwise, only the keywords from the current file will be displayed.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOptTopics Keywords ;SPointer to Control;SAuto Next;}
Keywords with topics Radio Button
This option displays the keywords with topics in alphabetical order.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNTxtKeywordLoc ;SPointer to Control;SAuto Next;}
Topics with Keywords Radio Button
This option displays the topics with keywords in alphabetical order.
This is where you type in the keyword you are looking for and the Help Magician will automatically highlight the word as you type the letters.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNTxtTopicLoc ;SPointer to Control;SAuto Next;}
The Keyword List Box lists all the keywords in your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNTopicList ;SPointer to Control;SAuto Next;}
Associated Topics Locator Box
This is where you type in the topic you are looking for and the Help Magician will automatically highlight the word as you type the letters.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdAddKeyword ;SPointer to Control;SAuto Next;}
The Topics List Box displays all the associated topics or keywords, depending on which option is selected.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdRenameKeyword ;SPointer to Control;SAuto Next;}
The Add Keyword... Button brings up the add keyword form.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdDelKeyword ;SPointer to Control;SAuto Next;}
Rename Keyword Button
To rename a keyword, select it from the keyword list and click on Rename Keyword. Any changes you make to the keyword name becomes permanent to the keyword database, even if you do not save your help source file.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdMakeSecondary ;SPointer to Control;SAuto Next;}
Delete Keyword Button
To delete a keyword, select it from the keyword list and click on Delete Keyword. Doing this will delete the keyword and all topic associations from the database.
Click on the Go button to continue.
{NBB3N0}
Make Related Button
To make a keyword a Related keyword (or subentry in the WinHelp Index), select it in the keyword list, then click on Make Related.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdMoveSecondary ;SPointer to Control;SAuto Next;}
Make Related Button (cont'd)
Next choose which keyword you want to be its parent. The keyword will appear indented under the "parent" keyword.
Note: This function results in instant permanent changes to the keyword database.
Click on the Go button to continue.
{NBB3N0}
Move Related Button (cont'd)
If you want to move a related keyword to another keyword parent, select the Related Keyword and click on Move Related.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOptTable0 ;SPointer to Control;SAuto Next;}
Move Related Button (cont'd)
Next, from the popup keyword list, select the new parent.
Note: This function results in instant permanent changes to the keyword database.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOptTable1 ;SPointer to Control;SAuto Next;}
K (Normal) Radio Button
Normal keywords appear in the Index Tab and can be referenced with the Klink macros ("Jump to Keyword" functionality within Help Magician). Normal keywords are the most often used.
Click on the Go button to continue.
{NBB3N0}
A (Hidden) Radio Button
Hidden keywords do not appear in the Index Tab but are available with the Alink macros (again, "Jump to Keyword" in Help Magician). Hidden keywords are useful for those topics that you do not want to appear in the Index Tab.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOptTable2 ;SPointer to Control;SAuto Next;}
A (Hidden) Radio Button (cont'd)
Note that Alink and Klink macros ("Jump to Keywords") functionality are available only for Windows 95.
Click on the Go button to continue.
{NBB3N0}
M (Alt) Radio Button
Alternate keywords are rarely used by help authors, but can be specified in the call to WinHelp. Help Magician defaults to the letter M for the alternate keyword table. You do have the option of using other letters other than M for each Alternate keyword.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdAddTopic ;SPointer to Control;SAuto Next;}
M (Alt) Radio Button (cont'd)
To change the alternate keyword table "M" to another table, simply click on the "M" (or any other letter that may be there) and enter the letter in the textbox.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdPreview ;SPointer to Control;SAuto Next;}
Add Topics... Button
To add a keyword to a topic, select the topic you want to add the keyword to and click on Add Keyword... Then when the Add Keyword screen appears, type in the keyword and click on Accept.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdDeleteTopic ;SPointer to Control;SAuto Next;}
Preview Topic Button
You can preview any topic that exists in your currently opened HLX source file by selecting a topic from the topic list and clicking on Preview Topic.
Click on the Go button to continue.
{NBB3N0}
Delete Topic Button
To delete a keyword from a topic, select the topic in the topic list. When a list of keywords appear in the left listbox, select the keyword in that list. Then click on Delete Keyword.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdClose ;SPointer to Control;SAuto Next;}
Delete Topic Button (cont'd)
Note: If the keyword is tied to any other topics, it is not removed from the database until there are no more topics assigned to that keyword.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdSort ;SPointer to Control;SAuto Next;}
The Close Button will accept and record the changes you made.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdPrint ;SPointer to Control;SAuto Next;}
The Re-Sort Button will automatically re-sort the keywords in alphabetical order.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdHelp ;SPointer to Control;SAuto Next;}
The Print... Button will print the list of keywords, and the associated topics or it will print just the keywords depending on which you choose.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNKeywordHelpPanel ;SPointer to Control;SAuto Next;}
The Help Button will give specific help on this topic.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Keyword Help Panel will give you quick help on what your cursor is on.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Keyword form.
At this point, you can select another category or close the Help Wizard.
The Links From form displays all of the links from other topics to the topic currently displayed in the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSSList2Tag ;SPointer to Control;SAuto Next;}
The Jumps form: List Box displays all the topics that have jumps to the current topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSSList3Tag ;SPointer to Control;SAuto Next;}
The Popups from: List Box displays all the topics that have popups to the current topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
The Shed links: List Box displays all the topics that have shed links to the current topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Goto Button will goto the topic you have selected in any of the list boxes..
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button will close the form and remain on the current topic.
Click on the Go button to continue.
{NBB5N0}
This concludes the Links From Form Tour.
At this point, you can either choose another category or close the Wizard.
[Macro Form Tour]
{NBB1Y90;TMacro Form Tour;TMacro Form Tour;SSet WIN95 Mode;SAuto Disable Form;SAuto Hide Wizard: True;SShow Form: MacroForm;SPause: 1;SEnable All Controls;SAuto Hide Wizard: False;SAuto Next;}
The Macro form provides a foolproof environment for creating and editing macros.
Macros can provide additional functionality to your help system and can be associated with jumps, popups, topics, or project.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Def ;SPointer to Control;SAuto Next;}
The Help Magician automatically creates macros for you when you use the "Create Button" function, the "Auto Glossary" function, or add multimedia elements to your help system.
Click on the Go button to continue.
{NBB3N0}
Definitions Button
Macros used within the Help Magician are stored in groups called "Definitions". You will use a definition even if you are using only one macro.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Def ;SPointer to Control;SMacro Form Menu: Defn_Menu;SAuto Next;}
The convenience is more obvious when you call more than one macro. Many macros can be included in a single definition.
You can then call this definition from any part of your help system.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Def ;SPointer to Control;SMacro Form Menu: Defn_Menu;SAuto Next;}
When you click on the Definitions button, a menu will appear with the options: Add, Delete, Rename, and Copy.
Click on the "Add" menu to add a definition. Enter the name of the new macro definition on the input form and close the form. The new definition will appear in the listbox on the left.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Click on the "Delete" menu to remove the highlighted definition.
Click on the "Rename" menu to change the name of the highlighted definition.
Click on the "Copy" menu to copy highlighted definition.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
Definitions Locator Text Box
The "Locator" text box helps you find items in the Definitions list box by moving the highlighted bar to the selection that matches the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Macros ;SPointer to Control;SMacro Form Menu: Macros_Menu;SAuto Next;}
Definitions List Box
This list box displays all of the currently defined macro definitions. Click on an item in this list to perform one of the options available from the menus. Members of the currently selected definition will be displayed in the list box to the right.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Macros ;SPointer to Control;SMacro Form Menu: Macros_Menu;SAuto Next;}
Macros Button
The Macros button pops up a menu with functions that can be performed on individual macros, members of a definition:
Copy to New Macro, Delete, Edit, and Move.
Click on the Go button to continue.
{NBB3N0}
Copy to New Macro
Copies the currently selected macro to the editor.
If there is a macro already in the Editor, a sub menu will be displayed that allows you to choose a position to place the currently selected macro into the Editor.
Click on the Next -->> button to continue.
{NBB3N0}
The Position sub Menu options:
At Beginning - Chains the macro before the text in the Editor.
Append to End - Chains the macro after the text in the Editor.
Replace All - Replaces all the text in the editor.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Macros ;SPointer to Control;SMacro Form Menu: Macros_Menu;SAuto Next;}
The Position sub Menu options (cont'd):
Before Argument - Chains the macro before the currently selected argument.
After Argument - Chains the macro after the currently selected argument.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Macros ;SPointer to Control;SMacro Form Menu: Macros_Menu;SAuto Next;}
The Position sub Menu options (cont'd):
Replace Argument - Replaces the currently selected argument with the macro.
Current Position - Inserts the macro into the current cursor position in the Editor text.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
Macro Functions Cont'd.
Delete will remove a macro from the list.
Select Edit to place the selected macro into the editor.
Select Move to change the order of the macros.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList2 ;SPointer to Control;SAuto Next;}
Macros Locator Box
The "Locator" text box helps you find items in the macro list box by moving the highlighted bar to the selection that matches the characters typed so far.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Editor ;SPointer to Control;SMacro Form Menu: Edit_Menu;SAuto Next;}
Macros List Box
This list box displays a list of the macros that are a member of the highlighted definition in the list box to the left.
You would highlight a macro in order to perform one of the functions on the Macros Menu.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Editor ;SPointer to Control;SMacro Form Menu: Edit_Menu;SAuto Next;}
Editor Button
The Editor button pops up a menu with functions that can be performed on the text in the editor: Copy, Paste, Clear All, Clear Argument and Add to Definition.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Editor ;SPointer to Control;SMacro Form Menu: Edit_Menu;SAuto Next;}
The Copy menu copies the currently selected text to the Windows Clipboard.
Paste inserts the contents of the Windows Clipboard at the current cursor location in the editor.
Clear All will remove the contents of the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
The Clear Argument menu removes the macro argument at the cursor.
Add to Definition adds the macro in the editor to the currently selected definition.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSyntaxChecking ;SPointer to Control;SAuto Next;}
Editor Text Box
The editor is where you will edit macros. With syntax checking on, the editor will not allow an error.
Click on the Go button to continue. Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Macro_Add ;SPointer to Control;SAuto Next;}
Syntax Checking
When this box is checked, the editor monitors all editing and will not allow errors.
Un-check this box to edit free hand.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Protos ;SPointer to Control;SMacro Form Menu: Protos_Menu;SAuto Next;}
Add to Definition Button
When a macro is complete and all of the arguments are properly filled in, click on this button to add the macro to the currently selected definition.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Protos ;SPointer to Control;SMacro Form Menu: Protos_Menu;SAuto Next;}
Prototypes Button
The Prototypes button pops up a menu with functions specific to the list of default WinHelp macros.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Protos ;SPointer to Control;SMacro Form Menu: Protos_Menu;SAuto Next;}
Prototype Functions
Insert at Beginning - Chains the currently selected Prototype before the text in the Editor.
Append to End - Chains the currently selected Prototype after the text in the Editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Protos ;SPointer to Control;SMacro Form Menu: Protos_Menu;SAuto Next;}
Prototype Functions (cont'd)
Edit Prototype - Places the currently selected Prototype into the Editor.
Insert Before Arg - Chains the Prototype before the currently selected macro argument in the Editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Menu_Protos ;SPointer to Control;SMacro Form Menu: Protos_Menu;SAuto Next;}
Prototype Functions (cont'd)
Insert After Arg - Chains the Prototype after the currently selected macro argument in the Editor.
Replace Arg - Replaces the currently selected macro argument in the Editor with the Prototype.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNPrototypeList(2) ;SPointer to Control;SAuto Next;}
Prototype Functions (cont'd)
Current Position - Places the Prototype into the current cursor position in Editor.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNClearAll ;SPointer to Control;SAuto Next;}
Prototypes List Box
The Prototypes List Box contains a list of all of the default WinHelp macros and some multimedia macros with "dummy" arguments for you to edit. Double clicking on this list puts the selected macro into the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNClearArg ;SPointer to Control;SAuto Next;}
Clear All Button
The Clear All Button removes all the text from the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmd_Hints ;SPointer to Control;SAuto Next;}
Clear Arg Button
The Clear Arg Button clears the current argument in the macro being edited.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNLongNames ;SPointer to Control;SAuto Next;}
Macro Ref Button
The Macro Ref Button will display one of two captions, depending on where the cursor is in a macro. When the caption is "Macro Ref", clicking on it will bring up help for macros. When the caption is "Hints", clicking on it will pop up a window with a list of possible arguments.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNShortNames ;SPointer to Control;SAuto Next;}
Long Names Radio Button
Selecting the Long Names Radio Button causes the prototypes list box to display the macros with their full name.
Click on the Go button to continue.
{NBB1N0;CNDescriptions ;SPointer to Control;SAuto Next;}
Short Names Radio Button
Selecting the Short Names Radio Button causes the prototypes list box to display the macros with their abbreviated names. This can save space if you chain a number of macros together.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Descriptions
Selecting the Descriptions Radio Button causes the prototypes list box to display descriptions of the macros in place of their prototypes.
Click on the Go button to continue.
{NBB5N0}
This concludes the Tour of the Macro Form.
Don't forget that I'll help you create your own macros if you choose the Macros category, "Assist: Creating Macros".
Macros can provide additional functionality to your help system and can be associated with jumps, popups, topics, or project.
Click on the Go button to continue.
{NBB3N0}
The Help Magician automatically creates macros for you when you use the "Create Button" function, the "Auto Glossary" function, or add multimedia elements to your help system.
Click on the Next -->> button to continue.
{NBB1N0;CNCmd_Menu_Def ;SPointer to Control;SFocus Form;SAuto Next;}
The Macro form provides a foolproof environment for creating and editing macros.
I'm going to assist you in the use of the Macro Definition form.
Click on the Go button to continue.
{NBB3N0}
Definitions Button
Macros used within the Help Magician are stored in groups called "Definitions". You will use a definition even if you are using only one macro.
Click on the Next -->> button to continue.
{NBB1N0;CNCmd_Menu_Def ;SPointer to Control;SMacro Form Menu: Defn_Menu;SFocus Form;SAuto Next;}
The convenience is more obvious when you call more than one macro. Many macros can be included in a single definition.
You can then call this definition from any part of your help system.
Click on the Go button to continue.
{NBB1N0;K{F3};SWait For Form: MyInput;CYText1 ;SPointer to Control;SFocus Form;SAuto Next;}
When you click on the Definitions button, a menu will appear with the options: Add, Delete, Rename, and Copy.
I'm going to activate the "Add" menu for you.
Click on the Go button to continue.
{NBB1N0;SIf No Text Then Stop;SIf Form Exists: MyInput;CNCommand1 ;SLeft Mouse Click: Wait Close;RClose Form: MacroForm;SEnd If;SAuto Next;}
Enter the name of the new macro definition on the input form now.
There are no particular rules for the name of the definition. Try to name the definition something related to its functionality.
When you're done, click on the Go button
to continue.
{NBB1N0;CNFrame1 ;SPointer to Control;SFocus Form;SAuto Next;}
Notice that the new definition appears in the listbox on the left.
We can now add macros to this definition.
Click on the Go button to continue.
{NBB1N0;CYPrototypeList(0) ;SPointer to Control;SFocus Form;SAuto Next;}
If you're unfamiliar with the macro names, before selecting a prototype, click on the "Descriptions" radio button.
This changes the prototype list to display descriptions of the macros rather than the name.
When you're done, click on the Go button to continue.
{NBB1N0;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
If you want to simplify the process for this lesson, select a macro without arguments. These are macros without text between the parenthesis after the macro name.
Select one of the prototypes now by double clicking on it or click on the "Prototypes" button and select "Edit Prototype".
When you're done, click on the Go button
to continue.
{YBB1N0;SIf No Jump to Tag: NoArguments;SRegain Focus;}
If you selected a macro with arguments, click on the Yes radio button at the bottom of this text window.
If you selected a macro without arguments, click on the No radio button at the bottom of this text window and we'll skip the text that talks about the arguments..
Click on the Go button to continue.
{NBB3N0}
There are many types of macro arguments. As you click on an argument, the caption on the "Hints" button (the button to the right of the "Clear Arg" button") changes to reflect the type of the argument.
Click on the Next -->> button to continue.
{NBB3N0}
When the argument is a file name, the "Hints" button caption is "Browse". Clicking on this button will bring up a file dialog. You can select the file name from the file dialog or enter it manually.
If you want the argument to refer to the current file, enter "THISFILE" instead of the file name.
Click on the Next -->> button to continue.
{NBB3N0}
If you change the name of the current file, the macro will still be effective.
When there are only two or three possibilities for an argument, the choices will be displayed in the help bar at the bottom of the form.
Click on the Next -->> button to continue.
{NBB3N0}
When the cursor is on the macro name, the "Hints" button caption will be "Macro Ref". Clicking on the button will bring up the "Macro Reference" portion of the Help Magicians own help system.
Click on the Next -->> button to continue.
{NBB3N0;TNoArguments}
With the information you have just read, fill in the arguments for the macro now.
Use the "Hints" button and the help bar to help you enter the arguments.
When you're done, click on the Next -->> button to continue.
Notice that the macro has been added to the "Macro List" on the right.
Click on the Go button to continue.
{NBB5N0}
Congratulations. You have just created a macro. We didn't use all of the functions available. For a description of these controls, see the "Macro Form Tour" category.
Project macros are macros (macro definitions in the Help Magician) that are executed when the help system is first displayed with WinHelp.
Click on the Go button to continue.
{NBB1N0;CYText1 ;SPointer to Control;SFocus Form;SAuto Next;}
If a project macro is already assigned, it will be selected in the list and displayed in the text box above the list.
If a project macro has not been assigned, the text box will display "None".
Click on the Go button to continue.
{NBB1N0;CYList1 ;SPointer to Control;SFocus Form;SAuto Next;}
Selected Macro Text Box
This text box will display the assigned macro, if assigned. It can also be used as a locator. Typing in this text box will highlight the macro that matches the characters entered so far.
Select the macro that you want to assign as the Project Macro now.
Click on the Go button to continue.
{NBB5N0}
At this point, you can click on the "Accept" button to record the assignment or click on the "Cancel" button to close the form without recording the assignment.
This concludes the Assist: Project Macro category.
Topic macros are macros (macro definitions in the Help Magician) that are executed when the topic to which the macro was assigned is displayed with WinHelp.
Click on the Go button to continue.
{NBB1N0;CNText1 ;SPointer to Control;SFocus Form;SAuto Next;}
If a topic macro is already assigned, it will be selected in the list and displayed in the text box above the list.
If a topic macro has not been assigned, the text box will display "None".
Click on the Go button to continue.
{NBB1N0;CYList1 ;SPointer to Control;SFocus Form;SAuto Next;}
Selected Macro Text Box
This text box will display the assigned macro, if assigned. It can also be used as a locator. Typing in this text box will highlight the macro that matches the characters entered so far.
Select the macro that you want to assign as the Topic Macro now.
Click on the Go button to continue.
{NBB5N0}
At this point, you can click on the "Accept" button to record the assignment or click on the "Cancel" button to close the form without recording the assignment.
This concludes the Assist: Topic Macro category.
[Main Form Tour]
{NNB3N10}
Main Form Tour
For your convenience, most of the commonly used functions are available from the Help Magician's main form. I'll explain the controls on the main form in the order in which they appear.
Click on the Next -->> button to continue.
{NNB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOpen ;SPointer to Control;SAuto Next;}
The Main Form Tour is not intended to be a tutorial on the functions available from the Main Form but to familiarize you with the Help Magician.
Categories that serve as tutorials for these functions are available from the Category menus.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNSave ;SPointer to Control;SAuto Next;}
The Open button brings up a file dialog to open a Help Magician source file on disk.
In Project mode, it brings up the Project Management form, from which you can perform project related functions..
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNNew ;SPointer to Control;SAuto Next;}
The Save button will save the current file to disk.
If the file has not been saved, a file dialog will be displayed for you to name the file.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNPrint ;SPointer to Control;SAuto Next;}
The New button clears the editor and the related databases in preparation for a new file.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCut ;SPointer to Control;SAuto Next;}
The Print button prints the current help text and graphics.
Other report and print functions are available from the File menu.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCopy ;SPointer to Control;SAuto Next;}
The Cut button will cut the selected text into the Windows clipboard.
If there are links in the text, the database information is stored in the Help Magician's special clipboard.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNPaste ;SPointer to Control;SAuto Next;}
The Copy Button will copy the selected text to the Windows clipboard.
If there are links in the text, the database information is stored in the Help Magician's special clipboard.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNBold ;SPointer to Control;SAuto Next;}
The Paste Button will paste the text from the Windows clipboard into the editor at the current cursor is located.
If there are links in the text, the database information is pasted from the Help Magician's special clipboard.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNItalic ;SPointer to Control;SAuto Next;}
When you click on the Bold Button the highlighted text, if any, will become bold.
Otherwise, typing from the current cursor location will be in bold.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNUnderline ;SPointer to Control;SAuto Next;}
When the Italic Button is pressed, the highlighted text, if any, will become italic.
Otherwise, typing from the current cursor location will be in italics.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNLeft Justify ;SPointer to Control;SAuto Next;}
When you press the Underline Button the highlighted text, if any, will become underlined.
Otherwise, typing from the current cursor location will be underlined.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCenter Justify ;SPointer to Control;SAuto Next;}
Left Justify Button will make the text left justified.
Your cursor can be any where in a paragraph and the whole paragraph will be left justified.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNRight Justify ;SPointer to Control;SAuto Next;}
Center Justify Button will make the text center justified.
Your cursor can be any where in a paragraph and the whole paragraph will be center justified.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNBitmap ;SPointer to Control;SAuto Next;}
Right Justify Button will make the text right justified.
Your cursor can be any where in a paragraph and the whole paragraph will be right justified.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNJump ;SPointer to Control;SAuto Next;}
The Bitmap Button is used to insert any one of the supported graphics file formats into the editor.
See the Images category for more information on inserting images into your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNPopup ;SPointer to Control;SAuto Next;}
The Jump Button will bring up the jump form. Text selection depends on the Word Delimiter option on the Environment Options form.
Jumps are used to establish a link from the selected word or phrase to another topic or macro. See the category Jumps, Jump form tour for more information.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNMultimedia ;SPointer to Control;SAuto Next;}
The Popup Button will bring up the popup form. Text selection depends on the Word Delimiter option on the Environment Options form.
Popups are used to establish a link from the selected word or phrase to another topic or macro. See the category Jumps, Jump form tour for more information.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNAuthorable Button ;SPointer to Control;SAuto Next;}
The Multimedia Button is used to include multimedia elements in your help file.
For more information on this topic see the category Multimedia, Multimedia Form Tour (3.1, & 95).
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNParagraph ;SPointer to Control;SAuto Next;}
The Multimedia Button brings up the Multimedia Element form.
For more information on this topic see the category Multimedia, Multimedia Form Tour (3.1, & 95).
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNEmbed AVI ;SPointer to Control;SAuto Next;}
The Authorable Button is used to insert an authorable button into the text portion of a help topic.
For more information on this topic see the category Add Button.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNParagraph ;SPointer to Control;SAuto Next;}
The Embed AVI Button is used to insert embedded video (AVI) files into the text portion of a help topic.
For more information on this topic see the category Multimedia, Embedded Video Form Tour (95).
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNView Link ;SPointer to Control;SAuto Next;}
The Paragraph Button brings up the paragraph formatting form and operates on the current or selected paragraphs.
For more information on this topic see the category Styles, Paragraph Styles Form Tour.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNDelete Link ;SPointer to Control;SAuto Next;}
The View Links Button brings up the appropriate form to view or modify the link associated with the word or phrase at the cursor.
This can also be done by clicking on a link with the right mouse button.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNHelp ;SPointer to Control;SAuto Next;}
The Delete Links Button deletes the link associated with the word or phrase at the cursor.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNKeywordButton ;SPointer to Control;SAuto Next;}
The Help Button calls the Help Magicians own on line help system.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNDropText1Tag ;SPointer to Control;SAuto Next;}
Clicking on the Keyword Button will pop up a list of Keywords already used in the help file.
Double click on the Keyword you want to add or click on the Accept button and the Keyword will be added to the Keywords drop down box.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolbar2_AutoContextString ;SPointer to Control;SAuto Next;}
The Keyword text box is used to enter new keywords.
The Keyword Drop Down Box displays the keywords on the current page.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
The Auto Context String Button will cause the Help Magician to automatically construct a Context String from the topic title and enter it into the Context String text box.
Duplicates are not allowed and you will have to confirm the replacement of the current Context String.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolbar2_AutoContextNumber ;SPointer to Control;SAuto Next;}
The Context String Text Box is used to enter a context string.
Duplicates are not allowed and, if entered, you have the option for the Help Magician to alter the context string to avoid duplication.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNContextNumberText ;SPointer to Control;SAuto Next;}
The Auto Context Number Button will cause the Help Magician to automatically enter a Context Number.
The number entered will be one greater than the highest Context Number in the help file.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNContextNumberText ;SPointer to Control;SAuto Next;}
The Auto Context Number Button will cause the Help Magician to automatically enter a Context Number.
The number entered will be one greater than the highest Context Number in the help file.
Click on the Go button to continue.
{NB91N12;SDon't Hide Wizard;SDon't Move Cursor;CNDropText2Tag ;SPointer to Control;SAuto Next;}
The Context Number Text Box is used to enter a context number.
Duplicates are not allowed and you will be warned if you attempt to enter a duplicate.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolBar2_Browse ;SPointer to Control;SAuto Next;}
The Context Number Text Box is used to enter a context number.
Duplicates are not allowed and you will be warned if you attempt to enter a duplicate.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolBar2_Search ;SPointer to Control;SAuto Next;}
Clicking on the Browse Button will bring up the Browse Group Definitions window.
See the Category Browse, Browse Sequence Form Tour for more information.
Click on the Go button to continue.
{NB31N296;SDon't Hide Wizard;SDon't Move Cursor;CNToolBar2_Back ;SPointer to Control;SAuto Next;}
When pressed, the Search Button brings up a replica of the Search dialog used by WinHelp 3.1.
The search dialog can be used to check your keyword/topic relationships.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolBar2_History ;SPointer to Control;SAuto Next;}
The Back Button returns the editor to the topic from which a link was executed.
This is the same functionality as the Back button on a help system viewed with WinHelp.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNToolBar2_Links ;SPointer to Control;SAuto Next;}
Clicking on the History Button pops up a replica of the History window used by WinHelp.
The last 40 topics viewed are listed. Double click on a topic to go to that page in the editor.
Click on the Go button to continue.
{NB31N12;SDon't Hide Wizard;SDon't Move Cursor;CNTabSpin ;SPointer to Control;SAuto Next;}
The Links Button pops up a form displaying the links from other topics to the current topic.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNTabSpin ;SPointer to Control;SAuto Next;}
The Default Window Drop Down Box lists the defined windows in your help file.
The window assigned to the current topic is displayed in the text box. All topics are assigned to the (default) window until otherwise assigned.
Click on the Go button to continue.
{NBB1N296;SDon't Hide Wizard;SDon't Move Cursor;CNPicture1 ;SPointer to Control;SAuto Next;}
Default Tab Spacing Spin Buttons
The default tab spacing is .5" (1/2 inch) unless otherwise specified. Clicking on the left arrow reduces the default tab spacing. Clicking on the right arrow increases it.
Click on the Go button to continue.
{NBB3N0}
Tab Ruler
The tab ruler displays the default tab spacing, user defined tabs, left and right margins, and left, right, and first indent.
Click on the ruler with the left mouse button to set a tab. Click with the right button to remove a tab.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(0) ;SPointer to Control;SAuto Next;}
Tab Ruler, cont'd.
The sliders can be dragged to set left, right, and first indents.
Click on the box above the tab spin control to set the tab type: Left, Right, or Center.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(1) ;SPointer to Control;SAuto Next;}
The Contents Button will bring up to the contents page of your help file.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(1) ;SPointer to Control;SAuto Next;}
The Topics Button will bring up either the Topic Outliner form or the Windows 95 Contents Editor, depending on whether you have already created a Contents file.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(2) ;SPointer to Control;SAuto Next;}
The Search Button will bring up the search form. Then you type in the word or topic you are looking for, pick the topic and press GOTO, and it will take you to that topic in the help file.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(3) ;SPointer to Control;SAuto Next;}
The Index Button replaces the search dialog in WinHelp 3.1.
For more information see the category Topic Outliner, Help Topics Browser Form Tour.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(3) ;SPointer to Control;SAuto Next;}
The Back Button will return to the topic viewed before a link was executed to take you to the current topic.
Click on the Go button to continue.
{NB31N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(4) ;SPointer to Control;SAuto Next;}
The History Button will bring up the history form, which will show you the topics in which you have been at.
Click on the Go button to continue.
{NB91N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(4) ;SPointer to Control;SAuto Next;}
When you click on the Print Button the printer setup dialog will appear.
You can print all of the topics or selected topics only.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNWinHelpCmd(5) ;SPointer to Control;SAuto Next;}
The << Button is used to page backwards in Browse Sequences.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNTextBoxScroll ;SPointer to Control;SAuto Next;}
The >> Button is used to page forwards in Browse Sequences.
Click on the Go button to continue.
{NBB3N0}
The Editor is a WYSIWYG editor with many built in WinHelp like functions.
The Help Magician's Integrated Test Mode is an invaluable, time saving tool in the development of your help system.
Click on the Next -->> button to continue.
{NNB3N0}
The Editor, cont'd.
You can instantaneously test the help file without the need to write the RTF file or to compile the RTF file with the Windows help compiler.
Click on the Next -->> button to continue.
{NNB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
The Editor, cont'd.
Jumps to other topics, Jumps to secondary windows, Jumps to macros, Jumps to other help files, Popups, Browse sequences, and keyword links can all be tested in Test Mode.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNTitleButton ;SPointer to Control;SAuto Next;}
The Page Number Text Box displays the current page number. You can also jump to a page by typing in the number and pressing Return.
It can also be used to jump to a context number. Enter a C in front of the context number, and press Return.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
The Auto Title Button will cause the Help Magician to copy the contents of the Title text box to the top of the current page and assign the Topic Title style if it exists.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNStylePanelText ;SPointer to Control;SAuto Next;}
The Title Text Box is continuously updated to reflect the title of the current page, topic. You can edit the title at any time.
When the mouse cursor is passed over links, the target of the link is displayed, provided option for this is turned on in Environment Options.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;SStylePanel Click;SPointer to Control;SAuto Next;}
The Style Panel Text Box displays the paragraph style assigned to the paragraph at the current cursor location.
Click on this box to select from a list of defined paragraph styles to assign to the current paragraph.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;SStylePanel Click;CNTypefaceText ;SPointer to Control;SAuto Next;}
The Paragraph Styles List Box is a list of all the styles in the help file.
Click on the style you want to assign to the current paragraph.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNFontSizePanel ;SPointer to Control;SAuto Next;}
The Typeface Text Box displays the typeface of the character at the current text cursor position.
When you click on the typeface text box, the Font dialog appears.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOverTypePanel ;SPointer to Control;SAuto Next;}
The Font Size Panel displays the font size of the character at the current text cursor position.
If the font at the current cursor position is a True Type font, when you click on the font size panel, a list of point sizes appears. Otherwise, the Font dialog appears.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNPageUpCmd ;SPointer to Control;SAuto Next;}
The Over Type Panel displays the current typing mode.
When you click on the over type panel it toggles between insert and overwrite.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNPageDownCmd ;SPointer to Control;SAuto Next;}
The Page Up Button displays the previous page in the current help file.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SAuto Next;}
The Page Down Button displays the next page in the help file.
When pressed from the last page in the help file, a new page is created.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Main form.
Help Wizard categories are available for most of the functions described in this category.
Look through the Category menus for the topic you need help on.
[Manual to Help Form Tour]
{NBB3N0}
The Manual to Help function will convert manuals in word processor formats into a help file.
An import language provides the ability to predetermine how the help file will be formatted. Also, links and other help related functions can be included in the manual.
The manual must be created in a word processor such as Word for Windows or AmiPro and saved in Rich Text Format (RTF).
By placing special "Import Commands" in the document, you can control how your manual will be converted to a help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioTOCOptions(1) ;SPointer to Control;SAuto Next;}
Use Existing TOC Radio Button
The "Use Existing TOC" option is selected by default. This instructs the import function to use the TOC field in your word processor file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRadioTOCOptions(2) ;SPointer to Control;SAuto Next;}
Create TOC from Styles Radio Button
You must first enter the name of your document, previously saved in RTF format, in the "RTF Filename" text box. After you have done this, select "TOPIC" from the Function list and then select a style or styles from the Style list that you want the Help Magician to recognize as topic headings.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNIgnoreImportCommands ;SPointer to Control;SAuto Next;}
Don't Create TOC Radio Button
You may choose to ignore any TOC and not have a main contents topic created by selecting "Don't create TOC".
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNIgnoreSectionBreaks ;SPointer to Control;SAuto Next;}
Ignore Import Commands Check Box
If you have entered special import commands into your manual or document, you may tell the Help Magician to ignore those commands by selecting "Ignore Commands".
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNIgnorePageBreaks ;SPointer to Control;SAuto Next;}
Ignore Section Breaks Check Box
These features can be used when you wish to ignore any section and hard page breaks in the manual.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRemoveUnusedStyles ;SPointer to Control;SAuto Next;}
Ignore Hard Page Breaks Check Box
These features can be used when you have defined your own page breaks using the RTF Import Commands.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNConvertUnresolved ;SPointer to Control;SAuto Next;}
Remove Unused Styles Check Box
This feature is useful when there are many of unused styles defined in the manual you are converting and you don't wish to have them added to the styles list in the Help Magician.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNConvertIndexEntries ;SPointer to Control;SAuto Next;}
Convert Unresolved Hotspots to "Other Source" Check Box
You can have the Help Magician convert unresolved hotspots that it finds to "Other Source" rather than leaving the hotspot unresolved.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdReadStyles ;SPointer to Control;SAuto Next;}
Convert Index Entries to Keywords Check Box
If you created an index in your manual and defined index entries throughout the text, you may have the Help Magician convert these entries into keywords. As the Help Magician finds index entries it will add the text to the list of keywords for the page the entries appear on.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
Read Styles From RTF Button
The Manual to Help converter can take advantage of styles you have created in your document by converting the text they mark into topics, hotspots, TOC, or glossary entries.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList2 ;SPointer to Control;SAuto Next;}
Function: List Box
The Manual to Help converter can take advantage of styles you have created in your document by converting the text they mark into topics, hotspots, TOC, or glossary entries.
Select the desired function in this list.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Style: List Box
Select the style to map to the function selected in the list box to the left.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTextBox ;SPointer to Control;SAuto Next;}
RTF Filename: Text Box
Enter the name of your document. It should have been previously saved in RTF format from your word processor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBrowseButton ;SPointer to Control;SAuto Next;}
Project Options Source Text Box
Enter the name of a Help Magician file (.HLX) that will be the source of the Help system project options.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdAccept ;SPointer to Control;SAuto Next;}
Browse Button
Pressing the Browse button will pop up a file dialog to automate the entry of the path and filename for the current field.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdHelp ;SPointer to Control;SAuto Next;}
The Accept Button will accept and record the changes you made and begin importing the specified file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdCancel ;SPointer to Control;SAuto Next;}
The Help Button will give you specific help on this topic.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button will cancel and does not record the changes you have made.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Manual to Help form.
At this point, you can select another category or close the Wizard.
The Help Magician automates the use of multimedia elements in your help system. You can include sound or wave (wav) files, movie (mmm), midi, (mid), or video (avi) files.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(1) ;SPointer to Control;SAuto Next;}
The Help Magician can import four types of multimedia elements:
Audio (wav). Video (avi), Animation (mmm), and Midi (mid).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(2) ;SPointer to Control;SAuto Next;}
Audio (.WAV) Radio Button
A WAV file is an audio file that contains prerecorded sound clips. Wave files can be used to orally describe a topic or to give an example of a sound related to a topic rather than just explaining the sound.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(3) ;SPointer to Control;SAuto Next;}
Video (.AVI) Radio Button
An AVI file is a video file which displays animation sequences, and it also can display sound and video sequences. With the proper equipment and support software, AVI files can play back actual video recordings.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption1(4) ;SPointer to Control;SAuto Next;}
Animation (.MMM) Radio Button
A MMM file displays animation and sound sequences. Special software is required to generate these files.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D1 ;SPointer to Control;SAuto Next;}
Midi (.MID) Radio Button
A musical instrument digital interface file (MIDI) is an audio file used to play songs, or other musical features. These files are useful for demonstrations, or for musical background.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D2 ;SPointer to Control;SAuto Next;}
The Selected Text option
When this option is checked links the selected media element to the highlighted text in the editor.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D3 ;SPointer to Control;SAuto Next;}
The Current Topic Option
Links the selected media element to the current topic. When the topic is displayed, this media element will be played.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption2(1) ;SPointer to Control;SAuto Next;}
The Project Option
Links the selected media element to the help project. When the help file is first displayed, this media element will be played.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOption2(2) ;SPointer to Control;SAuto Next;}
The Default Radio Button
Displays the media file in a default window for the type of media. Only the AVI, and MMM files can be displayed in windows.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck3D7 ;SPointer to Control;SAuto Next;}
The Popup Radio Button
When selected, the selected media element will be displayed in a popup window without borders or a play bar.
Again, only AVI, and MMM files have a window style.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
The Create 'Stop Play' Macro Check Box will create a stop macro for the selected file.
Only AVI, MMM, and MID files can have a Stop Play macro.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
In the Audio Filename: Text Box
If you know the name of the file that you want you can type it in this text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Browse Button
This button will pop up a file dialog from which you can locate and select a multimedia file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
The Preview Button
Plays or previews the selected media file before you insert it into your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton4 ;SPointer to Control;SAuto Next;}
The Help Button will give you help on this topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton5 ;SPointer to Control;SAuto Next;}
The Accept Button accepts the changes that you made and inserts the selected media element into your help system. If linked to a topic or to the project, there is no visual reference in the help text. See Macros, Topic Macros/Project Macros.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button cancels the changes you made.
Click on the Go button to continue.
{NBB3N0}
This concludes the tour of the Multimedia form (3.1 & 95) .
At this point, you can select another category or close the Wizard.
The Embedded Video form provides functions to embed an AVI file into your help file.
The AVI file becomes part of the topic and the video is displayed at it's location in the topic rather than in a pop up window.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptionCheck2 ;SPointer to Control;SAuto Next;}
External Check Box
Keeps the file outside of the Help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptionCheck3 ;SPointer to Control;SAuto Next;}
No Play Bar Check Box
No playbar is shown (useful for auto-play and repeat).
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptionCheck4 ;SPointer to Control;SAuto Next;}
No Menu Check Box
No menu button is shown if there is a playbar.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptionCheck5 ;SPointer to Control;SAuto Next;}
Repeat Check Box
The file automatically repeats when play is done.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptAlignment1 ;SPointer to Control;SAuto Next;}
Play Check Box
The file automatically plays when shown.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptAlignment2 ;SPointer to Control;SAuto Next;}
Character Radio Button
The window acts like a character of text.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CYOptAlignment3 ;SPointer to Control;SAuto Next;}
Left Margin Radio Button
The window will be at the left margin and text on the same line will wrap around on the right side of the window.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptDisplay1 ;SPointer to Control;SAuto Next;}
Right Margin Radio Button
The window will be at the right margin and text on the same line will wrap around on the left side of the window.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptDisplay2 ;SPointer to Control;SAuto Next;}
Embed Frame Radio Button
Select the Embed Frame option to include the image of the first frame of the AVI file in memory and in the HLX (Help Magician source) file. This method produces the fastest load and display but uses the most memory and disk space.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNOptDisplay3 ;SPointer to Control;SAuto Next;}
Show Filename Radio Button
When the Show Filename option is selected, the image will not be displayed in the editor, it will not be stored in memory, and it will not be stored in the HLX file. The image filename will be displayed in the editor in red text. The compiled help file will show the image, however.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Link to File Radio Button
The Link to File option provides the best combination of performance, memory conservation, and disk space usage. The data for the image is not stored in the HLX file and the data for images is only stored in memory when the topic containing the image is displayed.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNBrowseButton ;SPointer to Control;SAuto Next;}
Video (AVI) Filename Text Box
Enter the filename of the AVI file to embed. Use the Browse button to use a file dialog to locate the file on your system.
Click on the Go button to continue.
{NB91N296;SDon't Move Cursor;CNPreviewCMD ;SPointer to Control;SAuto Next;}
Browse Button
The Browse Button allows you to search for a filename to enter into the text box above.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNHelpCMD ;SPointer to Control;SAuto Next;}
Preview Button
Pressing the Preview button will play the AVI file. It will be displayed in a separate window but it will 'play' just as it will in the compiled help file.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNAcceptCMD ;SPointer to Control;SAuto Next;}
The Help Button displays help on this form.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCancelCMD ;SPointer to Control;SAuto Next;}
The Accept Button accepts and records the changes made.
Click on the Go button to continue.
{NB91N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button cancels and does not record the changes.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Embedded Video form.
At this point, you can select another category or close the Wizard.
[Using the Navigator]
{NBB1N296;SWant File in Editor: True;SAuto Hide Wizard: True;SActivate Menu: Tool&s, &Navigator;S'Show Form: NavigatorForm;SWait For Form: NavigatorForm;CNText1 ;SPointer to Control;SAuto Hide Wizard: False;SFocus Form;SAuto Next;}
Assist: Using the Navigator
I am going to show you how to use the navigator with your own help file.
There must be a category in memory to view this category.
Click on the Go button to continue.
{NBB1N0;CYTable1 ;SPointer to Control;SFocus Form;SAuto Next;}
The Locator Text Box helps you quickly find the topic you are looking for. The topic title becomes highlighted as you type in the letters.
Type a topic title, if you wish, then click on the Go button to continue.
{NBB3N0}
The Table consists of a Topic Title, a link type column, and a Links column.
The Topic Title column displays all of the titles in the current help source file. The Links column displays all of the links on that page.
Click on the Next -->> button to continue.
{NBB1N0;CNGotoCmd ;SPointer to Control;SAuto Next;}
Press the Wizard's Help button to view the help on this topic and a graphic representation of the link type icon legend.
Click on the Go button to continue.
{NBB1N0;CNHelpCmd ;SPointer to Control;SAuto Next;}
The Goto Button will goto the selected topic in the help file.
Click on the Go button to continue.
{NBB1N0;CNDoneCmd ;SPointer to Control;SAuto Next;}
The Help Button will give specific help on this topic.
Click on the Go button to continue.
{NBB3N0}
The Done Button will close the form.
Click on the Next -->> button to continue.
{NBB3N0}
Menu Option - Close On Selection
When this menu item is checked, the Navigator will close when you go to a topic by clicking on the Goto button or by double clicking on the topic title in the list.
When this menu item is checked, the Navigator will reset the highlighted bar in the Title column to the title selected in the Links column when you press the Goto button or double click on the title in the list.
Click on the Go button to continue.
{NBB5N0}
This concludes the Assist: Using the Navigator section.
You can now choose another topic or you can close the Wizard.
[Paths Form Tour]
{NBB1Y296;TPath Form Tour;SAuto Hide Wizard: True;SShow Form: PathForm;SPause: 1;SEnable All Controls;SAuto Disable Form: True;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Hide Wizard: False;SAuto Next;}
The Paths form is used to enter various paths needed by the Help Magician to access external files and to reference the storage of image files.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Help Compiler Path and Name Text Box
Enter the full drive, and path, to your Windows help compiler. The path defaults to C:\HMPRO30\ upon installing Help Magician but it can be changed at any time. A path is stored for both Windows versions, 3.1 and 95. Change the Compiler Version in Options/CompilerOptions.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText6 ;SPointer to Control;SAuto Next;}
Switches Text Box
Use this text box to enter any switches you want to send to the help compiler when it is called. With rare exceptions, the 3.1 compilers will not want switches. The Help Magician automatically sets switches for the Windows 95 compiler (/C/E/M) and will not usually require changing.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
WinHelp Path and Name Text Box
You can enter a WinHelp path for both versions of Windows, 3.1 and 95 or enter the word "PATH" and WinHelp will be found automatically.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText4 ;SPointer to Control;SAuto Next;}
Word Processor Path and Name Text Box
Enter the full drive, path, and filename to the word processor that you will use to view the RTF files generated by the Help Magician or "NONE" if no word processor will be used.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText5 ;SPointer to Control;SAuto Next;}
SHED Path and Name Text
Enter the full drive, path, and filename to the SHED (Segmented Hypergraphics Editor) that you will use to modify bitmaps to use as hotspots in your help file. The path defaults to C:\HMPRO30\ upon installing Help Magician but it can be changed at any time.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWhereIsCmd ;SPointer to Control;SAuto Next;}
Bitmap Magician Path and Name Text
Enter the full drive, path, and filename to the Bitmap Magician that you will use to create images of characters in font families not supported by the help compiler.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBitmapPathText ;SPointer to Control;SAuto Next;}
WhereIs Button
Pressing the WhereIs button will pop up the WhereIs dialog. This dialog will search the selected drive for files matching the specified criteria. The criteria is automatically entered for each of the fields but can be edited, if necessary.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNBitmapPaths ;SPointer to Control;SAuto Next;}
Bitmap Directories Text Box
Type the paths to any bitmaps used in your Help file in the drop down box. Add as many paths as you need. The Help compiler will search these directories for the bitmaps used in your Help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D1 ;SPointer to Control;SAuto Next;}
Bitmap Directories List Box
Displays the current list of Bitmap Directories.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand3D2 ;SPointer to Control;SAuto Next;}
Add Path Button
When you click the Add Path Button, the path in the Bitmap Directories Text Box will be added to the list box below it.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNBrowseButton ;SPointer to Control;SAuto Next;}
Delete Path Button
The Delete Path Button will delete the path you have selected in the list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand1 ;SPointer to Control;SAuto Next;}
BrowseButton Control
Pressing the Browse button will pop up a file dialog to automate the entry of the path and/or filename for the current field.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCommand2 ;SPointer to Control;SAuto Next;}
The Accept Button accepts and records the changes made.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button cancels and does not record the changes made.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Paths form.
Select the "Paths" menu, "Assist: Entering Paths" sub menu for assistance in entering paths in your own help file.
I am going to show you how to entering paths in your own help file. I will bring up the form for you.
Click on the Go button to continue.
{NBB1N0;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
Help Compiler Path and Name Text
Enter the full drive, and path, to your Windows help compiler. The path defaults to C:\HMPRO30\ upon installing Help Magician but it can be changed at any time.
Click on the Go button to continue.
{NBB1N0;CYText6 ;SPointer to Control;SFocus Form;SAuto Next;}
Switches Text
Use this text box to enter any switches you want to send to the help compiler when it is called. With rare exceptions, the 3.1 compilers will not want switches. The Help Magician automatically sets switches for the Windows 95 compiler (/C/E/M) and will not usually require changing.
Click on the Go button to continue.
{NBB1N0;CYText2 ;SPointer to Control;SFocus Form;SAuto Next;}
WinHelp Path and Name Text
You can enter a WinHelp path for both versions of Windows, 3.1 and 95 or enter the word "PATH" and WinHelp will be found automatically.
Click on the Go button to continue.
{NBB1N0;CYText4 ;SPointer to Control;SFocus Form;SAuto Next;}
Word Processor Path and Name Text
Enter the full drive, path, and filename to the word processor that you will use to view the RTF files generated by the Help Magician.
Click on the Go button to continue.
{NBB1N0;CYText5 ;SPointer to Control;SFocus Form;SAuto Next;}
SHED Path and Name Text
Enter the full drive, path, and filename to the SHED (Segmented Hypergraphics Editor) that you will use to modify bitmaps to use as hotspots in your help file. The path defaults to C:\HMPRO30\ upon installing Help Magician but it can be changed at any time.
Click on the Go button to continue.
{NBB1N0;CYWhereIsCmd ;SPointer to Control;SFocus Form;SAuto Next;}
Bitmap Magician Path and Name Text
Enter the full drive, path, and filename to the Bitmap Magician that you will use to modify font families to you're own specifications.
Click on the Go button to continue.
{NBB1N0;CYBitmapPathText ;SPointer to Control;SFocus Form;SAuto Next;}
WhereIsCmd Control
Pressing the WhereIs button will pop up the WhereIs dialog. This dialog will search the selected drive for files matching the specified criteria. The criteria is automatically entered for each of the fields but can be edited, if necessary.
Click on the Go button to continue.
{NBB1N296;CYBitmapPaths ;SPointer to Control;SFocus Form;SAuto Next;}
Bitmap Directories Text Box
Type the paths to any bitmaps used in your Help file in the drop down box. Add as many paths as you need. The Help compiler will search these directories for the bitmaps used in your Help file.
Click on the Go button to continue.
{NBB1N0;CNCommand3D1 ;SPointer to Control;SFocus Form;SAuto Next;}
Bitmap Directories List Box
Click on the Go button to continue.
{NBB1N0;CNCommand3D2 ;SPointer to Control;SFocus Form;SAuto Next;}
When you click on the Add Path Button the path you have in the Bitmap Directories Text Box will be added to the list box below it.
Click on the Go button to continue.
{NBB1N0;CNBrowseButton ;SPointer to Control;SFocus Form;SAuto Next;}
The Delete Path Button will delete the path you have selected in the list box.
Click on the Go button to continue.
{NBB1N0;CNCommand1 ;SPointer to Control;SFocus Form;SAuto Next;}
Browse Button Control
Pressing the Browse button will pop up a file dialog to automate the entry of the path and/or filename for the current field.
Click on the Go button to continue.
{NBB1N0;CNCommand2 ;SPointer to Control;SFocus Form;SAuto Next;}
The Accept Button accepts and records the changes made.
Project Management mode allows one or more help authors to create many help source files and compile them all into a finished help file.
I will now give you a tour of the Project Management form.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNListFileHeader ;SPointer to Control;SAuto Next;}
The Project Directory: Label displays the current directory of the Project.
Click on the Go button to continue.
{NBB3N0}
List File Header contains other information relative to the individual source file. File is the name of the HLX file. File ID is an ID that the Project Manager assigns to the file. Status shows if the file is available to work with, in use locally on your machine, or in use somewhere else on the network.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNProjectFileList ;SPointer to Control;SAuto Next;}
List File Header (cont'd)
.rtf and .h shows the status of the RTF and MAP files: No=not existing, Yes=existing and up to date, Old=old file(s) and needs to be updated, ???=map file exists and is external.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptSortFilename ;SPointer to Control;SAuto Next;}
The File Selection Listbox provides a list of Help Magician source files (.hlx) that are part of the currently opened project.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptSortFileID ;SPointer to Control;SAuto Next;}
The Sort List By Filename option shows all members of the project sorted by filename.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectOpen ;SPointer to Control;SAuto Next;}
The Sort List By File ID option shows all members of the project sorted by their file ID.
Click on the Go button to continue.
{NBB3N296}
The Open Button opens currently selected source file member of the project for editing. When you are editing this file, other users on the network cannot access this file.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectClose ;SPointer to Control;SAuto Next;}
Open Button (cont'd)
Note that you can only edit one source file member at a time, if its available. When you open a source file member, any other one that may be in the editor will be closed and the new one will be opened.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectAddfile ;SPointer to Control;SAuto Next;}
The Close Button closes the current source file member that you are editing and clears the editor. Note that you cannot close someone else's file. Closing the file also makes it available to other help authors in a network environment.
Click on the Go button to continue.
{NBB3N0}
The Add File Button brings up a file dialog box prompting you for a Help Magician source file (.hlx) that will be added to the project.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectNewfile ;SPointer to Control;SAuto Next;}
If you select a file that exists in another path that is different from the current projects path, the file will be moved to the current projects path and tagged as a member of a project.
Once a file has been added to a project, it cannot be edited as a single file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectImport ;SPointer to Control;SAuto Next;}
The New File Button prepares the editor for a new file. If you had a modified source file in the editor, you will be asked if you wish to save it.
Once the New File is "Saved File As", it is then added to the project file following the same procedure as Add File above.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectRemove ;SPointer to Control;SAuto Next;}
The Import Button brings up the Import Form. Once a file is imported and Saved As, it is then added to the project file following the same procedure as Add File above.
For more information on this topic see the Import category.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectMove ;SPointer to Control;SAuto Next;}
The Remove Button removes a currently selected source file in the File Selection listbox from the project. Any references to the file in the project database are also removed. You will be given an option to delete the source file from disk.
Note that you cannot remove a file if it is currently in use. This command is password protected.
Click on the Go button to continue.
{NBB3N0}
The Move Button will move a currently selected source file to another directory of choice.
The new full path will be displayed in the File Selection listbox.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectCopy ;SPointer to Control;SAuto Next;}
Move Button (cont'd)
Note that if you are doing a team development effort, this file will no longer be available to other team members on the network (because it will be located in a directory different from the projects path). This command is password protected.
Click on the Go button to continue.
{NBB3N0}
The Copy Button will copy a currently selected source file to another directory of choice. The new full path will be displayed in the File Selection listbox.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectXRef ;SPointer to Control;SAuto Next;}
Copy Button (cont'd)
Note that if you are doing a team development effort, this file will no longer be available to other team members on the network (because it will be located in a directory different from the projects path). This command is password protected.
Click on the Go button to continue.
{NBB3N0}
The XRef Button scans all source file members of the project and refreshes the project database of all context strings, context numbers, and topic titles.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectDelete ;SPointer to Control;SAuto Next;}
XRef Button (cont'd)
It will find duplicates and produce a duplication report which you can view and print. You may need to do this if the database gets corrupted (through power failure or whatever) or you get DB errors.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectGlobalMove ;SPointer to Control;SAuto Next;}
The Delete Button will give you a choice of globally deleting the project file and optionally all its related files. Delete is one of those powerful commands that could be dangerous in the wrong hands- thus it can be password protected.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectGlobalCopy ;SPointer to Control;SAuto Next;}
The Global Project Move Button will globally move the project file and all its related files to another path. All internal path references are updated to reflect the new path. This command is password protected.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectArchive ;SPointer to Control;SAuto Next;}
The Global Project Copy Button will globally copy the project file and all its related files to another path. All path references in the copied file are changed to reflect the new path. This command is password protected.
Click on the Go button to continue.
{NBB3N125}
Archiving is a handy way of backing up your entire project into a single compressed file for moving to a different machine.
All the project-related files are stored in a HZP file, which has the same structure as the industry standard ZIP compression format.
Click on the Next -->> button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectStat ;SPointer to Control;SAuto Next;}
Archive (cont'd)
The archive and unarchive features of the Help Magician require a support program ARCHIVE.EXE to exist in the same directory as HLPMAGIC.EXE - the Help Magician program.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNCmdProjectCList ;SPointer to Control;SAuto Next;}
The Statistics Button allows you to set project-level textual information.
It will also allow you to set the Supervisor password, which controls access to project moving, copying, and deleting
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectFList ;SPointer to Control;SAuto Next;}
The Context List Button reports a listing of all context strings, context numbers (ids), and topic titles for the entire project.
You can view the database in any sorted order. You can also print the contents of the database in any sorted order.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNCmdProjectDone ;SPointer to Control;SAuto Next;}
The File List Button reports a list of all associated files to a help project. It will list project source files, database files, bitmaps, and multimedia files.
You have the option of printing this list to a printer.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdCloseProject ;SPointer to Control;SAuto Next;}
The Done Button accepts and records the changes you have made.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdProjectBuild ;SPointer to Control;SAuto Next;}
The Close Project Button closes the current project you are working on.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNCmdProjectHelp ;SPointer to Control;SAuto Next;}
The Build All Button loads each HLX file in the list one at a time and writes the RTF file and MAP files for the compiler for each HLX file.
This is useful when you have a lot of HLX files to rebuild and want to automate the process.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdTest ;SPointer to Control;SAuto Next;}
The Help Button brings up the Help Magician's own help on the Project Management form.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNProjectHelpLabel ;SPointer to Control;SAuto Next;}
The View HMP Button views the contents of the HMP file, when in project mode.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Help Panel gives you quick help on the controls that your mouse cursor is on.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Project form.
At this point, you can select another category or close the Wizard.
The Spell Checker will check the spelling in your help text from the current page, at the current cursor position, to the end of the file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNPanel3D1 ;SPointer to Control;SAuto Next;}
The Spell Checker includes a standard spelling dictionary and maintains a "user" dictionary so that you can add words specific to your application to the dictionary.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNList1 ;SPointer to Control;SAuto Next;}
The Spell Checker scans the text for words that are not in its dictionary.
When a word is found, it is displayed in the frame at the top of the window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Suggestions List Box
When a misspelled word is found, a list of possible alternatives is displayed in this list box.
Select the properly spelled word or enter a word into the text box above the list.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptionButton1 ;SPointer to Control;SAuto Next;}
"Change to" Text Box
If the correctly spelled word is not in the Suggestion list, you can type the word into the "Change To" text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CYOptionButton2 ;SPointer to Control;SAuto Next;}
Ignore Button
When a misspelled word is found, you can leave this occurrence of the word as is by pressing the Ignore button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptionButton3 ;SPointer to Control;SAuto Next;}
Ignore All Button
When a misspelled word is found, you can leave this occurrence of the word, and all subsequent occurrences, as is by pressing the Ignore ALL button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptionButton4 ;SPointer to Control;SAuto Next;}
Change Button
Press the Change button to replace the misspelled word with the word selected in the list or entered into the text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptionButton5 ;SPointer to Control;SAuto Next;}
Change All Button
Press the Change button to replace the misspelled word, and all subsequent occurrences, with the word selected in the list or entered into the text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNOptionButton6 ;SPointer to Control;SAuto Next;}
Add Button
Press the Add button to add the word to the user dictionary. Subsequent occurrences of the word will be considered to be properly spelled.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Cancel Button
You can end the Spell Check at any time by pressing the Cancel button.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Spell Check form.
As you can see, using the Spell Checker is quite easy. Because of this, there is no "Assist" function for this category.
The Left Indent is the distance from the left most margin to the beginning of the text.
Use the up and down arrows to increment or decrement the left indent or type the desired value into the text box.
Click on the Go button to continue.
{NBB3N0}
I entered 1.00, or one inch, in the left indent text box. If necessary, move the Wizard form so that you can see the effect of this entry on the sample display.
The Right Indent is the distance from the right most margin to the end of the text. Note that text can word wrap before it reaches the right margin.
Use the up and down arrows to increment or decrement the right indent or type the desired value into the text box.
Click on the Go button to continue.
{NBB3N0}
I entered 1.00, or one inch, in the right indent text box also. If necessary, move the Wizard form so that you can see the effect of this entry on the sample display.
The First Indent is the distance from the left most margin to the beginning of the text for the first line only. You would create "hanging indents" with this attribute.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCheck1 ;SPointer to Control;SAuto Next;}
I entered -1.00, or negative one inch, in the first indent text box. If necessary, move the Wizard form so that you can see the effect of this entry on the sample display.
Now, let's look at bulleted lists.
Click on the Go button to continue.
{NBB1N0;SSet Ctl.Value True;SDon't Move Cursor;CNSelectBullet ;SPointer to Control;SAuto Next;}
To enable bulleted lists, put an X in the check box.
The Help button calls the Help Magicians own on line help system and displays the section that describes bulleted lists.
The OK command button finalizes the selection of the bullet character. We're going to accept the default bullet and close the form now.
Click on the Go button to continue.
{NBB1N0;SAuto Next;}
Notice that the bullet character has replaced the "NA" on the bullet selection button.
Click on the Go button to continue.
{NBB1N0;SSet ActiveTab: 1;SDon't Move Cursor;CNFrame3D4 ;SPointer to Control;SAuto Next;}
Now, we're going to look at the settings on the "Border" tab.
You can frame your text with lines or a box and add special effects like shadowing.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFrame3D6 ;SPointer to Control;SAuto Next;}
The "Border Type" options determine how the text will be framed. The "None" radio button means that there will not be a border at all.
The "Left" radio button provides a line to the left of the text. This is the same for "Right", "Top", and "Bottom". The "box" option encloses the text in a box.
Click on the Go button to continue.
{NBB1N0;SSet ActiveTab: 2;SAuto Next;}
The "Border Style" options determine the characteristics of the line(s) selected above.
"Standard" is a single width line. "Double" means that two lines will be used. "Thick" means that the line will be two pixels thick. "Shadow" means that shadow lines will be drawn around the line(s).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFrame3D2 ;SPointer to Control;SAuto Next;}
The "Spacing" tab provides options for the spacing of the help text.
The values are entered in "standard" line increments. You can use the spin buttons to increment and decrement the values or type in the desired values manually.
Click on the Go button to continue.
{NBB1N0;SSet ActiveTab: 3;SPause: 1;SDon't Move Cursor;CNFrame3D1 ;SPointer to Control;SAuto Next;}
The options are self explanatory. The line spacing set here will determine the line spacing of the affected text in the Help Magician editor and in the compiled help file.
Note that the defaults for "Before" and "After" are zero while the default line spacing between lines is one.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFrame3D5 ;SPointer to Control;SAuto Next;}
The "Alignment" tab provides options to set the horizontal alignment and the word wrapping of the text.
The three options in the "Alignment" frame determine the alignment of the text.
Click on the Go button to continue.
{NBB1N0;SPointer Close;SAuto Next;}
The "Force word wrap off" option is only available when you're defining a style, not when directly formatting text.
When this option is set, the text will not word wrap at the right border of the help window but the user will be required to scroll the text if it does not all fit at the current window size.
To set tabs for a paragraph or a style, you would click on the "Tabs" button at the bottom of the form.
I'll click on the button for you.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFrame3D6 ;SPointer to Control;SAuto Next;}
Note that tabs can be set by clicking on the tab ruler on the main form but they can usually be set with greater precision by entering the values in inches.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTabStopTag ;SPointer to Control;SAuto Next;}
First, select the alignment for the tab. Text will flow from the tab in the direction of the selected alignment.
Note that you could also enter the tab value first and then click on the desired alignment radio button. The alignment of a tab can also be changed after it has been entered.
You'll enter the values for the tabs in this text box. The values are valid to two decimal places. If you enter more than two decimal places, the value will be rounded off.
I'm going to enter a value of .5, or one half inch.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText2 ;SPointer to Control;SAuto Next;}
Notice that the value has been added to the list.
This enables the "Delete Tab" and "Delete All" buttons so that tabs can be removed, if necessary.
The default tab spacing text box is used to modify the default tab spacing for a paragraph or a style. Enter the desired value in inches, with up to two decimal places.
I'm going to accept these settings by clicking on the "Accept" button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
When tab settings are anything but the default settings, the text on the "Tabs" button will be in red.
This is done so that you can see if the default settings have been altered without having to open the Tab form each time.
The "Defaults" button causes all of the paragraph settings to be reset to the default values.
I'm going to close the "Paragraph Styles" form now and return to the "Define Styles" form.
Click on the Go button to continue.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
In addition to the paragraph formatting, you can define all of the font specifications for a style.
The typeface, the style (bold, italic, etc.), the point size, the strikethru and underline, and the color of the text can be defined.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
To define the font attributes, click on the "Character" button.
A standard Windows font dialog will pop up.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton4 ;SPointer to Control;SAuto Next;}
To add a style, click on the "New Style" button. The font dialog will pop up and the style will temporarily be name "New Style" and the next available number for a style.
You can rename the style by retyping a name in the text box under the "Defined Style Name" label.
Click on the Go button to continue.
{NBB1N296;SClose All Forms;RClose Form: DefStyle;SAuto Next;}
Click on the "Delete" button to remove any of the defined styles except the default style.
The default, or normal, style cannot be deleted or renamed.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Define Styles form.
At this point, you can select another category or close the Wizard.
Help Magician Pro 95 emulates the WinHelp 95 Help Topics Browser Window that contains the Contents Tab, Index Tab, and the Find Tab.
To show the Help Topics browser window, simply click on the "Help Topics" button on the WinHelp Button Bar just above the Help Magician's editor.
Click on the Go button to continue.
{NBB1N295;SDon't Move Cursor;CNTList1 ;SPointer to Control;SAuto Next;}
Let's look at the options on the Contents Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 1;SEnable All Controls;SAuto Next;}
Contents List Box
Once the Contents Tab is displayed, you can click on books to open them and show other books or topics. To show a topic (listed in the Contents Tab) in the Help Magician's editor window, double-click on a topic or select the topic and click on the Display button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 1;SEnable All Controls;SDon't Move Cursor;CNText1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Index Tab.
The Index Tab in Help Magician works the same way it does in WinHelp 95. The keywords will be read from Help Magician's internal keyword database and displayed in the keyword list. Any related keywords (subentries) will be displayed indented under a listed keyword.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 1;SEnable All Controls;CNKeywordList ;SPointer to Control;SAuto Next;}
Word Search Text Box
You can search the keyword list by typing the first few letters of the word in the textbox at the top of the Index Tab. As you type, the keyword with the closest match will be highlighted in the keyword list.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 2;SEnable All Controls;SAuto Next;}
Keyword List Box
The Keyword list box displays all the keywords that are in your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 2;SEnable All Controls;SDon't Move Cursor;CNCmbWords ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Find Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNCmdClear ;SPointer to Control;SAuto Next;}
Word Search Text Box
This is where you enter the word(s) you want to search for.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNCmdFindNow ;SPointer to Control;SAuto Next;}
The Clear Button clears the text that you have entered in the text box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNFoundTopicList ;SPointer to Control;SAuto Next;}
The Find Now Button will find all the related topics in your help file that have to do with the word(s) you typed.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNChkIgnoreCase ;SPointer to Control;SAuto Next;}
The Topic List Box lists all the related topics to the word(s) you want to find.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNOptMatchWhole ;SPointer to Control;SAuto Next;}
Ignore Case Check Box
When this option is checked, searches will be performed without regard for case.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNOptMatchPartial ;SPointer to Control;SAuto Next;}
Whole word match Radio Button
When this option is checked, the text found must match the search text as a whole word.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNOptAllWords ;SPointer to Control;SAuto Next;}
Partial word match Radio Button
Check this option to find matches to the search text even if the text is only part of a word.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNOptOneWord ;SPointer to Control;SAuto Next;}
All the words you typed in any order Radio Button
The topic must contain all the search words entered but they can be in any order in the topic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNOptExactWords ;SPointer to Control;SAuto Next;}
At least one of the words you typed Radio Button
The topic must contain at least one of the search words to qualify as a match.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;SEnable All Controls;CNPanelStatus(0) ;SPointer to Control;SAuto Next;}
The words you typed in exact order Radio Button
The topic must contain all of the search words you entered and they must be found in the topic in the order in which you entered them.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNCmdOpen ;SPointer to Control;SAuto Next;}
The Panel Status Label will give you quick help on the options your cursor is on.
Click on the Go button to continue.
{NBB1N296;SDon't Move Cursor;CNCmdPrint ;SPointer to Control;SAuto Next;}
The Display Button will display the topic you select.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SEnable All Controls;CNCmdCancel ;SPointer to Control;SAuto Next;}
The Print Button will bring up the print dialog and print only the main topics in the list box on the contents tab.
Click on the Go button to continue.
{NBB1N295;SDon't Move Cursor;SEnable All Controls;CNCmdHelp ;SPointer to Control;SAuto Next;}
The Cancel Button will close the form without saving the changes.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Help Button will give you specific help on this topic.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Topic Outliner form.
At this point, you can select another category or close the Wizard.
[Help Magician Tutorial]
{NBB3N0}
TUTORIAL
In this category, we'll build a help file that describes functions in a fictitious edit menu.
This will be a simple help file for the purpose of becoming familiar with the Help Magician.
Click on the Next -->> button to continue.
{NBB3N0}
As I move the mouse cursor to the various controls required to complete an operation, you'll see how easy it is to create a help file with the Help Magician and you'll learn what to do in order to make your own help file.
Click on the Next -->> button to continue.
{NBB3N0}
Don't be concerned if you don't understand everything that happens during the creation of the Tutorial help system.
When you're ready to make your own help system, the Help Wizard will guide you through any part of the process that you need help with.
Click on the Next -->> button to continue.
{NBB3N0}
IMPORTANT
Please don't click on the Help Magician's main form or the forms that it pops up during the creation of the tutorial help file. I will handle all of that.
Click only on the Go and the Next buttons during the tutorial.
Click on the Next -->> button to continue.
{NBB1Y0;SWant File In Editor: False;SSet WIN31 Mode;SAuto Next;}
I'm going to set the compiler version to 3.1 for the Tutorial. The only difference is the Search/Index button in the WinHelp bar.
Click on the Go button to continue.
{NBB3N0}
The Help Magician maintains a topic and a keyword database for every help system.
We cannot modify topic titles or enter keywords until the database exists on disk.
Briefly, a Context String is an alphanumeric string identifier for the topic used to reference the topic through context sensitivity. Context Strings will be explained in detail in the "Topics" section.
Now we'll enter the Context Number with the Auto Context Number button.
Briefly, a Context Number is a numeric identifier for the topic used to reference the topic through context sensitivity. Context Numbers will be explained in detail in the "Topics" section.
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 1;SClear Editor;CYTextBoxScroll ;K^{HOME}{DOWN}{ENTER};KThe Edit Menu{ENTER}{ENTER};KThe Edit Menu provides functions to cut, copy, and paste text to and from the Clipboard, as well as functions to search for text.{ENTER}{ENTER};KRelated Topics{ENTER};KCut{ENTER}Copy{ENTER}Paste{ENTER}Find{ENTER}Find Next{ENTER};SAuto Next;}
Now, we'll enter the text that we want on our Contents page, including some key words that we'll convert into Links later.
Now we'll enter the title and the context string for the Popup definition of "Clipboard".
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 2;SMainForm Focus Text: *;SLeft Mouse Click:;KClipboard{ENTER};KThe Clipboard is a Windows utility that stores text or graphics that is cut or copied from an application running under Windows.{ENTER};SAuto Next;}
Now we'll enter the text for the Popup definition of "Clipboard".
We're also going to explain the Cut, Copy, Paste, Find, and Find next functions in this help file.
Let's create pages for these topics and enter the title and context string.
We'll start with the Cut topic.
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 3;SClear Editor;SMainForm Focus Text: *;KCutting Text{ENTER}{ENTER};KSelect the text to be cut by holding the left mouse button down and dragging the cursor over the text.{SPACE};KThen select Cut from the Edit Menu or press Shift&Del.{SPACE};KThe text is cut to the Windows Clipboard.;SAuto Next;}
Let's change the style for the title of this topic to "Topic Heading".
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 3;CYPageDownCmd ;SLeft Mouse Click:;SPause: .5;SHelpPage: 4;CYText1 ;SHighlight Text: -1;KCopying Text{ENTER};CYText3 ;SHighlight Text: -1;KCopying_Text{ENTER};SClear Editor;SMainForm Focus Text: *;KCopying Text{ENTER}{ENTER};KSelect the text to be copied by holding the left mouse button and dragging over the text.{SPACE};KThen select copy from the Edit Menu or press Ctrl Ins.{SPACE};KThe text is copied to the Windows Clipboard.{ENTER};K^{HOME};CYStylePanelText ;SStylePanel Click;SPause: 1;CYParaStyleList ;KT;K{ENTER};SAuto Next;}
Now we'll create the Copy topic.
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 4;CYPageDownCmd ;SLeft Mouse Click:;SPause: .5;SHelpPage: 5;CYText1 ;SHighlight Text: -1;KPasting Text{ENTER};CYText3 ;SHighlight Text: -1;KPasting_Text{ENTER};SClear Editor;SMainForm Focus Text: *;KPasting Text{ENTER}{ENTER};KPlace the cursor in the text where the text is to be inserted.{SPACE};KThen select Paste from the Edit Menu or press Shift Ins.{SPACE};KThe text is copied from the Windows Clipboard into the text.{ENTER}{ENTER};KNote that, if text is highlighted during a paste operation, it will be replaced by the pasted text.{ENTER};K^{HOME};CYStylePanelText ;SStylePanel Click;SPause: 1;CYParaStyleList ;KT;K{ENTER};SAuto Next;}
Now we'll create the Paste topic.
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 5;CYPageDownCmd ;SLeft Mouse Click:;SPause: .5;SHelpPage: 6;CYText1 ;SHighlight Text: -1;KFind Text{ENTER};CYText3 ;SHighlight Text: -1;KFind_Text{ENTER};SClear Editor;SMainForm Focus Text: *;KFind Text{ENTER}{ENTER};KSelect Find from the Edit Menu to search for text in the current file.{SPACE};KThere are options to search the current topic or all topics.{SPACE};KThe search can be case sensitive or case insensitive and can be limited to whole word.{ENTER};K^{HOME};CYStylePanelText ;SStylePanel Click;SPause: 1;CYParaStyleList ;KT;K{ENTER};SAuto Next;}
Now we'll create the Find Text topic.
Click on the Go button to continue.
{NBB1Y0;SHelpPage: 6;CYPageDownCmd ;SLeft Mouse Click:;SPause: .5;SHelpPage: 7;CYText1 ;SHighlight Text: -1;KFind Next{ENTER};CYText3 ;SHighlight Text: -1;KFind_Next{ENTER};SClear Editor;SMainForm Focus Text: *;KFind Next{ENTER}{ENTER};KSelect Find Next from the Edit Menu, or press F3, to find the next occurrence of the search text in the current file.{ENTER};K^{HOME};CYStylePanelText ;SStylePanel Click;SPause: 1;CYParaStyleList ;KT;K{ENTER};SAuto Next;}
Notice that the word "Clipboard" is now green and dotted underline. This is the standard appearance for a popup in the Windows help system. The Help Magician emulates the Windows help system so you see your finished product as you work.
We'll test the popup by double clicking on "Clipboard".
It's time to save the file again. Because we saved it earlier, all we need to do is to click on the Save button in the toolbar.
Click on the Go button to continue.
{NBB3Y0}
Now let's create some browse sequences.
Browse sequences are lists of topics that will be viewed in the order in which they appear in the sequence when the user presses the browse buttons << and >> in the WinHelp toolbar.
Click on the Next -->> button to continue.
{NBB3Y0}
This help file covers two basic topics, editing text and finding text. We'll divide the topics in these two categories as browse groups.
When the user is viewing any of the topics in a browse group, they can "browse" the other members of the group.
Now we'll create the "Edit" browse group by clicking on the "Add" button under the "Groups" listbox. Then we'll add the appropriate topics to the group.
Now we'll create the "Find" browse group by clicking on the "Add" button under the "Groups" listbox. Then we'll add the appropriate topics to the group.
First, we'll have to go to a topic that is a member of a browse group. Then I'll click on the browse buttons. Notice how they become enabled and disabled (grayed out) when we reach the first and last topics in the group.
Click on the Go button to continue.
{NBB3Y0}
Now we're going to add some keywords to the help system.
Keywords are words that help the user find topics. The keywords will be displayed in the Search dialog when the files is viewed with WinHelp. I'll demonstrate this after we enter the keywords.
At this point, this is a fully functional help system. There are, of course, many other features we could put into a help system, but we have learned the basics.
First, we'll compile the source by selecting the Build Menu, Rebuild All sub menu.
The VB Help Wizard will scan Visual Basic source code (saved as text) and create a help file shell based on the properties of the controls.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNControlCaption ;SPointer to Control;SAuto Next;}
Control Name Radio Button
If the Control Name radio button is selected (default), the topic titles, heading, and context strings for the topics will be created from the control name as it appears in the properties form in Visual Basic.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFormPrefix ;SPointer to Control;SAuto Next;}
Control Caption Radio Button
If the Control Caption radio button is selected, the topic titles, heading, and context strings for the topics will be created from the control caption as it appears in the properties form in Visual Basic. If the control does not have a caption, the control name will be used.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTOCCheck ;SPointer to Control;SAuto Next;}
Form Prefix Check Box
If the Form Prefix check box is checked, the form name or caption, depending on the Control Name/Control Caption selection, will precede each topic title, heading, and context string, separated with a space, a dash, and another space (Form - Control).
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextStringCheck ;SPointer to Control;SAuto Next;}
Table of Contents Check Box
If this check box is checked a table of contents will be generated on the first page of the help file. The title, heading, and context string will be "Contents". A Jump will be created for every topic that is written to the file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNFileList ;SPointer to Control;SAuto Next;}
Context Strings Check Box
If this box is checked, Context Strings will be written to each page of the help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNTopicTitleList ;SPointer to Control;SAuto Next;}
The File List Box displays all the forms and text files in the make file that is selected.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextStringList ;SPointer to Control;SAuto Next;}
The Topic Title List Box displays the topic titles based on the selections in the Topic Title frame.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNContextNumberList ;SPointer to Control;SAuto Next;}
The Context String List Box displays the context strings based on the selections in the Topic Title frame.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNSelectMakeCmd ;SPointer to Control;SAuto Next;}
The Context Number List Box displays the context numbers that will be written to the help file shell.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWriteHelpButton ;SPointer to Control;SAuto Next;}
Click on the Make File button to bring up a file dialog from which you will select the Visual Basic project.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNHelpCmd ;SPointer to Control;SAuto Next;}
Write/Merge Help Button
The caption on this button will vary depending on whether you selected Entire File or Merge from the VB Help Wizard menu,
Press this button to write or merge the help file shell.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNExitCmd ;SPointer to Control;SAuto Next;}
The Help Button when selected will give you specific help on this topic.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
The Cancel Button when selected will accept and record the changes you have made.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the VB Help Wizard form.
Because it is so easy to use the VB Help Wizard, there is no 'Assist' category.
Select the Tools menu, VB Help Wizard sub menu to scan your VB source and build a help file shell.
The Window Definitions form provides all the functions necessary to setup the appearance and functionality of the main help window and all secondary windows, if defined.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWinDefn ;SPointer to Control;SAuto Next;}
Defined Windows: Less Button
The Help Window Specifications window can be collapsed or expanded to full size. To collapse the Help Window Specification window, click on the Less button. To expand the Help Window Specification window, click on the More button.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdAdd ;SPointer to Control;SAuto Next;}
The Defined Windows List Box lists the defined windows in your help file.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdDelete ;SPointer to Control;SAuto Next;}
The Add Button allows you to add a new window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdRename ;SPointer to Control;SAuto Next;}
The Delete Button allows you to delete the selected window.
You are not allowed to delete the main window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdShowHide ;SPointer to Control;SAuto Next;}
The Rename Button allows you to rename a window. You are not allowed to rename the main window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdShowAll ;SPointer to Control;SAuto Next;}
The Show Button will give you a preview of the selected window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdHideAll ;SPointer to Control;SAuto Next;}
Show Mult Button
Pressing this button will display multiple windows highlighted in the Defined Windows list box.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
The Hide All Button hides all the windows currently displayed.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Accept Button accepts all changes that you made and closes the form.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNPanelHelp ;SPointer to Control;SAuto Next;}
The Cancel Button cancels the changes that you made and closes the form.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdHelp ;SPointer to Control;SAuto Next;}
The Help Panel displays quick help for the control under the mouse cursor.
When this option is checked, the selected window will stay on top.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNWinSizePos ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Position Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1(0) ;SPointer to Control;SAuto Next;}
Window Sizing and Positioning: Check Box
The size and position parameters tell WinHelp where to display the window when it is initially displayed. The window sizing and positioning will be used only if this box is checked.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1(1) ;SPointer to Control;SAuto Next;}
The Top: Text Box displays the coordinates for the top of the window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1(2) ;SPointer to Control;SAuto Next;}
The Left: Text Box displays the coordinates for the left of the window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNText1(3) ;SPointer to Control;SAuto Next;}
The Height: Text Box displays the coordinates for the height of the window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNAdjustForRes ;SPointer to Control;SAuto Next;}
The Width: Text Box displays the coordinates for the width of the window.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;SSet ActiveTab: 2;SPointer to Control;SAuto Next;}
Adjust for screen resolution Check Box
This tells WinHelp to use the coordinates as a percentage of screen size. If you create a window that is 512x512 help units, it will always occupy one half of the screen, regardless of the user's screen resolution.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRegionOption1 ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Colors Tab.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNRegionOption2 ;SPointer to Control;SAuto Next;}
Non Scrolling Region Check Box.
Check this box to specify a nonscrolling region color. If this box is not checked, WinHelp will use the system default colors.
Click on the Go button to continue.
{NBB1N0;SDon't Move Cursor;CNCmdButton4 ;SPointer to Control;SAuto Next;}
Scrolling Region Check Box
Check this box to specify a scrolling region color. If this box is not checked, WinHelp will use the system default colors.
Click on the Go button to continue.
{NB31N0;SPointer Close;SClose All Forms;SAuto Next;}
Select Color Button
When you click on this button the color palette dialog will be displayed for you to choose the color for the currently selected region. Note a dashed line around the sample color box for the selected region.
When you click on this button the color palette dialog will be displayed for you to choose the color for the currently selected region. Note a dashed line around the sample color box for the selected region.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNFrame3D1(2) ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Buttons Tab.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNListButtons ;SPointer to Control;SAuto Next;}
Standard Buttons
This frame contains all of the possible standard buttons for a window. Put an X in the boxes to the left of the buttons you would like on the selected window.
Click on the Go button to continue.
{NB91N347;SDon't Move Cursor;CNCmdAddButton ;SPointer to Control;SAuto Next;}
Custom Buttons List Box
The listbox in the Custom Buttons frame contains all the custom buttons defined for the selected window.
If you click on the add button either an Add or Edit operation will bring up the Create Button dialog box.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNText3 ;SPointer to Control;SAuto Next;}
Button ID
Here, you would enter an alphanumeric string as a unique identifier for the button. This Id would be necessary later if you used another macro referencing the button.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNMacroList ;SPointer to Control;SAuto Next;}
Button Caption
This is where you would enter the text to be used as the caption for the button.
Here, you would select the macro to be executed when the button is pressed. You must have previously created macro definitions from the Macros/Define Macros menu.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdDeleteButton ;SPointer to Control;SAuto Next;}
Edit Button
You would press this button to edit buttons that were previously defined by clicking on the Add button.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCmdClearButtons ;SPointer to Control;SAuto Next;}
Delete Button
This button would delete the button currently highlighted in the Custom Buttons list.
This button will delete all buttons in the list for the currently selected window.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNMacroDrop ;SPointer to Control;SAuto Next;}
Now let's look at the options on the Macros Tab.
Click on the Go button to continue.
{NB91N0;SDon't Move Cursor;CNCommentText2 ;SPointer to Control;SAuto Next;}
Macro Definition to Execute Drop Down Box.
You would click on the down arrow to view a list of defined macros (Macros menu, Define Macros sub menu) to select from. The assigned macro will be executed when the button is pressed.
Click on the Go button to continue.
{NB91N0;SPointer Close;SClose All Forms;SAuto Next;}
Comment Text Box
You can enter a comment in this text box that is related to the highlighted window in the Defined Windows list.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the Windows form.
Select the "Windows" menu, "Assist: Defining Windows" sub menu for assistance in defining windows in your own help file.
We're going to define and set the attributes for a secondary window in your help system
You can have your own help file in memory as we define the window or just follow along for the exercise. I'll open the Window Definitions form for you.
We're going to add a window. I'll click on the Add button for you.
Click on the Go button to continue.
{NBB1N56;SIf No Text Then Stop;CNCommand1 ;RClose Form: MyInput;SLeft Mouse Click: Wait Close;CYWinDefn ;SPointer to Control;SLeft Mouse Click:;SAuto Next;}
Enter the name that you want to assign to the window. This can be any alphanumeric string. This name will be addressed when you designate a secondary window for a jump or as the default window for a topic.
There is a limit of eight characters.
Enter the name now then click on the
Go button to continue.
{NBB1N347;SSet ActiveTab: 0;CYCaptionText ;SPointer to Control;SLeft Mouse Click:;SFocus Form;SAuto Next;}
The Window has been added to the Defined Windows list.
Now, we're going to set the Options on the General tab.
Click on the Go button to continue.
{NBB1N347;SSet ActiveTab: 0;CYCommentText1 ;SDon't Move Cursor;SPointer to Control;SFocus Form;SAuto Next;}
Enter the title, or caption, for this window.
The title will appear in the title bar of the window when it is displayed.
Enter the title then click on the Go button to continue.
{NBB1N347;SSet ActiveTab: 0;CNMaxWindow ;SDon't Move Cursor;SPointer to Control;SFocus Form;SAuto Next;}
Enter a comment (optional) that you want to associate with this window.
Enter the comment then click on the Go button to continue.
{NBB1N347;SSet ActiveTab: 0;CNAutoSizeHt ;SDon't Move Cursor;SPointer to Control;SFocus Form;SAuto Next;}
Make sure there is an X in this box if you want this window to be maximized (full screen) when it appears. Otherwise, remove the X.
Make your selection then click on the Go button to continue.
{NBB1N296;SSet ActiveTab: 0;CNStayOnTop ;SDon't Move Cursor;SPointer to Control;SFocus Form;SAuto Next;}
Put an X in this box if you want the window to be sized to the amount of text in the topic.
If this option is checked, the Maximize Window option will be disabled.
Make your selection then click on the Go button to continue.
{NBB1N296;SSet ActiveTab: 1;CYText1(0) ;SDon't Move Cursor;SPointer to Control;SFocus Form;SAuto Next;}
Check this box if you want this window to stay on top of all other windows when it is displayed.
Other windows will not be able to obscure this window.
Make your selection then click on the Go button to continue.
{NBB1N347;SSet ActiveTab: 2;SDon't Move Cursor;CYRegionOption1 ;SPointer to Control;SAuto Next;}
Set the size and position of the window by entering the coordinates in the four text boxes. The values are relative: full screen = 1024 x 1024.
You could skip this for now. Later, you're going to have the option to set these values on the screen.
When you're ready, click on the
Go button to continue.
{NBB1N347;SSet ActiveTab: 2;SDon't Move Cursor;CYRegionOption2 ;SPointer to Control;SAuto Next;}
Now, let's set the colors for the window we just defined.
Check this box if you want to use any color except the default for the nonscrolling region. Double click on the sample color box to the right to select the color. Later, you will also have the option to set these colors on the screen.
Check this box if you want to use any color except the default for the scrolling region. Double click on the sample color box to the right to select the color.
Later, you will also have the option to set these colors on the screen.
Click on the Go button to continue.
{NBB3N0}
With the Show button, you can size and position the window and set the colors with a sample window as it will appear when displayed by WinHelp
Size and drag the window around with the mouse. When you release the mouse button, the size and positioning are recorded.
The Standard Buttons frame contains all the possible standard buttons for a window. Options that are grayed out are not available for the selected window.
Select the buttons that you want on this window and click on the Go button to continue.
As an exercise, we're going to add a custom button to this window.
If there are no macro definitions in the current file, I'll create a simple definition called "About_Macro".
Click on the Go button to continue.
{NB91N0;SIf No Text Then Stop;CYText3 ;SPointer to Control;SFocus Form;SAuto Next;}
Enter a unique identifier for this button. This can be any alphanumeric string. To avoid conflict with WinHelp's standard button ID's (btn_), you could begin the string with butn_.
Enter the ID then click on the Go button to continue.
{NB91N0;SIf No Text Then Stop;CYMacroList ;SPointer to Control;SFocus Form;SAuto Next;}
Enter the text you want as a caption when the button is displayed.
Enter the caption then click on the Go button to continue.
{NB91N0;SIf No Text Then Stop;CNCmdButton5 ;SLeft Mouse Click: Wait Close;SAuto Next;}
Select the macro to be executed when the button is pressed.
Select the macro then click on the Go button to continue.
{NB91N347;SSet ActiveTab: 4;CYMacroDrop ;SPointer to Control;SFocus Form;SAuto Next;}
Note that custom buttons will be shown on the sample window when you press the Show button with that window selected.
Next, we'll assign a macro to the new secondary window.
{NB91N347;SSet ActiveTab: 4;CYCommentText2 ;SPointer to Control;SFocus Form;SAuto Next;}
Select a macro to be executed when this window is displayed, if desired (macro definitions must have been previously defined).
Select a macro then click on the Go button to continue.
{NBB1N347;CNCmdButton1 ;SLeft Mouse Click: Wait Close;SClose All Forms;SAuto Next;}
The Accept Button accepts all changes that you made and closes the form.
Click on the Go button to continue.
{NBB5N0}
Congratulations. You have just defined a secondary window.
At this point, you can define more windows, select another category, or close the Wizard.
[CallHelp Form Tour]
{NBB1Y315;SAuto Hide Wizard: True;SAuto Disable Form: True;SShow Form: CallHelp;SWait For Form: CallHelp;SEnable All Controls;SDon't Move Cursor;CNHelpFile ;SPointer to Control;SAuto Hide Wizard: False;SAuto Next;}
There are several ways of calling WinHelp 4.0 in Win95 and they are all available from the Call Help form.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNHelpTopic ;SPointer to Control;SAuto Next;}
The Help File: Text Box displays the currently loaded HLX filename with an HLP extension.
You may change the name in the text box to another help file or search for one using the Browse button. Simply click in the text box, select the Browse button and choose a help file using the file directory dialog.
If any help topics have had context numbers assigned, they will appear in the Help Topic drop down box. Select one of the help topics to have WinHelp display it when called.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCallHelpAs1 ;SPointer to Control;SAuto Next;}
Select the Normal Radio Button to call WinHelp as if it were a stand alone application.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCallHelpAs2 ;SPointer to Control;SAuto Next;}
Select the Popup Radio Button to call WinHelp as if it were called from an application as a popup window.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCallHelpAs3 ;SPointer to Control;SAuto Next;}
Select the Training Card Radio Button to call WinHelp as if it were called from an application running the training cards feature.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNAutoDisplay ;SPointer to Control;SAuto Next;}
Select the Context Sensitive Radio Button to simulate calling WinHelp from an application using context sensitive help.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNOnTop ;SPointer to Control;SAuto Next;}
Use this feature to view consecutively mapped topics. After the Help file is displayed, you may see the next mapped topic by repeatedly selecting the View Help button.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdButton1 ;SPointer to Control;SAuto Next;}
By selecting the Keep Call Help Window Visible Check Box you will always be able to reach the Call Help window.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdButton2 ;SPointer to Control;SAuto Next;}
The Browse Button will help you locate the file you are searching for.
Click on the Go button to continue.
{NBB1N0;SDon't Hide Wizard;SDon't Move Cursor;CNCmdButton3 ;SPointer to Control;SAuto Next;}
Select the Done button to close the Call Help dialog window.
Click on the Go button to continue.
{NBB1N0;SClose All Forms;SPointer Close;SAuto Next;}
Select this button to view the Help file.
Click on the Go button to continue.
{NBB5N0}
This concludes the tour of the CallHelp form.
At this point, you can select another category or close the Wizard.