AllocArexxRequester System Command

Allocates a new dialog box which can be opened from an ARexx script. Returns the dialog box handle to RESULT.

allocarexxrequester <name width height>

name/s The title of the dialog box.

width/i The width of the dialog box in pixels.

height/i The height of the dialog box in pixels.

Results:

The handle (identification number) of the new dialog box is returned to RESULT. The handle is required in order to add controls or use the dialog box.

Notes:

The width and height parameters do not take into account the dialog box borders and title bar; they are the inside measurements.

This command does not display the dialog box, but only allocates it. After allocating a dialog box, you can add controls to it and then display it. After you are done with a dialog box, you must unallocate the dialog box and any lists used in it.

Warnings:

You must always unallocate your dialog box before exiting the script!

Examples:
ARexx:

AllocArexxRequester  Command Definition  url:PGScmd/allocarexxrequester
  created:2006-03-29 17:47:08   last updated:2006-08-18 11:07:09
  Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.