Grouping Container¶

Container widget for grouping other widgets. When moving a grouping container, all of its contained widgets are moved with it. X and Y coordinates of contained widgets are relative to the top-left of Grouping Container.

By default a Grouping Container is Unlocked as indicated in the top-left corner. Click this indicator to switch the container to Locked. Once locked you will not be able to directly select its contained widgets.

Widgets can be added to a group in two ways:

By dragging and dropping widgets onto the area of an existing Grouping Container.
By selecting existing widgets and choosing Create Group from the right-click context menu.

The bounds of a Grouping Container can be automatically calculated by right-clicking it and choosing Perform Auto Size. The new size will account for all the contained widgets to be visible.

Deleting a Grouping Container will also delete all of its children. You can also delete the group without deleting the children, by right-clicking it and choosing Remove Group.

Basic Properties

Macros (macros): Macros available within this container.

Name (name): Human-readable name of this widget. Shown in the Outline view.

Widget Type (widget_type): Readonly property describing the type of this widget.

Behavior Properties

Actions (actions): Executable Actions attached to this widget.

Enabled (enabled): Unset to make contained control widgets unusable.
Forward Colors (fc): If yes, the Background Color and Foreground Color set by this container are applied to all contained widgets.
Lock Children (lock_children): If yes, contained widgets are not directly selectable.

Rules (rules): Rules attached to this widget.

Scripts (scripts): Scripts attached to this widget.

Show Scrollbar (show_scrollbar): Show a scrollbar when necessary.

Visible (visible): Manage the visibility of this widget.

Border Properties

Border Color (border_color)

The color of the widget border.

Has no meaning with certain types of border styles (for example, raised borders have a fixed style).

Border Style (border_style): The type of border. Some border styles also colorize the background of the widget’s bounding box.

Border Width (border_width)

The thickness of the widget border.

Has no meaning with certain types of border styles (for example, raised borders have a fixed style).

Display Properties

Background Color (background_color): The color of the background of the widget’s bounding box. Only visible when the widget uses a border style that fills up the widget area.

Font (font): The font of the label.

Foreground Color (foreground_color): The color of the label.

Tooltip (tooltip): Tooltip when mouse hovers this widget.

Transparent Background (transparent): Make the container background transparent.

Position Properties

Height (height): Height of the widget area in pixels.

Scale Options (scale_options): If autoscaling is enabled on the Display, then this property allows controlling whether and how this widget participates.

Width (width): Width of the widget area in pixels

X (x): X-coordinate in pixels of the top-left corner of the widget area.

Y (y): Y-coordinate in pixels of the top-left corner of the widget area.