Select an Element Dialog
The Select an Element dialog is used for selecting a model element in a namespace. It is always used if you need another model element which cannot be shown in the input selection.
Purpose
This dialog is used for selecting a model element in a namespace. It is always used if you need another model element which cannot be shown in the input selection.
Dialog Structure
The Select an Element dialog is roughly split into three sections.
- Selectable Elements
- Filters for Selectable Elements
- Buttons
Selectable Elements
It depends what way an element should be selected as to the precise structure of the area. There are two variations:
1st Variation
The header contains the breadcrumbs to the left and the search field to the right.
The tree view of the model structure is shown below this to the left and a list of selectable elements to the right.
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.
- If another element is selected in the tree view, the list shows its subelements which can be selected.
- 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 content of the selected owner is shown in this case in the list; element selection remains the same.
If an element is selected in the tree view, the list only shows its direct subelements which make sense to be selected in the context of 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.
An element is added to the list by double-clicking on it or by selecting it and then pressing the OK button.
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.
2nd Variation
Structure:
- The search box is at the top.
- The model structure's tree view is at the bottom.
The tree view also has all elements which can be selected, unlike with the first variation.
The search box also works in a different way. A hit list is not shown when the search is started. The search looks through the tree and highlights the next suitable element. The search starts with the highlighted element. Both the branch of the highlighted element and the whole tree are searched through. If the search gets to the bottom of the tree it just starts again at the top.
Element Type Drop-Down List
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: Generates a selectable element.
Template Parameters...: The button appears if a class with template parameters is selected for an attribute when selecting the type. Opens a dialog for the declaration of template parameters.
OK and Cancel standard buttons.
This chapter contains the topics: