Skip to content

Groupings Widget

joern274 edited this page Feb 26, 2026 · 14 revisions

The Groupings Widget provides a table of all existing groupings. The purpose of groupings is to provide the option to group any number of modules, gates, and nets and highlight them with the grouping color. From within the widget, new groupings can be created, selected in the Graph View, have their name or color changed and deleted.

Groupings Widget

Widget Components

The widget itself comprises three components: a table listing all existing groupings with their id and color, a toolbar at its top, and a context menu that is shown whenever one of the groupings in the table is right-clicked.

Table

The table is the center part of the Grouping Widget and provides an overview of all existing groupings as well as their id and color. The table can be sorted by name as well as id / color and may also be searched using the dedicated search capabilities.

Toolbar

The toolbar comprises the actions

Toolbar

Context Menu

Right clicking a grouping in the table opens the context menu. Context menu entries are

Context Menu

Available Actions

Overall, the Groupings Widget provides access to all the actions listed below. Some of them are available through the toolbar or the context menu, while others can only be accessed by operating on the table itself.

1. Create New Grouping

Creates a new, empty Grouping.

2. Rename Grouping

Opens a prompt to change the name of the selected grouping. The new name must be unique. This action can also be triggered by double clicking the name of a grouping in the table.

3. Change Grouping Color

Opens a color picker dialog to change the color of the selected grouping. The table and the Graph View are updated with the newly chosen color. This action can also be triggered by double clicking the color of a grouping in the table.

4. Add Grouping to Selection

Adds all gates, nets and modules associated with the selected grouping to the current selection.

5. Delete Grouping

Deletes the selected grouping. Gates, nets and modules associated with this grouping are not deleted.

6. Search Grouping

To find a specific grouping, a filter can be applied to the table. Pressing the shortcut CTRL + F while the widget is focused or left-clicking the magnifying glass in the toolbar of the widget toggles the search bar. As a result, only groupings matching the text in the search bar are shown in the table. The groupings can be filtered by their name. The filter is only active when the searchbar is visible. The magnifying glass in the toolbar changes to a green color to indicate that the filter is active.

7. Show Grouping Content

Opens a popup to display the content of the grouping arranged as tree as in module widget. For details concerning the context menu of this tree please refer to the linked page.

Sort Groupings

By default, the groupings are ordered by their name. The order can be reversed by left clicking the Name header. Left clicking the ID / Color header sorts the groupings by their id / color.

Clone this wiki locally