Grouping

Grouping

Tie sibling widgets together so the editor treats them as one unit, while the exported Python stays flat.

A group is logical metadata — no extra Frame is added, no nesting changes. The generated code is identical to ungrouped widgets.

Group / Ungroup

Action	Shortcut	Menu
Group selection	Ctrl+G	Edit → Group
Ungroup	Ctrl+Shift+G	Edit → Ungroup
Select whole group	—	Right-click → Select Group

Right-click on the canvas or in the Object Tree exposes the same actions.

Selecting a group

Gesture	Result
Click a group member	Selects the whole group
Click again within ~0.8 s	Drills to the single member
Ctrl+Click a member	Toggles the whole group in/out of the selection
Drag any member	Moves every member together

A selected group is shown by an orange bounding box around all members. Per-widget blue outlines are suppressed inside that bbox.

Object Tree

A grouped set appears as a virtual ◆ Group (n) row above its members. Click the row to multi-select the whole group; right-click for Select Group / Ungroup.

Restrictions

• 2 or more widgets required.
• Same parent only — all members must share one container.
• Not inside a layout container — vbox / hbox / grid parents own positioning; grouping is disabled there.
• A widget can belong to at most one group.

---

See also

• Selection
• Object Tree
• Keyboard Shortcuts