Table of Contents Previous Chapter 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.
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:
- A graphical symbol to identify the type of diagram. The symbols are identical to the icons used in the Organizer's Main window (see "Icon Types" on page 1061). The symbol is always shown.
- The type identifier, in the form
<virtuality> <diagram type> <object type>, where:
- <virtuality> may be either
Virtual, Redefined or Finalized
- <diagram type> may be either
System, Block, Service or Process
- <object type> may be either
Type or Instance
- The name of the type or instance
- The complete qualifier, in text form.
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.
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.
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).
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'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.
Figure 347 : The File Menu.
-----
(fig)
-----
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.
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.
Exits the Type Viewer.
Figure 348 : The View Menu.
-----
(fig)
-----
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)
-----
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)
-----
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)
-----
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.
- Pressing Set changes the scale and brings down the dialog.
- Pressing Cancel closes the dialog without changing the scale.
Figure 353 : The Tools Menu.
-----
(fig)
-----
Searches for a visible text in the type list shown in the Main window.
Figure 354 : The Search Dialog.
-----
(fig)
-----
- Search for
Specifies the text string to search for. As a special case, a GR Reference obtained from for instance an Editor may also be specified.
- Ignore Case, Consider Case
These options toggles between a case insensitive and a case sensitive search.
- Search
Starts the search and closes the dialog. The first symbol containing the text is selected. The search starts from the selected symbol, if any, or from the first symbol in the list.
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)
-----
- Pressing the Continue button continues the search from the top of the list.
- Pressing the Cancel button closes the dialog and terminates the search session.
If the text cannot be found among the visible information, the user is informed in a confirmation dialog.
Searches again for the same text as in the latest search. The behavior is the same as for Search above.
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.
Opens or raises the Tree window. The type or instance selected in the Main window becomes selected in the Tree window.
Raises the Organizer's Main window.
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.
------------------------------------------------
Search "Search" on page 1286.
Search Again "Search Again" on page 1287.
Show Type Trees "Show Type Trees" on page 1287.
------------------------------------------------
------------------------------------------------
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.
------------------------------------------------
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'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:
- A Redefinition tree shows virtual types, specializations based on redefinition of the virtual types, and all instances of these types.
- An Inheritance tree shows types, specializations based on inheritance and adding properties to the types, and all instances of these types.
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.
Figure 357 : The File Menu.
-----
(fig)
-----
Prints the contents of the Tree window. The Print utility is started; see the chapter chapter 29, The Print Utility for more information.
Closes the Tree window without confirmation.
Figure 358 : View Menu.
-----
(fig)
-----
Expands the selected object one level down.
Expands the selected object as much as possible.
Expands all visible trees as much as possible.
Collapses the selected object, i.e. hides all child objects.
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)
-----
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)
-----
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)
-----
Shows type trees for all types in the system.
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.
Figure 363 : the Tools Menu.
-----
(fig)
-----
Searches for a text in the type trees shown in the Tree window.
Figure 364 : The Search Dialog.
-----
(fig)
-----
- Search for
Specifies the text string to search for. As a special case, a GR Reference obtained from for instance an Editor may also be specified.
- Ignore Case, Consider Case
These options toggles between a case insensitive and a case sensitive search.
- Search
Starts the search and closes the dialog. The first symbol containing the text is selected. The search starts from the selected symbol, if any, or from the first symbol in the first tree.
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.
Searches again for the same text as in the latest search. The behavior is the same as for Search above.
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.
Raises the Type Viewer's Main window.
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.
--------------------------------------------------------
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.
--------------------------------------------------------
--------------------------------------------------------
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.
--------------------------------------------------------
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