Using the Application-Configured Button

The quick help dialog's application-configured button lets you add custom behavior to any quick help dialog. This button can be used for anything you want, but its intended purpose is to provide a path to more help in one of these two ways:

• Lets the user progressively ask for more information. This is sometimes called progressive disclosure. In this case, the default button label (More) is appropriate.

• Lets the user open a general help dialog for general browsing of the application's help volume. In this case, Browse... is the most appropriate button label.

To Enable the Application-Configured Button

1. Get the button's ID.

2. Add an activate callback to the button.

3. Manage the button.

Example

The following code segment gets the button's ID, assigns a callback, and manages the button. It assumes that quickHelpDialog was just created.

Widget  moreButton;
moreButton = DtHelpQuickDialogGetChild (quickHelpDialog,
                                      DtHELP_QUICK_MORE_BUTTON);
 XtAddCallback (moreButton, XmNactivateCallback,
                MoreHelpCB, NULL);
 XtManageChild (moreButton);

See Also

• "To Create a Quick Help Dialog"

• DtHelpDialog(3) man page

• DtHelpQuickDialog(3) man page