viewres



VIEWRES(1)                                                          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 widget in the
               hierarchy to display.  This is typically used to limit the dis-
               play 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  displayed  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 displayed 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 performed with the SetLabelType(variable)
               translation.

       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 SetLabelType(class) translation.

       Layout Horizontal
               This entry causes the tree to be laid out from left  to  right.
               This  operation  may  also  be  performed  with the SetOrienta-
               tion(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 SetOrienta-
               tion(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  But-
       ton2  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 various 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) trans-
               lation.

       Select All
               This entry adds all nodes to the selection list.   This  opera-
               tion 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 performed  with  the  Select(parent)
               translation.

       Select Ancestors
               This  entry  recursively  selects  all  parents of all selected
               nodes.   This  operation  may  also  be  performed   with   the
               Select(ancestors) translation.

       Select Children
               This  entry  selects  the  immediate  children  of all selected
               nodes.   This  operation  may  also  be  performed   with   the
               Select(children) translation.

       Select Descendants
               This  entry  recursively  selects  all children of all selected
               nodes.   This  operation  may  also  be  performed   with   the
               Select(descendants) translation.

       Select Has Resources
               This entry selects all nodes that add new resources (regular or
               constraint) to their corresponding widget classes.  This opera-
               tion  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  operation  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  follow-
               ing 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 (unselects all nodes), invert,  par-
               ent, ancestors, children, 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(7x),  xrdb(1),  listres(1), editres(1), appres(1), appropriate widget
       documents


COPYRIGHT

       Copyright 1994 X Consortium
       See X(7x) for a full statement of rights and permissions.


AUTHOR

       Jim Fulton, MIT X Consortium



                                                                    VIEWRES(1)

Man(1) output converted with man2html