APPLICATION.ABOUTBOX |
DEVELOPER |
 |
|
APPLICATION.ABOUTBOX |
DEVELOPER |
|
Define About Box
Display Logic
Not available under S/390 environments
Purpose
APPLICATION.ABOUTBOX allows you to specify an “about box? for the application. The function, which displays the about box, will be a global screen function that can be called automatically by PROIV. The function is invoked from a new sub-menu item in the Windows’ Client’s Help menu. The text of the sub-menu item is specified in the call.
Syntax
Application.AboutBox = “global-screen-function-name, {sub-menu-text}?
Syntax Elements
Global-screen-function-name
The name of the global screen function that is invoked when the user selects the Help menu item specified in the second parameter.
Sub-menu-text
The sub-menu item text placed into the Windows Client’s Help menu. Selecting this item will invoke the PROIV function named as the first parameter. This parameter can be blank or null only if the preceding comma separator is present.
Remarks
If the function is not a global screen function, or there is no connection to the kernel, it will be ignored. The programmer must supply an “OK? (or similar) to dismiss the screen. Since the executions of report/updates are modal, it is not possible to call the global screen from reports.
Example
Application.AboutBox = “APP_ABOUT_BOX, About My App?
Places a sub-menu item of “About My App? in the Windows Client’s Help Menu. If selected when there’s a connection to the kernel, the PROIV global screen function “APP_ABOUT_BOX? will be executed.
Application.AboutBox = “APP_ABOUT_BOX,?
Places a blank sub-menu item in the Windows Client’s Help Menu. If selected when there’s a connection to the kernel, the PROIV global screen function “APP_ABOUT_BOX? will be executed.
Topic ID: 540005