ScriptUIExtendScript only
Object

Group

A container for other controls within a window.

Properties

NameType AccessDescription
String read/write Tells the layout manager how unlike-sized children of this container should be aligned within a column or row.
String read/write The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container.
Bounds read/write The boundaries of the element, in parent-relative coordinates.
Object[] readonly An array of child elements.
Boolean read/write True if this element is enabled.
ScriptUIGraphics readonly The graphics object that can be used to customize the element's appearance, in response to the onDraw() event.
String read/write The help text that is displayed when the mouse hovers over the element.
Number 0– read/write The number of pixels to indent the element during automatic layout.
LayoutManager read/write The layout manager for this container.
Point read/write The upper left corner of this element relative to its parent.
Number read/write The number of pixels between the edges of a container and the outermost child elements.
Dimension read/write The maximum height and width to which the element can be resized.
Dimension read/write The minimum height and width to which the element can be resized.
String read/write The layout orientation of children in a container.
readonly The parent element.
Dimension read/write The preferred size, used by layout managers to determine the best size for each element.
Object read/write An object that contains one or more creation properties of the control (properties used only when the element is created).
Dimension read/write The current dimensions of this element.
Number read/write The number of pixels separating one child element from its adjacent sibling element.
String readonly The element type; "group".
Boolean read/write True if this element is shown, false if it is hidden.
Window readonly The window that this element belongs to.
Bounds readonly The bounds of this element relative to the top-level parent window.

Methods

Object

Adds a child element to this container.

type String The type of the child element, as specified for the type property.
bounds? Bounds A bounds specification that describes the size and position of the new control or container, relative to its parent.
text? String The text or label, a localizable string.
properties? Object An object that contains one or more creation properties of the new child (properties used only when the element is created).
Boolean

Registers an event handler for a particular type of event occuring in this element.

eventName String The name of the event.
handler Function The function that handles the event.
capturePhase Boolean When true, the handler is called only in the capturing phase of the event propagation.
Event

Simulates the occurrence of an event in this target.

void

Hides this element.

void

An event-handler callback function, called when the group is about to be drawn.

void

Removes the specified child control from this group's children array.

what Varies The child control to remove, specified by 0-based index, text property value, or as a control object.
Boolean

Unregisters an event handler for a particular type of event occuring in this element.

eventName String The name of the event.
handler Function The function that handles the event.
capturePhase Boolean Whether to call the handler only in the capturing phase of the event propagation.
void

Shows this element.