Table of Contents Previous Chapter 24 The Type Viewer

24 The Type Viewer

The Type Viewer shows SDL-92 types and type instances in the current system and how they relate to each other. This chapter contains a reference manual to the Type Viewer; the functionality it provides, its menus, windows and symbols.

Objects and Windows

Objects and Attributes

An object in the Type Viewer is either a type or an instance of a type. Both of these may be referred to as a type in the Type Viewer and in this chapter. For each type object, the following attributes can be presented:

The user can hide or show each of the last three text items. By default, the type identifier and the type name is shown.

It is possible to open an SDL Editor by double clicking on a symbol in the Type Viewer. If a type symbol is double clicked, an SDL Editor is opened with that type diagram. If an instance symbol is double clicked, an SDL Editor is opened with the diagram that contains the instance.

Type Viewer Windows

The Type Viewer has two windows, the Main window and the Tree window, which present the type information in the system in two different ways. The Main window lists the type objects without showing inheritance or redefinition relations between them, whereas the Tree window shows such relations for a type object in a tree form. Both windows can display all of the object attributes above, but in somewhat different ways.

The Main window is opened when the Type Viewer is started, whereas the Tree window is not opened initially. The general characteristics of these windows are described in the chapter "The SDT Graphical User Interface" on page 1021.

Updating the Type Viewer

When the Type Viewer is started, it automatically reads in the type information of the current system. If, for any reason, there are problems reading the type information, the user is warned in a dialog and details can be found in the Organizer Log Window. The user may update the Type Viewer at any time, using the Update command (see page 1283).

Error Reporting

The Type Viewer obtains the information about what types are defined in the SDL scope from The Information Server. The Information Server updates its contents each time an SDL diagram is saved. When the diagram is saved, the Analyzer is invoked and produces a mirrored image which is an SDL-PR description of the SDL-GR diagram. That information is then loaded into the Information Server which serves the Type Viewer with information upon request. All of this is done automatically without the user having to bother about performing any actions.

---------------------------------------------------------------------
Note:                                                                  
In order to extract signal information from an diagram, SDT re         
quires the diagram to be syntactically correct in the sense that SDL-  
PR code can be generated from the SDL-GR diagram without en            
countering errors.                                                     
---------------------------------------------------------------------
Any errors are appended to the Organizer Log Window. See "Information Server Error Messages" on page 2471 for a reference to error messages that may be produced by the Information Server.

The Main Window

The Drawing Area

The Main window's drawing area contains a simple line-oriented list of all types in the current SDL system. No inheritance or redefinition relations are shown. The object attributes are listed in the following way (see Figure 346):

Type identifier Type name
<< Qualifier >>

The qualifier is displayed within double angle brackets on a single text line, with slashes separating the path items.

In the list, the type objects are sorted alphabetically according to the diagram type, object type and type name, i.e. all objects of the same diagram type are grouped together.

Figure 346 : Main Window.Figure legend: The Main Window shows an(fig) 
-----
(fig)  
       
       
       
-----
When the user selects a type or instance in the Main window, the Tree window is updated and displays the relation trees that contain the selected type/instance. If the Tree window has not been opened earlier in the same Type Viewer session, the Tree window is opened automatically.

The Menu Bar

The File Menu

Figure 347 : The File Menu. 
-----
(fig)  
       
-----

Update

Updates the type list in the Main Window and the type trees in the Tree Window, according to the possibly changed SDL diagrams (see "Updating the Type Viewer" on page 1281).

This command should be used whenever changes that might have an impact on the type inheritance are applied to any of the SDL diagrams contained in the diagram structure.

Print

Prints the contents of the Main Window. The Print utility is started; see section "SDL Types and Type Instances" on page 1446 in chapter 29, The Print Utility for more information.

Exit

Exits the Type Viewer.

The View Menu

Figure 348 : The View Menu. 
-----
(fig)  
       
-----

Window Options

Sets options for which parts of the Main Window to show. The dialog controls whether to show the Tool Bar and the Status Bar.

Figure 349 : The Window Options Dialog. 
-----
(fig)  
       
-----

List Options

Sets options for which symbols to include in the list in the Main Window. The dialog controls whether to show Instance symbols (type symbols are always shown).

Figure 350 : The List Options Dialog. 
-----
(fig)  
       
-----

Symbol Options

Sets options for which attributes to show for each type object in the list in the Main Window. The dialog controls whether to show the Qualifier, the Type identifier, and the Name of the types and instances.

Figure 351 : The Symbol Options Dialog. 
-----
(fig)  
       
-----

Set Scale

Sets the scale used in the Main Window. The scale is set using a modal dialog:

Figure 352 : The Set Scale Dialog. 
-----
(fig)  
       
-----
The scale can be set between 20% and 800% by using the Slide Bar. 100% is the default.

The Tools Menu

Figure 353 : The Tools Menu. 
-----
(fig)  
       
-----

Search

Searches for a visible text in the type list shown in the Main window.

Figure 354 : The Search Dialog. 
-----
(fig)  
       
-----
If the search reaches the end of the list, the user is asked whether to continue the search from the top of the list or not:

Figure 355 : The Search Continue Dialog. 
-----
(fig)  
       
-----
If the text cannot be found among the visible information, the user is informed in a confirmation dialog.

Search Again

Searches again for the same text as in the latest search. The behavior is the same as for Search above.

Show in Editor

Shows the selected type or instance in an SDL Editor. If a type symbol is selected, an SDL Editor is opened with that type diagram. If an instance symbol is selected, an SDL Editor is opened with the diagram that contains the instance.

Show Type Trees

Opens or raises the Tree window. The type or instance selected in the Main window becomes selected in the Tree window.

Show Organizer

Raises the Organizer's Main window.

Popup Menus

The following tables lists the menu choices in the Main window popup menus and a reference to the corresponding menu choice in the menu bar.

On the Main Window Background

------------------------------------------------
Search           "Search" on page 1286.           
Search Again     "Search Again" on page 1287.     
Show Type Trees  "Show Type Trees" on page 1287.  
------------------------------------------------

On a Symbol in the Main Window

------------------------------------------------
Search           "Search" on page 1286.           
Search Again     "Search Again" on page 1287.     
Show in Editor   "Show in Editor" on page 1287.   
Show Type Trees  "Show Type Trees" on page 1287.  
------------------------------------------------

Keyboard Accelerators

Apart from the general keyboard accelerators, as described in "Accelerators and Mnemonics" on page 1048, the following accelerators can be used in the Main window:

-------------------------------------------
Accelerator  Command (page reference)        
-------------------------------------------
ctrl-E       Show in Editor (see page 1287)  
-------------------------------------------

The Tree Window

The Drawing Area

The Tree window's drawing area visualizes inheritance and redefinition relations between types by presenting the types and instances in a tree form. There are two types of trees displayed in the Tree window:

The two trees for a certain type are often, but not always, identical. The Type Viewer supports the user by checking if they are identical; if so, they are shown as one tree. When the Inheritance and Redefinition trees are different, both are shown separately. Each tree has a header identifying which type of tree it is.

The object attributes are listed vertically in the trees in the following way (see Figure 356):

Type identifier
Qualifier
Type name

The qualifier is displayed in italics in a multi-line form, with each path item on a separate line. No angle brackets or slashes are used.

In the tree, the type objects with the same parent are placed from left to right alphabetically according to the diagram type and object type. The exact placing is based on the type name, as well as the appearance of the objects' substructure.

Figure 356 : Tree Window.Figure legend: The window shows a(fig) 
-----
(fig)  
       
       
       
-----
The Tree window is updated when the selection in the Main window is changed. The Tree window is updated to show the Inheritance and Redefinition trees in the system that contain the type/instance that is selected in the Main window. The first occurrence of that type/instance also becomes selected in the Tree window.

It is possible to view all Inheritance and Redefinition trees in the current system at once in the Tree window (see "Show All Trees" on page 1293). The trees are lined up vertically in the same drawing area.

The Menu Bar

The File Menu

Figure 357 : The File Menu. 
-----
(fig)  
       
-----

Print

Prints the contents of the Tree window. The Print utility is started; see the chapter chapter 29, The Print Utility for more information.

Close

Closes the Tree window without confirmation.

The View Menu

Figure 358 : View Menu. 
-----
(fig)  
       
-----

Expand

Expands the selected object one level down.

Expand Substructure

Expands the selected object as much as possible.

Expand All

Expands all visible trees as much as possible.

Collapse

Collapses the selected object, i.e. hides all child objects.

Window Options

Sets options for which parts of the Tree window to show. The dialog controls whether to show the Tool Bar and the Status Bar.

Figure 359 : The Window Options Dialog. 
-----
(fig)  
       
-----

Tree Options

Sets options for which symbols to include in the trees in the Tree window. The dialog controls whether to show Instance symbols (Type symbols are always shown).

Figure 360 : The Tree Options Dialog. 
-----
(fig)  
       
-----

Symbol Options

Sets options for which attributes to show for each symbol in the trees in the Tree window. The dialog controls whether to show the Qualifier, the Type identifier, and the Name of the types and instances.

Figure 361 : The Symbol Options Dialog. 
-----
(fig)  
       
-----

Show All Trees

Shows type trees for all types in the system.

Set Scale

Sets the scale used in the Tree window. The scale is set using a modal dialog:

Figure 362 : The Set Scale Dialog. 
-----
(fig)  
       
-----
The scale can be set between 20% and 800% by using the slider. 100% is the default. Pressing Set changes the scale and brings down the dialog.

The Tools Menu

Figure 363 : the Tools Menu. 
-----
(fig)  
       
-----

Search

Searches for a text in the type trees shown in the Tree window.

Figure 364 : The Search Dialog. 
-----
(fig)  
       
-----
If the search reaches the end of the trees, the user is asked whether to continue the search from the first tree:

Figure 365 : The Search Continue Dialog. 
-----
(fig)  
       
-----
Pressing the Continue button continues the search from the first node in the first tree.

If the text cannot be found, the user is informed in a confirmation dialog.

Search Again

Searches again for the same text as in the latest search. The behavior is the same as for Search above.

Show in Editor

Shows the selected type or instance in an SDL Editor. If a type symbol is selected, an SDL Editor is opened with that type diagram. If an instance symbol is selected, an SDL Editor is opened with the diagram that contains the instance.

Show Type Viewer

Raises the Type Viewer's Main window.

Popup Menus

The following tables lists the menu choices in the Tree window popup menus and a reference to the corresponding menu choice in the menu bar.

On the Tree Window Background

--------------------------------------------------------
Search            "Search" on page 1294.                  
Search Again      "Search Again" on page 1295.            
Show All Trees    "Show All Trees" on page 1293.          
Show Type Viewer  "Show Type Viewer" on page 1295.        
Expand All        "Expand All" on page 1292.              
Collapse All      Collapse all top objects in all trees.  
--------------------------------------------------------

On a Symbol in the Tree Window

--------------------------------------------------------
Search               "Search" on page 1294.               
Search Again         "Search Again" on page 1295.         
Show in Editor       "Show in Editor" on page 1295.       
Show All Trees       "Show All Trees" on page 1293.       
Show Type Viewer     "Show Type Viewer" on page 1295.     
Expand               "Expand" on page 1292.               
Expand Substructure  "Expand Substructure" on page 1292.  
Collapse             "Collapse" on page 1292.             
--------------------------------------------------------

Keyboard Accelerators

Apart from the general keyboard accelerators, as described in "Accelerators and Mnemonics" on page 1048, the following accelerators can be used in the Main window:

-------------------------------------------
Accelerator  Command (page reference)        
-------------------------------------------
ctrl-E       Show in Editor (see page 1295)  
-------------------------------------------
 
Table of Contents Next Chapter