CREATEMENU

From STX Wiki
Jump to navigation Jump to search

CREATEMENU

Create a new dialog-window or attach a dialog to an existing display.

With type DIALOG a dialog-box is created, which can not be resized. For type FRAME or PARENT a frame-window is created, which can be resized. If type is PARENT the window-item name is assigned to the variable PARENT, which identifies the parent-window of an application. If the argument type is the name of a display-item, a dialog-item is created and attached to the display. For the new dialog the basic settings of the dialog font and the margins are applied.

Usage:

CREATEMENU type [ icon title ] [ ; [ owner ] [ /Notmodal ]

Parameters:
type
The type of menu or the name of a display item. Either one of the following keywords:
DIALOG - A dialog box which cannot be resized (the default)

FRAME - A frame window which can be resized. PARENT - A frame window which can be resized where the window-item name is assigned to the shell variable PARENT.

Or the name/id of a display item.
icon
The index of an icon to associate with the window. See the General Descriptions icons for a list of possible icons, or specify an asterisk for the default icon.
title
The window caption.
owner
The display or dialog which owns this dialog. This means:
1) that the owned window is *always* above the owner in the z-order,
2) the owned window is destroyed with the owner by the system
3) the owned window is hidden when the owner is minimized
/N
If the flag /N is specified, the new dialog is modeless.
The default is a modal dialog.
Result:

The name of create menu-item (dialog) or an empty string.

Examples:

See DOMODALDIALOG for an example.