-
Notifications
You must be signed in to change notification settings - Fork 92
Groupings Widget
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.

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.
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.
The toolbar comprises the actions
- Create new grouping (1)
- Rename grouping (2)
- Change grouping Color (3)
- Add grouping to selection (4)
- Delete grouping (5)
- Search grouping (6)
- Show grouping content (7)

Right clicking a grouping in the table opens the context menu. Context menu entries are
- Create new grouping (1)
- Rename grouping (2)
- Select color for grouping (3)
- Add grouping to selection (4)
- Delete grouping (5).
- Show content (7)

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.
Creates a new, empty 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.
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.
Adds all gates, nets and modules associated with the selected grouping to the current selection.
Deletes the selected grouping. Gates, nets and modules associated with this grouping are not deleted.
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.
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.
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.