ChangeItemBinding (or CIB)

Changes the assigned function of a menu item added to a Windows Help menu with the AppendItem macro. This macro can also change the function of one (and only one) standard Help menu item: How To Use Help.

Syntax

ChangeItemBinding("item-id", "item-macro")

CIB("item-id", "item-macro")

Parameter Description

item-id Identifier assigned to the item in the AppendItem macro, or, for the standard How To Use Help menu item, use “mnu_helpon” as the identifier. The item ID must be enclosed in quotation marks.
item-macro Help macro that executes when the user chooses the item. The macro must be enclosed in quotation marks.

Example

The following macro changes the menu item identified by “time_item” so that it starts the Clock application:

ChangeItemBinding("time_item", "ExecProgram(`clock', 0)")

The following macro changes the How To Use Help menu item so that it opens the Contents topic of a custom Help file:

ChangeItemBinding("mnu_helpon", "JumpContents(`hlpbasic.hlp')")

Comments

Use the DeleteItem macro to remove the standard How To Use Help item from the Help menu. Use the SetHelpOnFile macro to specify the custom How To Use Help file you want to use. Then use the InsertItem macro to place the new menu item on the Help menu.

Windows Help ignores this macro if it is executed in a secondary window.

See Also

AppendItem, CheckItem, DeleteItem, DisableItem, EnableItem, InsertItem, InsertMenu, SetHelpOnFile, UncheckItem