Diagram Toolbox

Ribbon

Design > Diagram > Toolbox

Keyboard Shortcuts

Alt+5

Other

You can display or hide the Diagram Toolbox by clicking on the or icons at the left-hand end of the Caption Bar at the top of the Diagram View.

Search for a Toolbox page or icon

The easiest way to locate a Toolbox page or specific icon that you require is to use the 'Find Toolbox Item' dialog, which you display by clicking on the button at the top of the Toolbox. The 'Find Toolbox Item' dialog displays every Toolbox page, listed by Technology name and page name, in alphabetical order.

The columns that display on this dialog can be added to using the 'Field Chooser' dialog (right-click on the column headings and select the 'Field Chooser' option), and dragged into a different sequence. You can also select options to use the 'Group Box' to reorganize the display of information in the dialog, and to expand or hide the contents of every Diagram Toolbox page. You can expand the Toolbox pages individually by clicking on the white arrowhead to the left of the page name.

To locate a Toolbox page or icon, you can type some or all of the characters in the name or property of the object you are searching for in either:

• The 'Search Term' field or
• The appropriate Filter Bar field underneath each column header (right-click on the column headers and select the 'Toggle Filter Bar' option) or
• 'Search Term' and Filter bar fields in combination to further refine the search

As you type, the list immediately reduces to show only the objects that have those characters in their name or property text.  Be aware that if you have the list collapsed, showing only the Toolbox page name, the list might show page names that do not include the characters. Those pages do contain objects that have those characters. The search automatically selects the first object in the list; to move to the next object, press the Down Arrow key.

To confirm what the object is that you have positioned the cursor on (especially if you do not want to use all the columns available in the 'Field Chooser' dialog) the stereotype and page name for the object display in the bottom left corner of the dialog.

Having located the Toolbox page or object you require in the dialog, you click on the Add to Diagram button or drag the objects onto an open diagram to generate elements or connectors. You can also drag element icons into the Specification Manager to generate elements there.

If you want to refresh the Diagram Toolbox to display the Toolbox page you have selected, so that you can use all the icons in it during this session, either:

• Click on the Activate Toolbox button, or
• Double-click on a page name or an object in the 'Find Toolbox Item' dialog, or
• Right-click on an object in the list and select the 'Show Toolbox' option

The context menu also provides options to

• Pin the Toolbox page to the Diagram Toolbox so that it is always included there until it is specifically unpinned
• Move the cursor to the first Filter Bar field ('Name') to edit it
• Hide the Filter Bar
• Expand or collapse all the Toolbox pages displayed in the dialog

Search for an icon on the current Toolbox page

To locate an element or link on the currently-displayed Toolbox pages, simply overtype the Search field at the top of the Toolbox with some or all of the characters of the object name. The field filters the pages to show only those objects that have those characters in their names.

To clear the field, click on the icon or press the Delete key or Backspace key.

This facility is very useful if you have long pages of elements or several pages pinned in the Toolbox (see the Customize the Toolbox section).

Display a full list of pages

Click on the icon at the left of the Toolbox toolbar. This displays an extensive list of Toolbox pages, through which you can scroll until you find the name of the pages you want. You can scroll using the mouse wheel or up arrow and down arrow keyboard keys, or by clicking on the small black arrows at the top and bottom of the list window. Click on the required name to display the pages in the Toolbox.

For the selected option a number of pages might display, but these generally include:

• <type> Elements
• <type> Relationships
• Common and
• Artifacts

If you select the <default> option, right at the end of the list, you display only the 'Common' and 'Artifact' pages.

Customize the Toolbox

You can customize the Toolbox display by pinning pages within the Toolbox, or by adding MDG Technologies and UML Profiles to the Toolbox.

1

In the Project Browser, double-click on the icon against the required diagram.

The diagram opens with the appropriate Toolbox pages for that diagram type.

If you want a different set of elements and connectors, select the appropriate Toolbox pages as explained previously.

2

Click on the icon for the required item; for example, the Class element or Associate relationship.

3

For element items, click anywhere on the diagram to place the new element at the cursor position.

4

For connector items, drag the cursor between the source and target elements on the diagram; as you pass the cursor over the elements, a hatched border displays inside each element's solid border, indicating the source and potential target elements.

To add bends to the connector, press Shift as you change the drag direction of the cursor.

Alternatively, drag from the source element to an empty area of the diagram; the Quick-linker suggests common target element types and connector types to create.

5

Edit the element properties or connector properties, as required.