- Overview
- Starting a full help
- Starting a help for a window or for a control
- Starting the help associated with a window
- Starting the help on a control
- Starting an advanced tooltip (context-sensitive help of a control)
- Associating a context-sensitive help with a control
- Remarks
Starting a help file (CHM or HLP)
Several methods can be used to start a help file (CHM or HLP): - starting a full help: used to open the help file (displays the summary).
In most cases, this operation is performed from a menu option (such as "?.. General help"). - starting the help for a window or a control found in the application: used to open the help file on a specific page. This page presents the different options available in the window or control.
In most cases, this operation is performed via the F1 key or via a help button specific to the window. - displaying an advanced tooltip (help in HLP format only): this context-sensitive help presents the use of a control. This help is displayed via the icon for context-sensitive help (
 ).
The help is started by WHelp. All you have to do is specify the name of the help file to start. The help file opens on the first page of the help defined during the compilation. For example:
// Start the help in HLP format
WHelp("MyHelp.hlp")
// Start the help in CHM format
WHelp("MyChmHelp.chm")
// Start the help in a multilingual application
WHelp("MyHelp" + Nation() + ".chm")
Starting a help for a window or for a control Starting the help associated with a window To start the help associated with a window, use WHelp and specify the identifier of the help page to display. This identifier was defined when creating the help system (in the characteristics of the page). Remark: To automatically create the help button used to display the page corresponding to a window, Drag and Drop the relevant help page to the requested window. The following example is used to start the help page of the "WIN_Configuration_Imp" window. The identifier of this help page is set to 5.
// Start the help in HLP format
WHelp("MyHelp.hlp", 5)
// Start the help in CHM format
WHelp("MyChmHelp.chm", 5)
Starting the help on a control To start a help page on a control: - Specify the number of the page associated with the control in the control description ("Help" tab, "Help number" control).
- Use WHelp associated with NumHelp to start the help page (via a help button for example).
The following example presents the code of a help button. This button is used to open the help page associated with the control currently in edit.
// -- Code of Help button
WHelp("MyHelp.hlp", NumHelp(ControlCurrent()))
Starting an advanced tooltip (context-sensitive help of a control) Associating a context-sensitive help with a control To associate a context-sensitive help with a control: - Display the icon for context-sensitive help in your window ("Icon for context-sensitive help" in the "Style" tab of the window description). If your window is a clipped window (some skin templates in version 11 for example), you must create a button in the window, associated with the preset "Context-sensitive help" action.
- Specify the file for context-sensitive help to use ("Help" tab of window description). This file must be in HLP format.
- Specify the number of the help page associated with the control in the control description ("Help" tab, "Help number" control).
Remark: The file of context-sensitive help associated with the window can be returned and modified by HelpFile. Remarks - The file of context-sensitive help must have the following characteristics:
- no page header.
- no link in the pages of context-sensitive help, as these links would not operate.
- Windows Vista and later: At this time, Windows Vista contains no launcher for starting the help in HLP format (WinHelp32.exe). The help files in HLP format cannot be used in Windows Vista. A version of this program for Windows Vista can be downloaded from the download center of Microsoft site.
|
|
|
|