IPF also supports author-defined pushbuttons. For example, you can define a push button for Examples that can be included in the control area of a coverpage or IPF text window. When an author-defined push button is selected, the message HM_NOTIFY is sent to the application or communication object. It is the responsibility of the application or communication object to respond to this message. For information about communication objects, see Controlling Windows with Applications (ACVIEWPORTS).
The push button tag (:pbutton.) defines author-defined push buttons. This tag must be imbedded within the :ctrldef. and :ectrldef. tags, and it must precede the :ctrl. tag.
The following example shows how to override the default set of push buttons in the coverpage window with a set that consists of Search, Index, Previous, and Example.
:userdoc. :docprof toc=123 dll='example' objectname='xmpbutton'. :ctrldef. :pbutton id=xmp res=257 text='~Example'. :ctrl ctrlid=new1 controls='SEARCH INDEX ESC XMP' coverpage. :ectrldef.
Notice that a dynamic link library (DLL) is required to support the function you want to provide with an author-defined push button. For more information, see :pbutton. (Push Button).