10.5. The View Menu

This menu is used for actions that affect how the various panes are viewed.

10.5.1. Goto Diagram...

This menu entry brings up a dialog box, describing all the diagrams in the current project under ArgoUML.

Figure 10.19. The dialog for Goto Diagram....

The dialog for Goto Diagram....


The dialog box contains a table with three columns and one row for each diagram in the current project. A scroll bar gives access if the table is too long for the box. Double button 1 click on any row will select that diagram in the editing pane. The three columns are as follows.

  • Type. Lists the type of diagram.

  • Name. Lists the name given to the diagram.

  • Description. Shows how many nodes and edges there are on the diagrams. A node is a “2-D” artifact and an edge is a connector artifact.

This dialog box is not modal, which allows it to remain open while editing the model for easy navigation.

[Warning]Warning

The V0.22 implementation of ArgoUML does not inmediately update the dialog box with changes made to diagrams: change of name, addition of diagrams, deletion of diagrams.

10.5.2.  Find...

This menu entry brings up a non-modal dialog box for the ArgoUML search engine.

Figure 10.20. The dialog for Find....

The dialog for Find....


At the top, the dialog box has four tabs labeled Name and Location, Last Modified, Tagged Values and Constraints. Of these all but the first are grayed out in the V0.22 version of ArgoUML (because they are not imlemented yet), so the first tab is always selected.

The Name and Location specifies the search to be made. It contains the following:

  • A text box labeled Element Name: specifies the name of the element (or artifact) to search for. Wild cards (*, ?) may be used here. A drop down gives access to find expressions previously used.

  • A text box labeled In Diagram: specifies which diagrams are to be searched. Again wild cards may be used. Both these two text boxes have a default entry of *, i.e. match anything.

  • To the right of these two text boxes, a selector labeled Element Type: allows you to specify the UML metaclass for which you are searching.

  • A selector labeled Find in: allows the search to be made over the entire project (the default) or as a sub-search over the results of a previous search. When opened, a list of all the search result tabs appears.

  • Beneath these boxes is the button Clear Tabs. This clears the display of tabs with the results from previous searches (see below). This button is downlighted if there are no tabs but the Help tab.

  • And finally, there is the button Find. This causes the search specified in the text boxes and selectors above to be executed. The results are displayed in a tab taking up the lower two thirds of the page.

The lower two thirds of the dialog comprises an initial tab (labeled Help) giving summary help, and further tabs displaying the results of searches. These search tabs are labeled with a summary of the search element  in diagram and are divided horizontally in two halves.

Button 1 double clicking on these tabs removes the tab, and spawns a new window that contains the tab contents, i.e. the search results. This window can be moved and sized at will. This does not work for the help tab.

The top half is labeled Search Results: followed by a count of the number of items found. It comprises a table with one row for each element (artifact) and four columns. The width of the columns can be adjusted.

  • Type. Lists the type of element (artifact).

  • Name. Lists the name given to the element (artifact).

  • In Diagram. Where the artifact is visible on a diagram, this lists the name of the diagram, otherwise it shows N/A.

  • Description. Contains a description of the element (artifact). In ArgoUML V0.18 this seems to be restricted to the single entry docs.

Button 1 click on any row will give more information on that artifact by showing related artifacts in the bottom half (see below). Double click on any row describing an artifact on a diagram and that item and diagram will be selected.

The bottom half of the tab is a table labeled Related Elements: and is a table with the same columns as the top half. When an element (artifact) has been selected in the top half, this table shows the details of any related elements.

[Tip]Tip

Enlarging the dialog vertically shows that the "Related Items" part changes in size, but not the Search results part. However, between them is a divider line and when hovering over this line, the mouse pointer changes into a sizing icon, and the border between these 2 areas can be moved up or down to redistribute the space in the window.

[Warning]Warning

This dialog box is not modal, which allows it to remain open while editing the model for easy navigation. But the V0.22 implementation of ArgoUML does not inmediately update the dialog box with changes made to the found artifacts: change of artifact name, change of diagram name. Deletion of a diagram does not stop the possibility to navigate to it.

10.5.3. Zoom

This entry brings up a sub-entry, which allows scaling the view of all diagrams to a factor of its normal size. This setting is not saved persistently.

The sub-menu items that can be selected are:

  • Zoom Out. Shortcut (Ctrl-Minus). Gives more overview over the drawing.

  • Zoom Reset. Returns to the default zoom ratio (i.e. 100%).

  • Zoom In. Shortcut (Ctrl-Equals). Makes the items on the drawings bigger.

10.5.4. Adjust Grid

This cycles the grid representation on the screen through the following sequence:

  • dots at 16 pixel spacing (the default);

  • dots at 32 pixel spacing;

  • no grid of any form;

  • full grid at 16 pixel spacing; and

  • full grid at 8 pixel spacing.

10.5.5. Adjust Grid Snap

This cycles the spacing of grid snapping through the following sequence:

  • snap at 8 pixel spacing (the default);

  • snap at 16 pixel spacing;

  • snap at 32 pixel spacing; and

  • snap at 4 pixel spacing.

[Note]Note

There is no option to turn off snap to grid altogether

[Caution]Caution

In the V0.22 version of ArgoUML this is not actually a true snap to grid. It just defines the increments by which artifacts are moved around. Thus if an item has an X coordinate of 4 and Grid Snap is set to 8, moving will take it to X coordinates of 12, 20, 28 etc, not 8, 16, 24 etc

If you wish to align on true grid snap boundaries, you can use the Arrange > Align To Grid menu (see Section 10.7.1, “Align”).

10.5.6. Page Breaks

This toggles whether page breaks are shown on the diagram (as white dotted lines).

[Warning]Warning

This menu item does not work in ArgoUML V0.22.