QM  4.1.1
Model Explorer

The Model Explorer dock window provides the most holistic view of the QM™ model as it contains all model items in a hierarchical tree like structure, reflecting the arrangement of the items within the model. The Model Explorer dock window can be shown or hidden by means of the View->Model Explorer menu or the View Toolbar :

view_explorer.png
Showing/Hiding the Model Explorer Dock Window

At the top-most level, the Model Explorer typically displays: the Model Item, the QP framework (qpc, qpcpp, or qpn), various packages, and directories.

explorer.png
Model Explorer Dock Window

You can use the Model Explorer to:

Attention
Any changes to the model are only allowed for items that are unlocked for editing ().

Reordering Model Items

The order of items within the model has important consequences for code generation and QM™ honors the specific order as much as possible. For example, the class attributes, operations, parameters, etc. as well as states, transitions, and guard conditions within a state machine will appear in the generated code exactly in the order specified in the model.

The Model Explorer provides two ways to reorder items within the model:

The Current Item can be moved up or down within the Model Explorer by means of the Up and Down buttons on the Explorer Toolbar.

Alternatively, the Current Item can be moved up or down within the Model Explorer by means of the keyboard shortcuts: Ctrl-(key-up) and Ctrl-(key-down).

Note
To facilitate better organization of the model and faster navigation within the model, the QM™ tool uses a pre-defined ordering of model items within high-level container items, such as Packages, Classes, State Machines and Directories. For example, class attribute items are always ordered before the operation items. To enforce this ordering, the actions of moving an item up or down might be disabled (grayed out). In this case, you will not be able to move the item in the disallowed direction and the corresponding keyboard shortcut will be disabled as well.

Deleting Model Items

The Model Explorer provides two ways to delete an item from the model:

The Current Item can be deleted from the model by means of the Delete button on the Explorer Toolbar.

Alternatively, the Current Item can be deleted from the model by means of the Delete keyboard shortcut.


Drag-and-Drop within the Model Explorer

The Model Explorer supports drag-and-drop of model items within "container items", such as packages, classes, and directories. Note that drag-n-drop is not meant for reordering model items. Instead the purpose of drag-n-drop is to change the nesting of a given item from one "container item" to another.

To drag an item from one container to another, click on the item within the Model Explorer and while holding the (left) mouse button drag it to another "container item" until the mouse cursor shows that dropping is allowed.

ui_explorer_drag-item.gif
Drag-n-Drop within Model Explorer
Note
Model Explorer "knows" which items can be accepted by which "container item" and will not allow drops on the inappropriate containers (e.g., a directory cannot hold a class). When dropping of a given item is not allowed, the mouse cursor changes to .

Drag-and-Drop into Files

The Model Explorer supports drag-and-drop of model items to File Windows to create Fully-Qualified Item Names inside Code-Generation Directives.

ui_explorer_drag-link.gif
Dragging a link to a File

To drag an item to a file, click on the item within the Model Explorer and while holding the (left) mouse button drag it to an open file until the mouse cursor shows that dropping is allowed.


Item-Specific Popup Menus

explorer_popup.png
Item-Specific Popup Menu

By right-clicking on any item in the Model Explorer you can open the item-specific popup menu, through which you can additionally:


Item-Specific Default Actions

By double-clicking on an item in the Explorer you can execute its default action. The default action for all model items is to expand the item if it is collapsed, and collapse it if it was expanded. Additionally, the default action for diagram and file-template items is to display the diagram or file in the Multiple Document Interface.

Note
The default action never causes any changes in the model and is always safe to execute.

See also
Showing/Hiding Docks & Toolbars

Next: Model Search