VIEWRES(1) AIX VIEWRES(1) NAME viewres - graphical class browser for Xt SYNOPSIS vvvviiiieeeewwwwrrrreeeessss [-option ...] DESCRIPTION The _v_i_e_w_r_e_s 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 _V_i_e_w_r_e_s accepts all of the standard toolkit command line options as well as the following: ----ttttoooopppp _n_a_m_e This option specifies the name of the highest widget in the hierarchy to display. This is typically used to limit the display to a subset of the tree. The default is _O_b_j_e_c_t. ----vvvvaaaarrrriiiiaaaabbbblllleeee 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 _T_e_x_t). ----vvvveeeerrrrttttiiiiccccaaaallll 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 VVVViiiieeeewwww menu: SSSShhhhoooowwww VVVVaaaarrrriiiiaaaabbbblllleeee NNNNaaaammmmeeeessss 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 SSSSeeeettttLLLLaaaabbbbeeeellllTTTTyyyyppppeeee((((vvvvaaaarrrriiiiaaaabbbblllleeee)))) translation. SSSShhhhoooowwww CCCCllllaaaassssssss NNNNaaaammmmeeeessss 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 SSSSeeeettttLLLLaaaabbbbeeeellllTTTTyyyyppppeeee((((ccccllllaaaassssssss)))) translation. LLLLaaaayyyyoooouuuutttt HHHHoooorrrriiiizzzzoooonnnnttttaaaallll Rev. Release 5 Page 1 VIEWRES(1) AIX VIEWRES(1) This entry causes the tree to be laid out from left to right. This operation may also be performed with the _S_e_t_O_r_i_e_n_t_a_t_i_o_n(_W_e_s_t) translation. LLLLaaaayyyyoooouuuutttt VVVVeeeerrrrttttiiiiccccaaaallll This entry causes the tree to be laid out from top to bottom. This operation may also be performed with the _S_e_t_O_r_i_e_n_t_a_t_i_o_n(_N_o_r_t_h) translation. SSSShhhhoooowwww RRRReeeessssoooouuuurrrrcccceeee BBBBooooxxxxeeeessss This entry expands the selected nodes (see next sec- tion) to show the new widget and constraint resources. This operation may also be performed with the _R_e_s_o_u_r_c_e_s(_o_n) translation. HHHHiiiiddddeeee RRRReeeessssoooouuuurrrrcccceeee BBBBooooxxxxeeeessss This entry removes the resource displays from the selected nodes (usually to conserve space). This operation may also be performed with the _R_e_s_o_u_r_c_e_s(_o_f_f) translation. SELECT MENU Resources for a single widget class can be displayed by clicking BBBBuuuuttttttttoooonnnn2222 on the corresponding node, or by adding the node to the selection list with BBBBuuuuttttttttoooonnnn1111 and using the SSSShhhhoooowwww RRRReeeessssoooouuuurrrrcccceeee BBBBooooxxxxeeeessss entry in the VVVViiiieeeewwww menu. Since BBBBuuuuttttttttoooonnnn1111 actu- ally 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 vari- ous entries in the SSSSeeeelllleeeecccctttt menu: UUUUnnnnsssseeeelllleeeecccctttt AAAAllllllll This entry removes all nodes from the selection list. This operation may also be performed with the _S_e_l_e_c_t(_n_o_t_h_i_n_g) translation. SSSSeeeelllleeeecccctttt AAAAllllllll This entry adds all nodes to the selection list. This operation may also be performed with the _S_e_l_e_c_t(_a_l_l) translation. IIIInnnnvvvveeeerrrrtttt AAAAllllllll This entry adds unselected nodes to, and removes selected nodes from, the selection list. This operation may also be performed with the _S_e_l_e_c_t(_i_n_v_e_r_t) translation. SSSSeeeelllleeeecccctttt PPPPaaaarrrreeeennnntttt This entry selects the immediate parents of all selected nodes. This operation may also be per- formed with the _S_e_l_e_c_t(_p_a_r_e_n_t) translation. Rev. Release 5 Page 2 VIEWRES(1) AIX VIEWRES(1) SSSSeeeelllleeeecccctttt AAAAnnnncccceeeessssttttoooorrrrssss This entry recursively selects all parents of all selected nodes. This operation may also be per- formed with the _S_e_l_e_c_t(_a_n_c_e_s_t_o_r_s) translation. SSSSeeeelllleeeecccctttt CCCChhhhiiiillllddddrrrreeeennnn This entry selects the immediate children of all selected nodes. This operation may also be per- formed with the _S_e_l_e_c_t(_c_h_i_l_d_r_e_n) translation. SSSSeeeelllleeeecccctttt DDDDeeeesssscccceeeennnnddddaaaannnnttttssss This entry recursively selects all children of all selected nodes. This operation may also be per- formed with the _S_e_l_e_c_t(_d_e_s_c_e_n_d_a_n_t_s) translation. SSSSeeeelllleeeecccctttt HHHHaaaassss RRRReeeessssoooouuuurrrrcccceeeessss This entry selects all nodes that add new resources (regular or constraint) to their corresponding widget classes. This operation may also be per- formed with the _S_e_l_e_c_t(_r_e_s_o_u_r_c_e_s) translation. SSSSeeeelllleeeecccctttt SSSShhhhoooowwwwnnnn RRRReeeessssoooouuuurrrrcccceeee BBBBooooxxxxeeeessss This entry selects all nodes whose resource boxes are currently expanded (usually so that they can be closed with HHHHiiiiddddeeee RRRReeeessssoooouuuurrrrcccceeee BBBBooooxxxxeeeessss). This operation may also be performed with the _S_e_l_e_c_t(_s_h_o_w_n) trans- lation. ACTIONS The following application actions are provided: QQQQuuuuiiiitttt(((()))) This action causes _v_i_e_w_r_e_s to exit. SSSSeeeettttLLLLaaaabbbbeeeellllTTTTyyyyppppeeee((((_t_y_p_e)))) This action sets the node labels to display the widget _v_a_r_i_a_b_l_e or _c_l_a_s_s names, according to the argument _t_y_p_e. SSSSeeeettttOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn((((_d_i_r_e_c_t_i_o_n)))) This action sets the root of the tree to be one of the following areas of the window: _W_e_s_t, _N_o_r_t_h, _E_a_s_t, or _S_o_u_t_h. SSSSeeeelllleeeecccctttt((((_w_h_a_t)))) This action selects the indicated nodes, as described in the VVVVIIIIEEEEWWWW MMMMEEEENNNNUUUU section: _n_o_t_h_i_n_g (unselects all nodes), _i_n_v_e_r_t, _p_a_r_e_n_t, _a_n_c_e_s_t_o_r_s, _c_h_i_l_d_r_e_n, _d_e_s_c_e_n_d_a_n_t_s, _r_e_s_o_u_r_c_e_s, _s_h_o_w_n. RRRReeeessssoooouuuurrrrcccceeeessss((((_o_p)))) This action turns _o_n, _o_f_f, or _t_o_g_g_l_e_s the resource boxes for the selected nodes. If invoked from Rev. Release 5 Page 3 VIEWRES(1) AIX VIEWRES(1) 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 _v_a_r_i_a_b_l_e-_n_a_m_e Toggle _v_a_r_i_a_b_l_e-_n_a_m_e List _v_a_r_i_a_b_l_e-_n_a_m_e Panner panner where _v_a_r_i_a_b_l_e-_n_a_m_e is the widget variable name of each node. SEE ALSO X(1), xrdb(1), listres(1), editres(1), appres(1), appropri- ate widget documents COPYRIGHT Copyright 1990, Massachusetts Institute of Technology. See _X(_1) for a full statement of rights and permissions. AUTHOR Rev. Release 5 Page 4 VIEWRES(1) AIX VIEWRES(1) Jim Fulton, MIT X Consortium Rev. Release 5 Page 5