Progress
Help Development
Guide


Accessing Online Help with a Help Button

Context-sensitive help should be made available when a user wants to learn about the purpose of a particular window, dialog box, or widget. You can code the Progress application to display a Help button, as shown in Figure 1–8. When the user chooses the button, the help viewer displays the help topic for the current window or dialog box.

Figure 1–8: Dialog Box with a Help Button

For example, when the user chooses the Help button in the Procedure Editor Buffer Information dialog box, the user sees context-specific help for that dialog box, as shown in Figure 1–9.

Figure 1–9: Context-sensitive Help for the Buffer Information Dialog Box

As with menu items, you attach triggers to buttons with the CHOOSE event. In this example, a help trigger is attached to the Help button. In the following code example, a help trigger executes when the user chooses a Help button to access help information from an application window or dialog box:

ON	 CHOOSE OF b_help IN FRAME x
		DO:
			SYSTEM-HELP myhelp.hlp CONTEXT 49154.
		END. 

You can write a help trigger for a field-level widget, a frame, a dialog box, a window, or an application. The following code example demonstrates a help trigger that executes when the current application window has input focus and the user presses HELP:

ON HELP OF WINDOW-1:
		DO:
			SYSTEM-HELP myhelp.hlp CONTEXT 49154.
		END. 


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095