1VIEWRES(1)                  General Commands Manual                 VIEWRES(1)
2
3
4

NAME

6       viewres - graphical class browser for Xt
7

SYNOPSIS

9       viewres [-option ...]
10

DESCRIPTION

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

OPTIONS

20       Viewres accepts all of the standard toolkit  command  line  options  as
21       well as the following:
22
23       -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
28       -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
35       -vertical
36               This  option indicates that the tree should be displayed top to
37               bottom rather left to right.
38

VIEW MENU

40       The way in which the tree is  displayed  may  be  changed  through  the
41       entries in the View menu:
42
43       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
49       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
54       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
59       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
64       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
69       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

SELECT MENU

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
82       Collections  of  nodes may also be selected through the various entries
83       in the Select menu:
84
85       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
90       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
94       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
99       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
104       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
109       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
114       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
119       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
125       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

ACTIONS

132       The following application actions are provided:
133
134       Quit()
135               This action causes viewres to exit.
136
137       SetLabelType(type)
138               This action sets the node labels to display the widget variable
139               or class names, according to the argument type.
140
141       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
145       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
150       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

WIDGET HIERARCHY

156       Resources may be specified for the following widgets:
157
158       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
193       where variable-name is the widget variable name of each node.
194

SEE ALSO

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

AUTHOR

204       Jim Fulton, MIT X Consortium
205
206
207
208X Version 11                     viewres 1.0.5                      VIEWRES(1)
Impressum