Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
VIEWRES(1)		     General Commands Manual		      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 vi-
     sually 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 hierar-
	     chy  to  display.	This is typically 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 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 bot-
	     tom rather left to right.

     -help   This option indicates that viewres should print a usage message and
	     exit.

     -version
	     This  option  indicates  that viewres should print version info and
	     exit.

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 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 se-
     lected 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 opera-
	     tion 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 performed with the Select(parent) trans-
	     lation.

     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 operation
	     may also be performed with the Select(resources) translation.

     Select Shown Resource Boxes
	     This entry selects all nodes whose resource boxes are currently ex-
	     panded (usually so that they  can	be  closed  with  Hide	Resource
	     Boxes).   This  operation	may  also  be  performed  with	the  Se-
	     lect(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 (unselects all nodes), invert, parent, ances-
	     tors, 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(7),  xrdb(1), listres(1), editres(1), appres(1), appropriate widget docu-
     ments

AUTHOR
     Jim Fulton, MIT X Consortium

X Version 11			  viewres 1.0.8 		      VIEWRES(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=viewres&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help