Step 2 – Connecting a Help File to an AVR Application       57 
Winhlp32 Parameters
You will probably want users to access your Help File from a Help Menu included 
in your application.  This involves creating the Menu controls by using Menu Editor, 
then using the OSEXEC command to execute the help file, using WINHLP32, 
specifying any additional parameters as needed. 
If you want to call a particular topic from a Help button included on your form, you 
use OSEXEC/EXEC, but you also need a pass a Winhlp32 parameter to identify 
the individual topic in which you want to display.
The following is a listing of the WINHLP32 parameters.  
Winhlp32.exe Parameters 
winhlp32.exe [[-H] [-G[n]] [-W window-name] [-K keyword]
[-N context-num] [-I topic-id] [-P pop-up-id] HLP-
filename]
The following parameters may be used when starting Winhlp32:
Parameter 
Description
-G[n] 
Creates a configuration (.gid) file and quits. If a number is 
specified, it determines which extensible tab to display by 
default the first time the Help file is opened. A value of 1 
would be the first tab beyond the Find tab. 
-H  
Displays the Winhlp32.hlp Help file.
-I topic-id 
Displays the Help topic with the specified the topic ID. 
-K keyword 
Displays the topic identified by the specified keyword.  The 
keyword cannot contain any blanks.
-N context-num 
Displays the topic specified by the context number (defined in 
the [MAP] section of the project file).
-P pop-up-id 
Displays the specified pop-up topic. You must use the -P 
switch in combination with the -I or -N switch, as shown in 
the following examples:
WINHLP32 -P -I EXEC_WINHELP HCW.HLP
WINHLP32 -P -N 311 MYFILE.HLP
-W window-name Displays the topic in the specified window definition.
HLP-filename 
Specifies the Help file to display. If a name is not specified, 
the File Open dialog box appears.
Examples: 
The following examples show how you would call a particular topic in a help file 
from a help button using the Winhlp32 parameters in Caviar. 
The following displays the help topic identified by Context number 12 (in the map 
file) in "Myhelp". 
OSEXEC "Winhlp32.exe -n12 Myhelp.hlp"
The following displays the help topic identified by the Keyword "Name” in 
"Myhelp". 
OSEXEC "Winhlp32.exe -kName Myhelp.hlp"
The following displays the help topic identified by the Topic ID called 
"New_Customer_Information” in "Myhelp". 
Changing pdf to jpg on - Convert PDF to JPEG images in C#.net, ASP.NET MVC, WinForms, WPF project
How to convert PDF to JPEG using C#.NET PDF to JPEG conversion / converter library control SDK
conversion of pdf to jpg; changing pdf to jpg
Changing pdf to jpg on - VB.NET PDF Convert to Jpeg SDK: Convert PDF to JPEG images in vb.net, ASP.NET MVC, WinForms, WPF project
Online Tutorial for PDF to JPEG (JPG) Conversion in VB.NET Image Application
convert pdf pictures to jpg; change from pdf to jpg
58      Palooza 2001 Help Labs 
OSEXEC EXEC "Winhlp32.exe –INew_Customer_Information
Myhelp.hlp"
The following examples show how to display the help topic identified by either a 
Keyword or Topic ID in a Popup window in "Myhelp". 
OSEXEC EXEC "Winhlp32.exe –P -KName Myhelp.hlp"
OSEXEC EXEC "Winhlp32.exe –P - INew_Customer_Information
Myhelp.hlp"
If you will not be calling the help topic using a number from a map file (-n), and your 
keyword(s) for the help topic have spaces, then you must either use the –I parameter, or 
the CommonDialog control’s help properties.   
Creating Context-Sensitive Help from an Application
So far, we have used AVR code to call an entire help file, and, by passing a 
Winhlp32 parameter, we have called a particular topic within that help file.   
In this section, we will adding Context-sensitive help to the IOFields.   There are 
basically only two steps you must perform within Visual RPG.  There is no 
additional coding that needs to be done. 
1. 
Specify the name of the Help File created for the application in Project - 
Project Settings.
2. 
Assign the appropriate HelpContextID or HelpKey created in the Help file to 
the desired fields using either the HelpContextIDHelpKey, or 
WhatsThisHelpID properties.
Specifying the Help File for the Project 
You must first tell the AVR application what the name and location of the Help file 
for this application is.  You specify the name of the Help file in Project - Project 
Settings – Project tab. 
To Specify a Help File for the Project 
1. Select Project - Project S
ettings
In the Project tab, there is a field for you to enter the Help file name for the 
application.   
2. Enter the help file name of Helpfile.hlp, or click the button to the right to 
browse for the file.
VB.NET PDF File Merge Library: Merge, append PDF files in vb.net
combine various scanned images to PDF, such as tiff, jpg, png, gif PDF together and save as new PDF, without changing the previous two PDF documents at
batch pdf to jpg converter; convert multi page pdf to single jpg
C# PDF Convert to Tiff SDK: Convert PDF to tiff images in C#.net
PDF. Supports tiff compression selection. Supports for changing image size. Also supports convert PDF files to jpg, jpeg images. C#
convert pdf into jpg online; convert pdf to jpg
Step 2 – Connecting a Help File to an AVR Application       59 
3. 
Select A
pply and OK when finished.
Assigning Context-Sensitive Help in the Application 
Once the help file is specified for the project, you are ready to begin using the 
HelpContextIDHelpKey or WhatsThisHelp properties.   
In this section, we are going to be using the HelpContextID and HelpKey 
properties. 
• 
You call topics using the HelpContextID property by specifying an associated 
MAP number’ that is contained in the .HH file. 
• 
You call topics using the HelpKey property by specifying an associated 
Keyword’ for that topic.   
Using the HelpContextID Property 
To Use the HelpContextID Property 
1. Open or view the MAP file assigned to the help file (Helpfile.HH).  In this 
section we will only be using the following map numbers. 
#define Cust_No_ 
#define Name  
#define Address_1 
#define Address_2 
#define City  
#define State  
#define Zip  
2. Select the Cust No IOField and enter the number 2 into the HelpContextID 
property. 
VB.NET Image: PDF to Image Converter, Convert Batch PDF Pages to
used commonly in daily life (like tiff, jpg, png, bitmap format in VB programming code, like changing "tif" to users are also allowed to convert PDF to other
convert pdf images to jpg; reader convert pdf to jpg
C# Tiff Convert: How to Convert Raster Images (Jpeg/Png/Bmp/Gif)
Give You Sample Codes for Changing and Converting Jpeg, Png RasterEdge.XDoc.PDF.dll. String inputFilePath = @"C:\input.jpg"; String outputFilePath = @"C:\output
best convert pdf to jpg; to jpeg
60      Palooza 2001 Help Labs 
3. Select the rest of the IOFields and enter their corresponding Map number into 
the HelpContextID property. 
IOField 
HelpContextID 
Name 
Address 1 
Address 2 
City 
State 
Zip 
4. Run the application and press F1 into each of the IOFields The following will 
display when F1 is pressed in Cust No
Note that Winhlp32 is launched, the entire Help Window is displayed, and 
the Contents tab and topic are displaying the associated topic assigned to 
that map number. 
Using the HelpKey Property 
If you do not want to generate a MAP file, you can use the HelpKey property.  In the 
HelpKey property, you enter a keyword string associated with that topic.  Note that 
you may have many keywords assigned to a topic, but you only need to specify one, 
and it doesn’t matter which one, and blanks are accepted. 
AVR looks at the HelpContextID property first (as long as WhatsThisHelp is not 
enabled), so we also need to select the HelpContextID and enter 0. 
To Use the HelpKey Property 
1. Select the Cust No IOField and enter the keyword Cust No into the HelpKey 
property. 
2. Select the HelpContextID property and enter a 0. 
3. Enter the following Keywords for each of the following help topics. 
XDoc.HTML5 Viewer for .NET, All Mature Features Introductions
PowerPoint: PPT, PPTX, PPS, PPSX; PDF: Portable Document Raster Image Files: BMP, GIF, JPG, PNG, JBIG2PDF in or zoom out functions, and changing file rotation
best pdf to jpg converter for; changing file from pdf to jpg
Step 2 – Connecting a Help File to an AVR Application       61 
IOField 
Help Keyword 
Cust No 
Cust No 
Name 
Name 
Address 1 
Address 1 
Address 2 
Address 2 
City 
City 
State 
State 
Zip 
Zip 
4. Select the HelpContextID property and enter a 0 for each IOField. 
5. Run the application and press F1 into each of the IOFields
Note that when Winhlp32 is launched, the entire Help Window is 
displayed, and the Contents tab and topic are displaying the associated 
topic assigned to that keyword. 
Enabling Secondary Windows 
In Help files, there is one Main window. The Main window is the default window.  
All topics automatically display in the Main window unless you specify otherwise. 
You can create other custom windows called Secondary windows. You can specify 
the appearance, and attributes, and options of the both windows to make it fit into 
your overall Help system design. 
A secondary window is specified by indicating a > sign followed by the name of the 
secondary window to display, either within the help or when specifying the help file 
within AVR.  
Note that there is a secondary window enabled by default within any help file called 
Second   
In this section, we will specify that the help topics display in a secondary window for 
the application.   
Note that secondary windows are only enabled for the HelpContextID and 
HelpKey properties, and is ignored when using the WhatsThisHelpID property. 
62      Palooza 2001 Help Labs 
To Specify a Secondary Window for the Help Project’s 
HelpContextID and HelpKey Properties 
1. Go back into Project – Project Settings and specify the Secondary window 
called “second’ by entering a >second after the name of the help file, as shown 
below. 
2. Run the application.   
3. Press F1 in Cust No
4. Notice this time that the Help topic displays in a ‘smaller” window with the 
specification set for the Secondary window in the help file as far as position, 
size, options, and color, as shown below. 
Even though Winhlp32 is launched, you do not see the “Contents tab for the 
help file.  This is a convenient way to display the topics, since if the user 
wants to view more information in the help file, they only need to select the 
Help T
opics button.   
Also, the height of the secondary window automatically fits the size of the 
text, so the window is smaller than displaying the text to the Main window. 
Step 2 – Connecting a Help File to an AVR Application       63 
Using the WhatsThisHelpID Button and Property 
In this section, we will use the WhatsThisHelpID property and WhatsThisHelp 
button to display context-sensitive help in a ‘popup’ window.   
Note that if you want to use WhatsThisHelp popups, a MAP file must be 
generated for the specified help file, as there is not a property to specify a 
keyword.
To Use the WhatsThisHelp Property 
1. 
Be sure to specify the name of the help file for the application by selecting the 
Project tab within Project – Project Settings.
Note that you can still leave the >Second after the help file to specify a 
secondary window.  It will not affect the displaying of WhatsThisHelp 
popups, as it will be ignored. 
2. 
Next, get the “whats this help” topic context-id numbers assigned to the help 
topics from the help authoring person, or from the MAP file (.HH) that was 
generated by the Help file.
The following are the Map numbers we will use in this section in conjunction 
with the WhatsThisHelpID property. 
#define Whats_This_Help_CustNo
9
#define Whats_This_Help_Name
10
#define Whats_This_Help_Address1
11
#define Whats_This_Help_Address2
12
#define Whats_This_Help_City
13
#define Whats_This_Help_State
14
#define Whats_This_Help_Zip
15
Property Settings for the Form 
3. 
There are several form properties that must be set to enable AVR to use 
WhatsThisHelp, along with the WhatsThisHelp button.  Click on the form, 
and set the following properties as listed below.  
Property 
Setting 
BorderStyle  
Use 1, 2 or 3
MaxButton  
Set to False
MinButton  
Set to False
WhatsThisButton  
Set to True
WhatsThisHelp  
Set to True
4. Select the Cust No IOField and enter the number 9 into the WhatsThisHelpID 
property. 
5. Select the rest of the IOFields and enter their corresponding Map number into 
the WhatsThisHelpID property, as listed below. 
64      Palooza 2001 Help Labs 
IOField 
HelpContextID 
Name 
10 
Address 1 
11 
Address 2 
12 
City 
13 
State 
14 
Zip 
15 
6. Run the application.   
7. Click on the WhatsThisHelp button in the Form’s Title Bar, then click in the 
Cust No. IOField.  The WhatsThisHelp topic for Cust No will display in a 
popup window, as shown below. 
8. 
Click on the other fields, and their corresponding information will display in a 
pop-up window.
Note that you can also select the F1 key in the IOField, and the 
WhatsThisHelp popup will display as well. 
Note that if the WhatsThisButton is used, the Form’s Minimize and Maximize 
buttons are not enabled.  You can still utilize the WhatsThisHelp popup 
capability without using the WhatsThisHelp button.  To do this, simply set the 
WhatsThisButton button to false for the form, but keep WhatsThisHelp to 
true. 
9. Click on the form and set the WhatsThisButton property for the Form to False 
and set the MinButton and MaxButton properties to True
Step 2 – Connecting a Help File to an AVR Application       65 
10. Run the application again.   
Notice that the Minimize and Maximize buttons are enabled, and that there is no 
Help button.  However, WhatsThisHelp is still enabled, so AVR will launch the 
number in the WhatsThisHelpID properties when F1 is pressed, and will ignore 
if there is an entry in the HelpContextID or HelpKey properties. 
Congratulations! 
You have just completed the process to connect a Help file to an AVR 
application. 
Continue with the next Step for the instructions to connect a WebHelp file to a 
similar Web application. 
66      Palooza 2001 Help Labs 
This Page Intentionally Left Blank 
Documents you may be interested
Documents you may be interested