VIEWRES(1)
NAME
viewres - graphical class browser for Xt
SYNOPSIS
viewres [-option ...]
DESCRIPTION
The viewres program displays a tree showing the widget
class hierarchy of the Athena Widget Set. Each node in
the tree can be expanded to show the resources that the
corresponding class adds (i.e. does not inherit from its
parent) when a widget is created. This application allows
the user to visually examine the structure and inherited
resources for the Athena Widget Set.
OPTIONS
Viewres accepts all of the standard toolkit command line
options as well as the following:
-top name
This option specifies the name of the highest wid-
get in the hierarchy to display. This is typi-
cally used to limit the display to a subset of the
tree. The default is Object.
-variable
This option indicates that the widget variable
names (as declared in header files) should be dis-
played in the nodes rather than the widget class
name. This is sometimes useful to distinguish
widget classes that share the same name (such as
Text).
-vertical
This option indicates that the tree should be dis-
played top to bottom rather left to right.
VIEW MENU
The way in which the tree is displayed may be changed
through the entries in the View menu:
Show Variable Names
This entry causes the node labels to be set to the
variable names used to declare the corresponding
widget class. This operation may also be per-
formed with the SetLabelType(variable) transla-
tion.
Show Class Names
This entry causes the node labels to be set to the
class names used when specifying resources. This
operation may also be performed with the SetLabel-
Type(class) translation.
Layout Horizontal
This entry causes the tree to be laid out from
left to right. This operation may also be per-
formed with the SetOrientation(West) translation.
Layout Vertical
This entry causes the tree to be laid out from top
to bottom. This operation may also be performed
with the SetOrientation(North) translation.
Show Resource Boxes
This entry expands the selected nodes (see next
section) to show the new widget and constraint
resources. This operation may also be performed
with the Resources(on) translation.
Hide Resource Boxes
This entry removes the resource displays from the
selected nodes (usually to conserve space). This
operation may also be performed with the
Resources(off) translation.
SELECT MENU
Resources for a single widget class can be displayed by
clicking Button2 on the corresponding node, or by adding
the node to the selection list with Button1 and using the
Show Resource Boxes entry in the View menu. Since Button1
actually toggles the selection state of a node, clicking
on a selected node will cause it to be removed from the
selected list.
Collections of nodes may also be selected through the var-
ious entries in the Select menu:
Unselect All
This entry removes all nodes from the selection
list. This operation may also be performed with
the Select(nothing) translation.
Select All
This entry adds all nodes to the selection list.
This operation may also be performed with the
Select(all) translation.
Invert All
This entry adds unselected nodes to, and removes
selected nodes from, the selection list. This
operation may also be performed with the
Select(invert) translation.
Select Parent
This entry selects the immediate parents of all
selected nodes. This operation may also be per-
formed with the Select(parent) translation.
Select Ancestors
This entry recursively selects all parents of all
selected nodes. This operation may also be per-
formed with the Select(ancestors) translation.
Select Children
This entry selects the immediate children of all
selected nodes. This operation may also be per-
formed with the Select(children) translation.
Select Descendants
This entry recursively selects all children of all
selected nodes. This operation may also be per-
formed with the Select(descendants) translation.
Select Has Resources
This entry selects all nodes that add new
resources (regular or constraint) to their corre-
sponding widget classes. This operation may also
be performed with the Select(resources) transla-
tion.
Select Shown Resource Boxes
This entry selects all nodes whose resource boxes
are currently expanded (usually so that they can
be closed with Hide Resource Boxes). This opera-
tion may also be performed with the Select(shown)
translation.
ACTIONS
The following application actions are provided:
Quit()
This action causes viewres to exit.
SetLabelType(type)
This action sets the node labels to display the
widget variable or class names, according to the
argument type.
SetOrientation(direction)
This action sets the root of the tree to be one of
the following areas of the window: West, North,
East, or South.
Select(what)
This action selects the indicated nodes, as
described in the VIEW MENU section: nothing (unse-
lects all nodes), invert, parent, ancestors, chil-
dren, descendants, resources, shown.
Resources(op)
This action turns on, off, or toggles the resource
boxes for the selected nodes. If invoked from
within one of the nodes (through the keyboard or
pointer), only that node is used.
WIDGET HIERARCHY
Resources may be specified for the following widgets:
Viewres viewres
Paned pane
Box buttonbox
Command quit
MenuButton view
SimpleMenu viewMenu
SmeBSB layoutHorizontal
SmeBSB layoutVertical
SmeLine line1
SmeBSB namesVariable
SmeBSB namesClass
SmeLine line2
SmeBSB viewResources
SmeBSB viewNoResources
MenuButton select
SimpleMenu selectMenu
SmeBSB unselect
SmeBSB selectAll
SmeBSB selectInvert
SmeLine line1
SmeBSB selectParent
SmeBSB selectAncestors
SmeBSB selectChildren
SmeBSB selectDescendants
SmeLine line2
SmeBSB selectHasResources
SmeBSB selectShownResources
Form treeform
Porthole porthole
Tree tree
Box variable-name
Toggle variable-name
List variable-name
Panner panner
where variable-name is the widget variable name of each
node.
SEE ALSO
X(1) xrdb(1) listres(1) editres(1) appres(1) appro-
priate widget documents
COPYRIGHT
Copyright ([, X Consortium
See X(1) for a full statement of rights and permissions.
AUTHOR
Jim Fulton, MIT X Consortium