ABOUTBOX

  

DEVELOPER

 

 

Purpose

.AboutBox allows you to create a submenu to be displayed in the Help Menu and to specify the Global function to be called when this submenu item is selected. This is only available for the Application Object Type.
 

Object Type

Application

Syntax

Setting:        Application.AboutBox  = "Global-function-name, Help-menu-item"

Retrieving:    Variable = Application.AboutBox
 

Operation

Global-function-name is the function to be called when the submenu item is selected.
Help-menu-item is the
text to be displayed in the Help menu.
Variable is an alphanumeric scratch variable for the returned value.
 

Remarks

You must supply an OK (or similar) in Global-function-name to dismiss the screen.  

Only one item can be added to the Help menu at a time.  A subsequent assignment to the .Aboutbox property will replace the existing settings with the new ones.  If the property is assigned a null value, any existing menu item is removed.
 

Example

To allow the execution of the CALENDAR Global Function from the Windows Client help menu:
 

Application.AboutBox = "CALENDAR,Customer Calendar"

  
 

The label Customer Calendar is placed at the foot of the drop-down Help menu.  If this new menu item is selected, the CALENDAR Global Screen Function is executed:


To retrieve the current Application.AboutBox settings:
 

$ABOUTBOX = Application.AboutBox

 

If after the above setting $ABOUTBOX will contain "CALENDAR,Customer Calendar".
 

Comment on this topic

Topic ID: 510031