dialog-help-button-setter

Generic function

Summary

Specifies the Help button in the specified dialog.

Signature

dialog-help-button-setter help-button dialog => help-button

Arguments

help-button

An instance of type false-or(<button>).

dialog

An instance of type <dialog-frame>.

Values

help-button

An instance of type false-or(<button>)

Library

duim-frames

Module

duim-frames

Description

Specifies the Help button in dialog. Many dialogs contain a Help button that, when clicked, displays a relevant topic from the online help system for the application.

Example

In the following example, a simple dialog frame is created, and then its help button is redefined before the dialog is displayed on screen.

define variable *dialog* 
  = make(<dialog-frame>,
         exit-button?: #t,
         cancel-button?: #t, 
         help-callback: 
           method (gadget) 
             notify-user (format-to-string
                            ("Here is some help",
                             gadget))
           end);

dialog-help-button-setter
   (make(<push-button>, label: "Help Me!", 
         activate-callback:
                method (gadget) 
                  notify-user
                    (format-to-string
                       ("Here is some help",
                        gadget))
                end);
         max-width: $fill), *dialog*);

start-frame(*dialog*);

See also

dialog-cancel-button-setter, page 751

dialog-exit-button-setter, page 755

dialog-help-button, page 765

dialog-help-callback, page 767

---

Functional Developer Library Reference: DUIM - 3 Dec 1998