Executes a jump to the topic with the specified context string in the specified Help file. Unlike the JumpContext macro, this macro does not require the topic to be defined in the [MAP] section because it takes the topic context string (as defined in the # footnote) as the second parameter.
Syntax
JumpId("filename", "context-string")
JI("filename", "context-string")
| Parameter | Description |
| filename | Name of the Help file containing the context string. The filename must be enclosed in quotation marks. |
| context-string | Context string of the topic in the destination Help file. The context string must be enclosed in quotation marks. |
Example
The following macro jumps to a topic with the “groups_how_pm” context string in the PROGMAN.HLP file:
JumpId("progman.hlp", "groups_how_pm")Comments
If Windows Help cannot find the specified Help file, it displays an error message and does not perform the jump.
If the context string does not exist, Windows Help jumps to the Contents topic for that Help file. (For more information about context strings, see “Inserting Context Strings” in Chapter 6, “Creating Topics.”)
You can use the JumpId macro to display topics in secondary windows by adding the window name to the filename parameter, as in this example:
JumpId("progman.hlp>proc", "groups_how_pm")The topic identified by the “groups_how_pm” context string would appear in the “proc” secondary window.
If you use the JumpId macro without specifying a filename, Help performs the jump in the current Help file, as in this example:
JumpId("", "groups_how_pm")This method is not recommended, but it may be helpful under certain circumstances (for example, you repeat the macro many times in the same Help file and you want to save disk space).
See Also
JumpContext, PopupId