ChangeButtonBinding (or CBB)

Changes the assigned function of a button on the Windows Help button bar. You can change the function of the standard Help buttons or any button created with the CreateButton macro.

Syntax

ChangeButtonBinding("button-id", "button-macro")

CBB("button-id", "button-macro")

Parameter Description

button-id Identifier assigned to the button in the CreateButton macro, or one of the following standard Help button IDs:

Button IDButton

btn_contentsContents

btn_searchSearch

btn_backBack

btn_historyHistory

btn_previousBrowse previous (<<)

btn_nextBrowse next (>>)

The button ID must be enclosed in quotation marks.

button-macro Help macro that executes when the user chooses the button. The macro must be enclosed in quotation marks.

Example

The following macro changes the function of the Contents button so that choosing it causes a jump to the Table of Contents topic (identified by the “dict_contents” context string) in the DICT.HLP file:

ChangeButtonBinding("btn_contents", "JumpId(`dict.hlp', `dict_contents')")

Comments

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

See Also

CreateButton, DestroyButton, DisableButton, EnableButton