1VIEWRES(1) General Commands Manual VIEWRES(1)
2
6 viewres - graphical class browser for Xt
7
9 viewres [-option ...]
10
12 The viewres program displays a tree showing the widget class hierarchy
13 of the Athena Widget Set. Each node in the tree can be expanded to
14 show the resources that the corresponding class adds (i.e. does not
15 inherit from its parent) when a widget is created. This application
16 allows the user to visually examine the structure and inherited
17 resources for the Athena Widget Set.
18
20 Viewres accepts all of the standard toolkit command line options as
21 well as the following:
22 -top name
24 This option specifies the name of the highest widget in the
25 hierarchy to display. This is typically used to limit the dis‐
26 play to a subset of the tree. The default is Object.
27 -variable
29 This option indicates that the widget variable names (as
30 declared in header files) should be displayed in the nodes
31 rather than the widget class name. This is sometimes useful to
32 distinguish widget classes that share the same name (such as
33 Text).
34 -vertical
36 This option indicates that the tree should be displayed top to
37 bottom rather left to right.
38
40 The way in which the tree is displayed may be changed through the
41 entries in the View menu:
42 Show Variable Names
44 This entry causes the node labels to be set to the variable
45 names used to declare the corresponding widget class. This
46 operation may also be performed with the SetLabelType(variable)
47 translation.
48 Show Class Names
50 This entry causes the node labels to be set to the class names
51 used when specifying resources. This operation may also be
52 performed with the SetLabelType(class) translation.
53 Layout Horizontal
55 This entry causes the tree to be laid out from left to right.
56 This operation may also be performed with the SetOrienta‐
57 tion(West) translation.
58 Layout Vertical
60 This entry causes the tree to be laid out from top to bottom.
61 This operation may also be performed with the SetOrienta‐
62 tion(North) translation.
63 Show Resource Boxes
65 This entry expands the selected nodes (see next section) to
66 show the new widget and constraint resources. This operation
67 may also be performed with the Resources(on) translation.
68 Hide Resource Boxes
70 This entry removes the resource displays from the selected
71 nodes (usually to conserve space). This operation may also be
72 performed with the Resources(off) translation.
73
75 Resources for a single widget class can be displayed by clicking But‐
76 ton2 on the corresponding node, or by adding the node to the selection
77 list with Button1 and using the Show Resource Boxes entry in the View
78 menu. Since Button1 actually toggles the selection state of a node,
79 clicking on a selected node will cause it to be removed from the
80 selected list.
81 Collections of nodes may also be selected through the various entries
83 in the Select menu:
84 Unselect All
86 This entry removes all nodes from the selection list. This
87 operation may also be performed with the Select(nothing) trans‐
88 lation.
89 Select All
91 This entry adds all nodes to the selection list. This opera‐
92 tion may also be performed with the Select(all) translation.
93 Invert All
95 This entry adds unselected nodes to, and removes selected nodes
96 from, the selection list. This operation may also be performed
97 with the Select(invert) translation.
98 Select Parent
100 This entry selects the immediate parents of all selected nodes.
101 This operation may also be performed with the Select(parent)
102 translation.
103 Select Ancestors
105 This entry recursively selects all parents of all selected
106 nodes. This operation may also be performed with the
107 Select(ancestors) translation.
108 Select Children
110 This entry selects the immediate children of all selected
111 nodes. This operation may also be performed with the
112 Select(children) translation.
113 Select Descendants
115 This entry recursively selects all children of all selected
116 nodes. This operation may also be performed with the
117 Select(descendants) translation.
118 Select Has Resources
120 This entry selects all nodes that add new resources (regular or
121 constraint) to their corresponding widget classes. This opera‐
122 tion may also be performed with the Select(resources) transla‐
123 tion.
124 Select Shown Resource Boxes
126 This entry selects all nodes whose resource boxes are currently
127 expanded (usually so that they can be closed with Hide Resource
128 Boxes). This operation may also be performed with the
129 Select(shown) translation.
130
132 The following application actions are provided:
133 Quit()
135 This action causes viewres to exit.
136 SetLabelType(type)
138 This action sets the node labels to display the widget variable
139 or class names, according to the argument type.
140 SetOrientation(direction)
142 This action sets the root of the tree to be one of the follow‐
143 ing areas of the window: West, North, East, or South.
144 Select(what)
146 This action selects the indicated nodes, as described in the
147 VIEW MENU section: nothing (unselects all nodes), invert, par‐
148 ent, ancestors, children, descendants, resources, shown.
149 Resources(op)
151 This action turns on, off, or toggles the resource boxes for
152 the selected nodes. If invoked from within one of the nodes
153 (through the keyboard or pointer), only that node is used.
154
156 Resources may be specified for the following widgets:
157 Viewres viewres
159 Paned pane
160 Box buttonbox
161 Command quit
162 MenuButton view
163 SimpleMenu viewMenu
164 SmeBSB layoutHorizontal
165 SmeBSB layoutVertical
166 SmeLine line1
167 SmeBSB namesVariable
168 SmeBSB namesClass
169 SmeLine line2
170 SmeBSB viewResources
171 SmeBSB viewNoResources
172 MenuButton select
173 SimpleMenu selectMenu
174 SmeBSB unselect
175 SmeBSB selectAll
176 SmeBSB selectInvert
177 SmeLine line1
178 SmeBSB selectParent
179 SmeBSB selectAncestors
180 SmeBSB selectChildren
181 SmeBSB selectDescendants
182 SmeLine line2
183 SmeBSB selectHasResources
184 SmeBSB selectShownResources
185 Form treeform
186 Porthole porthole
187 Tree tree
188 Box variable-name
189 Toggle variable-name
190 List variable-name
191 Panner panner
192 where variable-name is the widget variable name of each node.
194
196 X(7), xrdb(1), listres(1), editres(1), appres(1), appropriate widget
197 documents
198
200 Copyright 1994 X Consortium
201 See X(7) for a full statement of rights and permissions.
202
204 Jim Fulton, MIT X Consortium
205X Version 11 viewres 1.0.1 VIEWRES(1)