Select Multiple Elements Dialog
The Select Multiple Elements dialog is used for selecting more than one model element at the same time.
Purpose
This dialog is used for selecting more than one model element at the same time.
It is useful if you need a set of further model elements which cannot be shown in the input selection.
The dialog is also used for changing existing assignment sets, e.g. for properties which can consist of multiple elements.
Dialog Structure
The dialog consists of the top area for adding elements to an assignment set and the bottom area with the assignment list which is adopted as an assignment set with OK. A separator between the areas allows you to change the size of the area within the dialog using the keyboard or mouse.
Add Area
The Add area is similar to the Select an Element dialog and is used for multiple selection of elements for the bottom assignment area.
The area is roughly split into three sections.
- Navigation help, search field and list of selectable elements
- Filters for selectable elements
- Buttons
Elements Which Can Be Selected
Structure:
- At the top on the left are the breadcrumbs (position of an element relative to the root element)
- The search box is at the top-right
- The model structure's tree view is on the left-hand side
- A list of selectable elements is on the right-hand side
The breadcrumbs and tree view are synchronized. The breadcrumbs are a single line which show the complete namespace of the element selected in the tree view
The contents in the list of elements which can be selected depends on two events.
-
Selection
If another element is selected in the tree view, the list shows its subelements which can be selected.
If an element is selected in the tree view, the list only shows its direct subelements which can be selected. If an element can be selected this means that it makes sense to open the elements in the combination they were opened in in the dialog.
Subelements are also shown if an element is expanded in the tree view. Only subelements which have subelements themselves which can be selected are shown. Elements shown in the tree view may be able to be selected but do not have to be. This means that completely different subelements may be shown in the tree view compared to those in the list.
-
Search
If you carry out a search, the hits are shown in the list. The elements have the Select the owner in the tree command in the context menu. The command changes the selection in the tree view but this does not change the list.
Use the search box to find elements which can be selected based on their name. The search starts with the element selected in the tree view and searches its subelements.
If the search box is left empty, gray text shows which element is being searched. As soon as you enter any text, the gray text disappears and the name component you are searching for is shown.
The input help list offers all patterns already used during the session. The search is started with the [Enter] key or using the icon next to the search box.
The list then contains all found elements. The first element in the list is marked.
Filters for selectable elements
You can use the Element Type drop-down list to restrict the tree, list and search result to one element type or stereotype.
The (all) entry shows all element types or stereotypes. After selecting a type, this entry can be attained again by leaving the field empty.
Buttons
Create New Element: Opens the wizard for creating a new selectable element. The new element is adopted in the list of selectable elements and remains part of the model even if the dialog is closed.
Apply: Adopts the selected elements in the assignment list.
Assignment List Area
The lower Assignment List area consists of a table of elements and buttons.
Element List
The table shows the name, element type and element path for the elements which can be assigned with OK.
Buttons
Remove: The button removes the selected elements from the list.
The values of a multi-value property can be sorted using the following buttons:
: The button moves the selected element one place upwards.
: The button moves the selected element one place downwards.
Default buttons
OK: The button adopts the elements in the assignment list and closes the dialog. It is also possible to adopt an empty assignment list using OK.
Cancel: The button closes the dialog without adopting elements as properties.
This chapter contains the topics: