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 'Test Dialog Box' 400 220 iTextBox=RESULT allocrequester 'Create Shadow' 300 119 ShadowReq=RESULT

 

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.

User Contributed Comments For AllocArexxRequester
Dan Kilroy wrote...2006-05-04 16:43:07

Script command submitted from PageStream internal documentation. Needs to be checked and merged with the command documentation above.

Gets the {...} .

reqhandle = AllocARexxRequester (title)


Parameters:


Results:


Notes:


See Also:


Examples:
Python:


ARexx:

Applescript:

User Contributed Comments For AllocArexxRequester