AddArexxGadget System Command

Adds a control to an allocated dialog box.

addarexxgadget <dbox type left top width [height]> [LABEL name] [LABELPOS pos] [STRING text] [BORDER style] [CHECKED status] [LIST handle] [CURRENT value] [TOTAL value]

dbox/i The dialog box handle.

type/k The control type to add. Options: EXIT | STRING | MULTILINE | TEXT | CHECKBOX | POPUP | CYCLE | SCROLLIST | SLIDER.

left/i The left edge of the control.

top/i The top edge of the control.

width/i The width of the control.

height/i The height of multiline and scrollist controls. Minimum=36

LABEL/s The control's label.

LABELPOS/s The label position relative to the control.

Options: LEFT | RIGHT | ABOVE | ABOVELEFT | ABOVERIGHT | BELOW | BELOWLEFT | BELOWRIGHT | CENTER | CENTERLEFT | CENTERRIGHT | LEFTABOVE | LEFTBELOW | RIGHTABOVE | RIGHTBELOW.

Default=LEFT except for checkbox=RIGHT.

STRING/s The default text of a string, multiline or text control.

BORDER/k The border type of a text control.

Options: NONE | RAISED | RECESSED | SHINE | SHADOW|TEXT.

CHECKED/k The default state of a checkbox.

Options: TRUE|FALSE.

LIST/i The list handle for a popup, cycle or scrollist control.

CURRENT/i The default list item for a popup, cycle or scrollist, or the default slider position (decimal).

TOTAL/d The range of a slider.

Results:
The handle of the new control is returned to RESULT. The handle is required in order to set options and get future results.

Notes:
The width and position of controls does not include the label. Position is not applicable to exit buttons because the label is centered on the button.

The first exit control is always the default control, and the second is always the cancel (Esc) control.

String controls are editable text fields; multilines allow multiple lines of text. Text controls are non-editable text displays.

Precede the character to underscore as a keyboard shortcut in the label name. For example, "_Add" would make "A" the keyboard shortcut for an "Add" control.

There is a maximum number of each type of control which can be added to a dialog box. Exit 10, Multiline 5, Text 10, Checkbox 10, Popup 10, Cycle 5, Scrollist 5, Slider 5. Cycle controls are Amiga only.

Examples:

ARexx:

addarexxgadget dboxid exit 16 114 70 hidden false label 'Cancel'
Cancel=RESULT
addarexxgadget TestReq scrollist 16 8 90 72 hidden false
Fonts=RESULT addarexxgadget iDBox cycle 124 52 200 hidden false label 'Choices'
Choices=RESULT

 

AddArexxGadget  Command Definition  url:PGScmd/addarexxgadget
  created:2006-03-29 17:47:08   last updated:2006-08-17 15:09:35
  Copyright © 1985-2017 GrasshopperLLC. All Rights Reserved.

User Contributed Comments For AddArexxGadget
Dan Kilroy wrote...2006-05-04 16:43:33

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

Gets the {...} .

objid = AddARexxGadget (reqhandle [EXIT left top width | CHECKBOX left top width | STRING left top width | POPUP left top width | CYCLE left top width | SLIDER left top width | TEXT left top width | SCROLLIST left top width height [....] MULTILINE left top width height [....])

Parameters:


Results:


Notes:


See Also:


Examples:
Python:


ARexx:

Applescript:

User Contributed Comments For AddArexxGadget