diff options
| -rw-r--r-- | Viewres.ad | 95 | ||||
| -rw-r--r-- | viewres.c | 1227 | ||||
| -rw-r--r-- | viewres.man | 216 |
3 files changed, 1538 insertions, 0 deletions
diff --git a/Viewres.ad b/Viewres.ad new file mode 100644 index 0000000..7272283 --- /dev/null +++ b/Viewres.ad @@ -0,0 +1,95 @@ +*Panner*backgroundStipple: grid2 + +*allowShellResize: true +*buttonbox*ShapeStyle: oval +*Form*Panner.Thickness: -1 +*Form.defaultDistance: 0 +*Form.BorderWidth: 0 +*Porthole.BorderWidth: 0 +*Porthole.top: ChainTop +*Porthole.left: ChainLeft +*Porthole.bottom: ChainBottom +*Porthole.right: ChainRight +*Porthole.resizable: on +*Panner.top: ChainTop +*Panner.left: ChainLeft +*Panner.bottom: ChainTop +*Panner.right: ChainLeft +*Panner.resizable: on +*Tree*ShapeStyle: rectangle +*Tree*Toggle*BorderWidth: 0 +*Porthole*Box.BorderWidth: 0 +*Porthole*Box.HSpace: 0 +*Porthole*Box.VSpace: 0 +*Paned*allowResize: true + +*Tree*List*Font: -adobe-helvetica-medium-r-normal--*-80-*-*-*-*-iso*-* + +*SimpleMenu*BackingStore: NotUseful +*Font: -adobe-helvetica-bold-r-normal--*-120-*-*-*-*-iso*-* +*buttonbox.MenuButton.leftBitmap: menu12 +*SimpleMenu*menuLabel.vertSpace: 100 +*SimpleMenu*SmeLine*Height: 12 + +*quit.Label: Quit + +*buttonbox.quit.baseTranslations: #override \ + <Btn1Down>,<Btn1Up>: Quit() unset() + +*Toggle.baseTranslations: #augment \n\ +<Btn2Down>,<Btn2Up>: set() notify() Resources(toggle) \n\ +<Key>q: Quit() \n\ +<Key>space: Select(nothing) \n\ +<Key>p: Select(parent) \n\ +<Key>a: Select(ancestors) \n\ +<Key>c: Select(children) \n\ +<Key>d: Select(descendants) \n\ +Ctrl<Key>r: Resources(on) \n\ +Ctrl<Key>n: Resources(off) \n\ + +*List.baseTranslations: #augment \n\ +<Key>q: Quit() \n\ +<Key>space: Select(nothing) \n\ +<Key>p: Select(parent) \n\ +<Key>a: Select(ancestors) \n\ +<Key>c: Select(children) \n\ +<Key>d: Select(descendants) \n\ +Ctrl<Key>r: Resources(on) \n\ +Ctrl<Key>n: Resources(off) \n\ + +*Porthole.baseTranslations: #override \n\ +<Btn1Down>,<Btn1Up>: Select(nothing) \n\ +<Key>q: Quit() \n\ +Ctrl<Key>h: SetOrientation(west) \n\ +Ctrl<Key>v: SetOrientation(north) \n\ +Ctrl<Key>r: Resources(on) \n\ +Ctrl<Key>n: Resources(off) \n\ +Shift<Key>c: SetLabelType(class) \n\ +Shift<Key>v: SetLabelType(variable) \n\ +<Key>space: Select(nothing) \n\ +<Key>i: Select(invert) \n\ +<Key>p: Select(parent) \n\ +<Key>a: Select(ancestors) \n\ +<Key>c: Select(children) \n\ +<Key>d: Select(descendants) \n\ +<Key>r: Select(resources) \n\ +<Key>s: Select(shown) \n\ + +*buttonbox.view.Label: View +*buttonbox.view.viewMenu.layoutHorizontal.Label: Layout Horizontal +*buttonbox.view.viewMenu.layoutVertical.Label: Layout Vertical +*buttonbox.view.viewMenu.namesVariable.Label: Show Variable Names +*buttonbox.view.viewMenu.namesClass.Label: Show Class Names +*buttonbox.view.viewMenu.viewResources.Label: Show Resource Boxes +*buttonbox.view.viewMenu.viewNoResources.Label: Hide Resource Boxes + +*buttonbox.select.Label: Select +*buttonbox.select.selectMenu.unselect.Label: Unselect All +*buttonbox.select.selectMenu.selectAll.Label: Select All +*buttonbox.select.selectMenu.selectInvert.Label: Invert All +*buttonbox.select.selectMenu.selectParent.Label: Select Parent +*buttonbox.select.selectMenu.selectAncestors.Label: Select Ancestors +*buttonbox.select.selectMenu.selectChildren.Label: Select Children +*buttonbox.select.selectMenu.selectDescendants.Label: Select Descendants +*buttonbox.select.selectMenu.selectHasResources.Label: Select Has Resources +*buttonbox.select.selectMenu.selectShownResources.Label: Select Shown Resource Boxes diff --git a/viewres.c b/viewres.c new file mode 100644 index 0000000..0a60836 --- /dev/null +++ b/viewres.c @@ -0,0 +1,1227 @@ +/* + * $XConsortium: viewres.c,v 1.74 94/04/17 20:43:24 converse Exp $ + * + * +Copyright (c) 1989 X Consortium + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN +AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN +CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +Except as contained in this notice, the name of the X Consortium shall not be +used in advertising or otherwise to promote the sale, use or other dealings +in this Software without prior written authorization from the X Consortium. + * * + * Author: Jim Fulton, MIT X Consortium + */ +/* $XFree86: xc/programs/viewres/viewres.c,v 1.5 2000/09/26 15:57:23 tsi Exp $ */ + +#include <stdio.h> +#include <stdlib.h> +#include <X11/StringDefs.h> +#include <X11/IntrinsicP.h> +#include <X11/Xaw/Cardinals.h> +#include <X11/Xaw/Box.h> +#include <X11/Xaw/Form.h> +#include <X11/Xaw/Command.h> +#include <X11/Xaw/MenuButton.h> +#include <X11/Xaw/SimpleMenu.h> +#include <X11/Xaw/Sme.h> +#include <X11/Xaw/SmeBSB.h> +#include <X11/Xaw/SmeLine.h> +#include <X11/Xaw/Paned.h> +#include <X11/Xaw/Porthole.h> +#include <X11/Xaw/Toggle.h> +#include <X11/Xaw/Text.h> +#include <X11/Xaw/List.h> +#include <X11/Xaw/Scrollbar.h> +#include <X11/Xaw/Panner.h> +#include <X11/Xaw/Tree.h> +#include <X11/Xmu/Converters.h> +#include <X11/Xmu/CharSet.h> +#include <X11/Xmu/WidgetNode.h> +#include <X11/Xaw/AllWidgets.h> + +#define widget_list XawWidgetArray /* or motif or ol or ... */ +#define nwidgets XawWidgetCount + +typedef struct { + const char **resource_labels; /* names of res added by widget */ + Cardinal nnewresources; /* number res added by widget */ + Cardinal nnewconstraints; /* number res added by widget */ + Cardinal nnew; /* number new */ + Widget instance; /* Label widget in box in tree */ + Widget resource_lw; /* List widget showing resources */ + int selection_index; /* -1 or index into selection_list */ +} ViewresData; + +#define VData(node) ((ViewresData *) (node)->data) + + +#define IsShowing(node) (VData(node)->resource_lw && \ + XtIsManaged(VData(node)->resource_lw)) + + +struct { + int n_elements; + int max_elements; + XmuWidgetNode **elements; +} selected_list = { 0, 0, (XmuWidgetNode **) NULL }; + +#define INSERT_NODE(node,i) \ + selected_list.elements[VData(node)->selection_index = (i)] = (node) + +#define REMOVE_NODE(node) \ + selected_list.elements[VData(node)->selection_index] = \ + (XmuWidgetNode *) NULL; VData(node)->selection_index = (-1) + +const char *ProgramName; +static int NumberShowing = 0; + +static Arg sensitiveargs[2] = {{ XtNsensitive, (XtArgVal) FALSE }, + { XtNsensitive, (XtArgVal) TRUE }}; + +static const char *help_message[] = { + "-top name object to be top of tree", + "-variable show variable name instead of class name", + "-vertical list the tree vertically", + NULL +}; + +static XrmOptionDescRec Options[] = { + { "-top", "*topObject", XrmoptionSepArg, (XPointer) NULL }, + { "-variable", "*showVariable", XrmoptionNoArg, (XPointer) "on" }, + { "-vertical", "*Tree.Gravity", XrmoptionNoArg, (XPointer) "north" } +}; + + +typedef struct { + char *top_object; + Boolean show_variable; +} OptionsRec; + +static OptionsRec options; + +#define Offset(field) XtOffsetOf(OptionsRec, field) + +static XtResource Resources[] = { + { "topObject", "TopObject", XtRString, sizeof(char *), + Offset(top_object), XtRString, (XtPointer) "object" }, + { "showVariable", "ShowVariable", XtRBoolean, sizeof(Boolean), + Offset(show_variable), XtRImmediate, (XtPointer) FALSE }, +}; + +#undef Offset + +static const char *fallback_resources[] = { + "*allowShellResize: true", + "*Porthole.top: ChainTop", + "*Porthole.left: ChainLeft", + "*Porthole.bottom: ChainBottom", + "*Porthole.right: ChainRight", + "*Porthole.resizable: on", + "*Panner.top: ChainTop", + "*Panner.left: ChainLeft", + "*Panner.bottom: ChainTop", + "*Panner.right: ChainLeft", + "*Panner.resizable: on", + "*Tree*ShapeStyle: rectangle", + "*Tree*Toggle*BorderWidth: 0", + "*Porthole*Box.BorderWidth: 0", + "*Porthole*Box.HSpace: 0", + "*Porthole*Box.VSpace: 0", + "*Paned*allowResize: true", + "*buttonbox.quit.Translations: #override \\n <Btn1Down>,<Btn1Up>: Quit() unset()", + "*Toggle.Translations: #augment \\n <Btn2Down>,<Btn2Up>: set() notify() Resources(toggle)", + NULL +}; + +static void ActionQuit(Widget, XEvent *, String *, Cardinal *); +static void ActionSetLableType(Widget, XEvent *, String *, Cardinal *); +static void ActionSetOrientation(Widget, XEvent *, String *, Cardinal *); +static void ActionSelect(Widget, XEvent *, String *, Cardinal *); +static void ActionResources(Widget, XEvent *, String *, Cardinal *); +static void set_labeltype_menu(Boolean, Boolean); +static void set_orientation_menu(XtGravity, Boolean); +static void build_tree(XmuWidgetNode *, Widget, Widget); +static void set_node_labels(XmuWidgetNode *, int); + +static XtActionsRec viewres_actions[] = { + { "Quit", ActionQuit }, + { "SetLabelType", ActionSetLableType }, + { "SetOrientation", ActionSetOrientation }, + { "Select", ActionSelect }, + { "Resources", ActionResources }, +}; + +static Atom wm_delete_window; + +#define BOOL_OFF 0 +#define BOOL_ON 1 +#define BOOL_TOGGLE 2 + +#define VIEW_HORIZONTAL 0 +#define VIEW_VERTICAL 1 +#define VIEW_VARIABLES 2 +#define VIEW_CLASSES 3 +#define VIEW_SHOW_RESOURCES 4 +#define VIEW_HIDE_RESOURCES 5 +#define VIEW_number 6 + +#define SELECT_NOTHING 0 +#define SELECT_ALL 1 +#define SELECT_INVERT 2 +#define SELECT_PARENT 3 +#define SELECT_ANCESTORS 4 +#define SELECT_CHILDREN 5 +#define SELECT_DESCENDANTS 6 +#define SELECT_HAS_RESOURCES 7 +#define SELECT_SHOWN_RESOURCES 8 +#define SELECT_number 9 + +static struct _nametable { + const char *name; + int value; +} select_nametable[] = { + { "nothing", SELECT_NOTHING }, + { "all", SELECT_ALL }, + { "invert", SELECT_INVERT }, + { "parent", SELECT_PARENT }, + { "ancestors", SELECT_ANCESTORS }, + { "children", SELECT_CHILDREN }, + { "descendants", SELECT_DESCENDANTS }, + { "resources", SELECT_HAS_RESOURCES }, + { "shown", SELECT_SHOWN_RESOURCES }, +}, boolean_nametable[] = { + { "off", BOOL_OFF }, + { "false", BOOL_OFF }, + { "no", BOOL_OFF }, + { "on", BOOL_ON }, + { "true", BOOL_ON }, + { "yes", BOOL_ON }, + { "toggle", BOOL_TOGGLE }, +}; + +static Widget treeWidget; +static Widget quitButton, viewButton, viewMenu, selectButton, selectMenu; +static Widget view_widgets[VIEW_number]; +static Widget select_widgets[SELECT_number]; +static XmuWidgetNode *topnode; + +static Arg false_args[1] = {{ XtNstate, (XtArgVal) FALSE }}; +static Arg true_args[1] = {{ XtNstate, (XtArgVal) TRUE }}; + + +/* + * routines + */ +static void usage () +{ + const char **cpp; + fprintf (stderr, "usage: %s [-options...]\n", ProgramName); + fprintf(stderr, "\nwhere options include:\n"); + for (cpp = help_message; *cpp; cpp++) { + fprintf (stderr, " %s\n", *cpp); + } + fprintf(stderr, "\n"); + exit (1); +} + + +static XmuWidgetNode *widget_to_node (gw) + register Widget gw; +{ + register XmuWidgetNode *node; + register int i; + + if (XtIsSubclass (gw, toggleWidgetClass)) { + for (i = 0, node = widget_list; i < nwidgets; i++, node++) { + if (VData(node)->instance == gw) return node; + } + } else if (XtIsSubclass (gw, listWidgetClass)) { + for (i = 0, node = widget_list; i < nwidgets; i++, node++) { + if (VData(node)->resource_lw == gw) return node; + } + } + return (XmuWidgetNode *) NULL; +} + + +static void initialize_widgetnode_list (listp, sizep, n) + XmuWidgetNode ***listp; + int *sizep; + int n; +{ + register int i; + register XmuWidgetNode **l; + + if (!*listp) { + *listp = (XmuWidgetNode **) + XtCalloc ((unsigned int) n, (unsigned int)sizeof(XmuWidgetNode **)); + *sizep = ((*listp) ? n : 0); + return; + } + if (n > *sizep) { + *listp = (XmuWidgetNode **) XtRealloc ((char *) *listp, + (unsigned int) + (n * sizeof(XmuWidgetNode **))); + if (!*listp) { + *sizep = 0; + return; + } + for (i = *sizep, l = (*listp) + i; i < n; i++, l++) *l = + (XmuWidgetNode *) NULL; + *sizep = n; + } + return; +} + + +static Boolean set_resource_labels (node) + XmuWidgetNode *node; +{ + int i; + const char **cur; + XtResourceList res; + XmuWidgetNode **wn; + ViewresData *d = VData(node); + + if (!d->resource_labels) { + d->resource_labels = + (const char **) calloc ((unsigned) d->nnew * 3, + (unsigned) sizeof (const char *)); + if (!d->resource_labels) return FALSE; + } + + cur = d->resource_labels; + res = node->resources; + wn = node->resourcewn; + for (i = 0; i < node->nresources; i++, res++, wn++) { + if (*wn == node) { /* should match nnew */ + *cur++ = res->resource_name; + *cur++ = res->resource_class; + *cur++ = res->resource_type; + } + } + if (d->nnewconstraints > 0) { + const char *s; + + *cur++ = s = ""; + *cur++ = s; + *cur++ = s; + } + res = node->constraints; + wn = node->constraintwn; + for (i = 0; i < node->nconstraints; i++, res++, wn++) { + if (*wn == node) { /* should match nnew */ + *cur++ = res->resource_name; + *cur++ = res->resource_class; + *cur++ = res->resource_type; + } + } + return TRUE; +} + + +static ViewresData *create_viewres_data (node) + XmuWidgetNode *node; +{ + register ViewresData *d = + (ViewresData *) malloc ((unsigned) sizeof(ViewresData)); + + if (d) { + d->resource_labels = NULL; + d->nnewresources = XmuWnCountOwnedResources (node, node, False); + d->nnewconstraints = XmuWnCountOwnedResources (node, node, True); + d->nnew = (d->nnewresources + (d->nnewconstraints + ? d->nnewconstraints + 1 : 0)); + d->instance = (Widget) NULL; + d->resource_lw = (Widget) NULL; + d->selection_index = -1; + } + return d; +} + +static int copydown (start) + register int start; +{ + register XmuWidgetNode **src = &selected_list.elements[start]; + register XmuWidgetNode **dst = src; + register int cur; + + for (cur = start; start < selected_list.n_elements; start++, src++) { + if (*src) { + VData((*src))->selection_index = cur++; + *dst++ = *src; + } + } + return (start - cur); +} + + +static void add_to_selected_list (node, updatewidget) + XmuWidgetNode *node; + Boolean updatewidget; +{ + ViewresData *d = VData(node); + if (!d->instance || d->selection_index >= 0) return; + + if (selected_list.n_elements >= selected_list.max_elements) { + initialize_widgetnode_list (&selected_list.elements, + &selected_list.max_elements, + (selected_list.max_elements * 3) / 2); + } + INSERT_NODE (node, selected_list.n_elements); + selected_list.n_elements++; + + if (updatewidget) XtSetValues (d->instance, true_args, ONE); +} + +static Boolean remove_from_selected_list (node, updatewidget) + XmuWidgetNode *node; + Boolean updatewidget; +{ + int i, skips; + ViewresData *d = VData(node); + + if ((i = d->selection_index) < 0) return FALSE; + + REMOVE_NODE (node); + + /* copy down */ + if (selected_list.n_elements > 1) { + skips = copydown (i); + } else { + skips = 1; + } + selected_list.n_elements -= skips; + + if (updatewidget) XtSetValues (d->instance, false_args, ONE); + return TRUE; +} + +static void remove_nodes_from_selected_list (start, count, updatewidget) + int start, count; + Boolean updatewidget; +{ + int i; + + for (i = 0; i < count; i++) { + register XmuWidgetNode *p = selected_list.elements[start+i]; + ViewresData *d = VData(p); + REMOVE_NODE (p); + if (updatewidget) XtSetValues (d->instance, false_args, ONE); + } + selected_list.n_elements -= copydown (start); +} + +static void add_subtree_to_selected_list (node, updatewidget) + XmuWidgetNode *node; + Boolean updatewidget; +{ + if (!node) return; + + add_to_selected_list (node, updatewidget); + for (node = node->children; node; node = node->siblings) { + add_subtree_to_selected_list (node, updatewidget); + } +} + + +/* ARGSUSED */ +static void variable_labeltype_callback (gw, closure, data) + Widget gw; + XtPointer closure; /* TRUE or FALSE */ + XtPointer data; +{ + set_labeltype_menu ((Boolean) (long) closure, True); +} + +/* ARGSUSED */ +static void gravity_callback (gw, closure, data) + Widget gw; + XtPointer closure; /* TRUE or FALSE */ + XtPointer data; +{ + set_orientation_menu ((XtGravity) (long) closure, True); +} + + +static Boolean create_resource_lw (node) + XmuWidgetNode *node; +{ + Arg args[4]; + Cardinal n; + ViewresData *d = VData(node); + + if (d->nnew == 0) return FALSE; + + if (!d->resource_labels && + !set_resource_labels (node)) return FALSE; + + n = 0; + XtSetArg (args[n], XtNnumberStrings, 3 * d->nnew); n++; + XtSetArg (args[n], XtNlist, d->resource_labels); n++; + XtSetArg (args[n], XtNdefaultColumns, 3); n++; + XtSetArg (args[n], XtNforceColumns, TRUE); n++; + d->resource_lw = XtCreateManagedWidget (node->label, listWidgetClass, + XtParent(d->instance), + args, n); + XtRealizeWidget (d->resource_lw); + return TRUE; +} + +static void update_selection_items () +{ + register int i; + static Arg args[1] = {{ XtNsensitive, (XtArgVal) FALSE }}; + Boolean show = FALSE, hide = FALSE, ancestors = FALSE; + Boolean descendants = FALSE; + + for (i = 0; i < selected_list.n_elements; i++) { + XmuWidgetNode *node = selected_list.elements[i]; + ViewresData *d = VData(node); + + /* + * If node has any new resources then may be shown (if not + * already being shown). If node has widget and is managed, + * then may be hidden. + */ + if (d->nnew > 0) { + if (IsShowing(node)) { + hide = TRUE; + } else { + show = TRUE; + } + } + if (node != topnode) ancestors = TRUE; + if (node->children) descendants = TRUE; + } + + args[0].value = (XtArgVal) show; + XtSetValues (view_widgets[VIEW_SHOW_RESOURCES], args, ONE); + args[0].value = (XtArgVal) hide; + XtSetValues (view_widgets[VIEW_HIDE_RESOURCES], args, ONE); + args[0].value = (XtArgVal) (selected_list.n_elements > 0 ? TRUE : FALSE); + XtSetValues (select_widgets[SELECT_NOTHING], args, ONE); + args[0].value = (XtArgVal) ancestors; + XtSetValues (select_widgets[SELECT_PARENT], args, ONE); + XtSetValues (select_widgets[SELECT_ANCESTORS], args, ONE); + args[0].value = (XtArgVal) descendants; + XtSetValues (select_widgets[SELECT_CHILDREN], args, ONE); + XtSetValues (select_widgets[SELECT_DESCENDANTS], args, ONE); + args[0].value = (XtArgVal) ((Boolean) (NumberShowing > 0)); + XtSetValues (select_widgets[SELECT_SHOWN_RESOURCES], args, ONE); +} + + +static void do_resources (node, op, updatewidget) + XmuWidgetNode *node; + Boolean op; + Boolean updatewidget; +{ + ViewresData *d = VData(node); + if (op == BOOL_TOGGLE) op = (IsShowing(node) ? BOOL_OFF : BOOL_ON); + + if (op == BOOL_ON) { + if (d->resource_lw) { /* if already created */ + if (!XtIsManaged(d->resource_lw)) { + NumberShowing++; + XtManageChild (d->resource_lw); + } /* else ignore it */ + } else if (create_resource_lw (node)) /* create it */ + NumberShowing++; + } else if (d->resource_lw) { /* if already created */ + if (XtIsManaged (d->resource_lw)) { + NumberShowing--; + XtUnmanageChild (d->resource_lw); + XawListUnhighlight (d->resource_lw); + if (updatewidget) remove_from_selected_list (node, TRUE); + } /* else ignore it */ + } +} + + + +/* ARGSUSED */ +static void show_resources_callback (gw, closure, data) + Widget gw; /* menu or toggle button */ + XtPointer closure; /* BOOL_OFF, BOOL_ON, BOOL_TOGGLE */ + XtPointer data; /* undefined */ +{ + int op = (long) closure; + XmuWidgetNode *node = widget_to_node (gw); + + if (node) { + XUnmapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + do_resources (node, op, TRUE); + } else if (selected_list.n_elements <= 0) { + return; + } else { + int i; + + XUnmapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + for (i = 0; i < selected_list.n_elements; i++) { + do_resources (selected_list.elements[i], op, FALSE); + } + } + XawTreeForceLayout (treeWidget); + XMapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + update_selection_items (); +} + + +/* ARGSUSED */ +static void select_callback (gw, closure, data) + Widget gw; /* entry widget */ + XtPointer closure; /* TRUE or FALSE */ + XtPointer data; /* undefined */ +{ + register int i; + int nselected = selected_list.n_elements; + XmuWidgetNode *node; + + switch ((long) closure) { + case SELECT_NOTHING: /* clear selection_list */ + remove_nodes_from_selected_list (0, nselected, True); + break; + + case SELECT_ALL: /* put everything on selection_list */ + add_subtree_to_selected_list (topnode, TRUE); + break; + + case SELECT_INVERT: /* toggle selection state */ + for (i = 0, node = widget_list; i < nwidgets; i++, node++) { + ViewresData *d = VData(node); + if (d->selection_index < 0) add_to_selected_list (node, TRUE); + } + remove_nodes_from_selected_list (0, nselected, True); + break; + + + case SELECT_PARENT: /* choose immediate parent */ + node = widget_to_node (gw); + if (node) { + if (node->superclass) + add_to_selected_list (node->superclass, TRUE); + } else { + for (i = 0; i < nselected; i++) { + XmuWidgetNode *node = selected_list.elements[i]; + if (node->superclass) + add_to_selected_list (node->superclass, TRUE); + } + } + break; + + case SELECT_ANCESTORS: /* chain up adding to selection_list */ + node = widget_to_node (gw); + if (node) { + do { + add_to_selected_list (node, TRUE); + } while ((node = node->superclass) != NULL); + } else { + for (i = 0; i < nselected; i++) { + XmuWidgetNode *parent = selected_list.elements[i]; + + /* + * chain up the tree, but stop if we get to nodes that + * are already in the selected list. + */ + while ((parent = parent->superclass) != NULL) { + if (VData(parent)->selection_index >= 0) break; + add_to_selected_list (parent, TRUE); + } + } + } + break; + + case SELECT_CHILDREN: /* all direct sub nodes */ + node = widget_to_node (gw); + if (node) { + add_to_selected_list (node, TRUE); + for (node = node->children; node; node = node->siblings) { + add_to_selected_list (node, TRUE); + } + } else { + for (i = 0; i < nselected; i++) { + XmuWidgetNode *node = selected_list.elements[i]; + + add_to_selected_list (node, TRUE); + for (node = node->children; node; node = node->siblings) { + add_to_selected_list (node, TRUE); + } + } + } + break; + + case SELECT_DESCENDANTS: /* all sub nodes */ + node = widget_to_node (gw); + if (node) { + add_subtree_to_selected_list (node, TRUE); + } else { + for (i = 0; i < nselected; i++) { + XmuWidgetNode *parent = selected_list.elements[i]; + + add_subtree_to_selected_list (parent, TRUE); + } + } + break; + + case SELECT_HAS_RESOURCES: /* put all w/ rescnt > 0 on sel_list */ + for (i = 0, node = widget_list; i < nwidgets; i++, node++) { + if (VData(node)->nnew > 0) + add_to_selected_list (node, TRUE); + } + break; + + case SELECT_SHOWN_RESOURCES: + for (i = 0, node = widget_list; i < nwidgets; i++, node++) { + if (IsShowing(node)) add_to_selected_list (node, TRUE); + } + break; + + default: /* error!!! */ + XBell (XtDisplay(gw), 0); + return; + } + + update_selection_items (); +} + +/* ARGSUSED */ +static void toggle_callback (gw, closure, data) + Widget gw; + XtPointer closure; /* XmuWidgetNode for this widget */ + XtPointer data; /* on or off */ +{ + XmuWidgetNode *node = (XmuWidgetNode *) closure; + Boolean selected = (Boolean) (long) data; + + if (selected) { + add_to_selected_list (node, FALSE); + } else { + (void) remove_from_selected_list (node, FALSE); + } + + update_selection_items (); +} + + +/* + * panner/porthole controls - called when the other changes + */ +/* ARGSUSED */ +static void panner_callback (gw, closure, data) + Widget gw; /* panner widget */ + XtPointer closure; /* porthole widget */ + XtPointer data; /* report */ +{ + XawPannerReport *rep = (XawPannerReport *) data; + Arg args[2]; + + if (!treeWidget) return; + + XtSetArg (args[0], XtNx, -rep->slider_x); + XtSetArg (args[1], XtNy, -rep->slider_y); + XtSetValues (treeWidget, args, TWO); /* just assume... */ +} + +/* ARGSUSED */ +static void porthole_callback (gw, closure, data) + Widget gw; /* porthole widget */ + XtPointer closure; /* panner widget */ + XtPointer data; /* report */ +{ + Widget panner = (Widget) closure; + XawPannerReport *rep = (XawPannerReport *) data; + Arg args[6]; + Cardinal n = TWO; + + XtSetArg (args[0], XtNsliderX, rep->slider_x); + XtSetArg (args[1], XtNsliderY, rep->slider_y); + if (rep->changed != (XawPRSliderX | XawPRSliderY)) { + XtSetArg (args[2], XtNsliderWidth, rep->slider_width); + XtSetArg (args[3], XtNsliderHeight, rep->slider_height); + XtSetArg (args[4], XtNcanvasWidth, rep->canvas_width); + XtSetArg (args[5], XtNcanvasHeight, rep->canvas_height); + n = SIX; + } + XtSetValues (panner, args, n); +} + + + +static void build_tree (node, tree, super) + XmuWidgetNode *node; + Widget tree; + Widget super; +{ + ViewresData *d = VData (node); + Widget box, w; /* widget for this Class */ + XmuWidgetNode *child; /* iterator over children */ + Arg args[3]; /* need to set super node */ + Cardinal n; /* count of args */ + static XtCallbackRec callback_rec[2] = {{ toggle_callback, NULL }, + { NULL, NULL }}; + + + n = 0; + XtSetArg (args[n], XtNtreeParent, super); n++; + box = XtCreateManagedWidget (node->label, boxWidgetClass, tree, args, n); + + n = 0; + XtSetArg (args[n], XtNlabel, (options.show_variable ? + node->label : XmuWnClassname(node))); n++; + XtSetArg (args[n], XtNcallback, callback_rec); n++; + + callback_rec[0].closure = (XtPointer) node; + w = XtCreateManagedWidget (node->label, toggleWidgetClass, box, args, n); + d->instance = w; + + /* + * recursively build the rest of the tree + */ + for (child = node->children; child; child = child->siblings) { + build_tree (child, tree, box); + } +} + + +static void set_node_labels (node, depth) + XmuWidgetNode *node; + int depth; +{ + Arg args[1]; + XmuWidgetNode *child; + ViewresData *d = VData(node); + + if (!node) return; + XtSetArg (args[0], XtNlabel, (options.show_variable ? + node->label : XmuWnClassname(node))); + XtSetValues (d->instance, args, ONE); + + for (child = node->children; child; child = child->siblings) { + set_node_labels (child, depth + 1); + } +} + + +static void oneof_sensitive (choosea, a, b) + Boolean choosea; + Widget a, b; +{ + static Arg args[1] = { { XtNsensitive, (XtArgVal) NULL } }; + + args[0].value = (XtArgVal) TRUE; + XtSetValues (choosea ? a : b, args, ONE); + args[0].value = (XtArgVal) FALSE; + XtSetValues (choosea ? b : a, args, ONE); +} + +static void set_labeltype_menu (Boolean isvar, Boolean doall) +{ + options.show_variable = isvar; + oneof_sensitive (isvar, view_widgets[VIEW_CLASSES], + view_widgets[VIEW_VARIABLES]); + + if (doall) { + XUnmapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + set_node_labels (topnode, 0); + XawTreeForceLayout (treeWidget); + XMapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + } +} + +static void set_orientation_menu (XtGravity grav, Boolean dosetvalues) +{ +#define CHOOSE(val) (sensitiveargs + (grav != (val))) + XtSetValues (view_widgets[VIEW_HORIZONTAL], CHOOSE(WestGravity), ONE); + XtSetValues (view_widgets[VIEW_VERTICAL], CHOOSE(NorthGravity), ONE); +#undef CHOOSE + + if (dosetvalues) { + Arg args[1]; + + XtSetArg (args[0], XtNgravity, grav); + XUnmapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + XtSetValues (treeWidget, args, ONE); + XMapWindow (XtDisplay(treeWidget), XtWindow(treeWidget)); + } +} + + +/***************************************************************************** + * * + * viewres - visual class browser for Xt * + * * + *****************************************************************************/ + +int +main (argc, argv) + int argc; + char **argv; +{ + Widget toplevel, pane, box, dummy, porthole, panner, form; + XmuWidgetNode *rootNode; /* always the root of the resource hierarchy */ + XtAppContext app_con; + Arg args[6]; + Dimension canvasWidth, canvasHeight, sliderWidth, sliderHeight; + static XtCallbackRec callback_rec[2] = {{ NULL, NULL }, { NULL, NULL }}; + XtGravity grav; + int i; + + ProgramName = argv[0]; + + XtSetLanguageProc(NULL, (XtLanguageProc) NULL, NULL); + + toplevel = XtAppInitialize (&app_con, "Viewres", + Options, XtNumber (Options), + &argc, argv, (char **) fallback_resources, + (ArgList) NULL, ZERO); + if (argc != 1) usage (); + + initialize_widgetnode_list (&selected_list.elements, + &selected_list.max_elements, 10); + + XtGetApplicationResources (toplevel, (XtPointer) &options, + Resources, XtNumber(Resources), NULL, ZERO); + XmuWnInitializeNodes (widget_list, nwidgets); + + topnode = XmuWnNameToNode (widget_list, nwidgets, options.top_object); + if (!topnode) { + fprintf(stderr, "%s: no widget with name \"%s\" found.\n", + ProgramName, options.top_object); + exit(1); + } + + XtAppAddActions (app_con, viewres_actions, XtNumber (viewres_actions)); + XtOverrideTranslations + (toplevel, XtParseTranslationTable ("<Message>WM_PROTOCOLS: Quit()")); + + /* + * create dummy widgets to initialize resources + */ + XtSetArg (args[0], XtNwidth, 1); + XtSetArg (args[1], XtNheight, 1); + dummy = XtCreateWidget ("dummy", widgetClass, toplevel, args, TWO); + rootNode = XmuWnNameToNode(widget_list, nwidgets, "Object"); + for (i = 0; i < nwidgets; i++) { + XmuWidgetNode *node = &widget_list[i]; + XmuWnFetchResources (node, dummy, rootNode); + node->data = (XtPointer) create_viewres_data (node); + } + XtDestroyWidget (dummy); + + pane = XtCreateManagedWidget ("pane", panedWidgetClass, toplevel, + (ArgList) NULL, ZERO); + + box = XtCreateManagedWidget ("buttonbox", boxWidgetClass, pane, + (ArgList) NULL, ZERO); + quitButton = XtCreateManagedWidget ("quit", commandWidgetClass, box, + (ArgList) NULL, ZERO); + + /* + * Format menu + */ + XtSetArg (args[0], XtNmenuName, "viewMenu"); + viewButton = XtCreateManagedWidget ("view", menuButtonWidgetClass, box, + args, ONE); + viewMenu = XtCreatePopupShell ("viewMenu", simpleMenuWidgetClass, + viewButton, (ArgList) NULL, ZERO); + XtSetArg (args[0], XtNcallback, callback_rec); + +#define MAKE_VIEW(n,v,name) \ + callback_rec[0].closure = (XtPointer) v; \ + view_widgets[n] = XtCreateManagedWidget (name, smeBSBObjectClass, \ + viewMenu, args, ONE) + callback_rec[0].callback = (XtCallbackProc) gravity_callback; + MAKE_VIEW (VIEW_HORIZONTAL, WestGravity, "layoutHorizontal"); + MAKE_VIEW (VIEW_VERTICAL, NorthGravity, "layoutVertical"); + + (void) XtCreateManagedWidget ("line1", smeLineObjectClass, viewMenu, + (ArgList) NULL, ZERO); + + callback_rec[0].callback = (XtCallbackProc) variable_labeltype_callback; + MAKE_VIEW (VIEW_VARIABLES, TRUE, "namesVariable"); + MAKE_VIEW (VIEW_CLASSES, FALSE, "namesClass"); + + (void) XtCreateManagedWidget ("line2", smeLineObjectClass, viewMenu, + (ArgList) NULL, ZERO); + + callback_rec[0].callback = (XtCallbackProc) show_resources_callback; + MAKE_VIEW (VIEW_SHOW_RESOURCES, BOOL_ON, "viewResources"); + MAKE_VIEW (VIEW_HIDE_RESOURCES, BOOL_OFF, "viewNoResources"); +#undef MAKE_VIEW + + /* + * Select menu + */ + XtSetArg (args[0], XtNmenuName, "selectMenu"); + selectButton = XtCreateManagedWidget ("select", menuButtonWidgetClass, box, + args, ONE); + selectMenu = XtCreatePopupShell ("selectMenu", simpleMenuWidgetClass, + selectButton, (ArgList) NULL, ZERO); + XtSetArg (args[0], XtNcallback, callback_rec); + callback_rec[0].callback = (XtCallbackProc) select_callback; +#define MAKE_SELECT(n,name) \ + callback_rec[0].closure = (XtPointer) n; \ + select_widgets[n] = XtCreateManagedWidget (name, smeBSBObjectClass, \ + selectMenu, args, ONE) + MAKE_SELECT (SELECT_NOTHING, "unselect"); + MAKE_SELECT (SELECT_ALL, "selectAll"); + MAKE_SELECT (SELECT_INVERT, "selectInvert"); + (void) XtCreateManagedWidget ("line1", smeLineObjectClass, selectMenu, + (ArgList) NULL, ZERO); + MAKE_SELECT (SELECT_PARENT, "selectParent"); + MAKE_SELECT (SELECT_ANCESTORS, "selectAncestors"); + MAKE_SELECT (SELECT_CHILDREN, "selectChildren"); + MAKE_SELECT (SELECT_DESCENDANTS, "selectDescendants"); + (void) XtCreateManagedWidget ("line2", smeLineObjectClass, selectMenu, + (ArgList) NULL, ZERO); + MAKE_SELECT (SELECT_HAS_RESOURCES, "selectHasResources"); + MAKE_SELECT (SELECT_SHOWN_RESOURCES, "selectShownResources"); +#undef MAKE_SELECT + + form = XtCreateManagedWidget ("treeform", formWidgetClass, pane, + (ArgList) NULL, ZERO); + /* + * create the panner and the porthole and then connect them with the + * callbacks (passing the other widget each callback) + */ + XtSetArg (args[0], XtNbackgroundPixmap, None); /* faster updates */ + porthole = XtCreateManagedWidget ("porthole", portholeWidgetClass, form, + args, ONE); + panner = XtCreateManagedWidget ("panner", pannerWidgetClass, form, + (ArgList) NULL, ZERO); + + XtSetArg (args[0], XtNreportCallback, callback_rec); + callback_rec[0].callback = (XtCallbackProc) panner_callback; + callback_rec[0].closure = (XtPointer) porthole; + XtSetValues (panner, args, ONE); + + callback_rec[0].callback = (XtCallbackProc) porthole_callback; + callback_rec[0].closure = (XtPointer) panner; + XtSetValues (porthole, args, ONE); + + /* + * now that the panner and porthole are set up, insert the tree and + * fix up the menu, fill in the nodes + */ + treeWidget = XtCreateManagedWidget ("tree", treeWidgetClass, + porthole, (ArgList) NULL, ZERO); + + set_labeltype_menu (options.show_variable, FALSE); + XtSetArg (args[0], XtNgravity, &grav); + XtGetValues (treeWidget, args, ONE); + set_orientation_menu (grav, FALSE); + update_selection_items (); + build_tree (topnode, treeWidget, (Widget) NULL); + + /* + * Realize the tree, but do not map it (we set mappedWhenManaged to + * false up above). Get the initial size of the tree so that we can + * size the panner appropriately. + */ + XtRealizeWidget (toplevel); + + wm_delete_window = XInternAtom(XtDisplay(toplevel), "WM_DELETE_WINDOW", + False); + (void) XSetWMProtocols (XtDisplay(toplevel), XtWindow(toplevel), + &wm_delete_window, 1); + + XtSetArg (args[0], XtNwidth, &canvasWidth); + XtSetArg (args[1], XtNheight, &canvasHeight); + XtGetValues (treeWidget, args, TWO); + + XtSetArg (args[0], XtNwidth, &sliderWidth); + XtSetArg (args[1], XtNheight, &sliderHeight); + XtGetValues (porthole, args, TWO); + + XtSetArg (args[0], XtNcanvasWidth, canvasWidth); + XtSetArg (args[1], XtNcanvasHeight, canvasHeight); + XtSetArg (args[2], XtNsliderWidth, sliderWidth); + XtSetArg (args[3], XtNsliderHeight, sliderHeight); + XtSetValues (panner, args, FOUR); + + XRaiseWindow (XtDisplay(panner), XtWindow(panner)); + XtAppMainLoop (app_con); + + return 0; +} + + + +/***************************************************************************** + * * + * viewres translation table action routines * + * * + *****************************************************************************/ + +/* ARGSUSED */ +static void ActionQuit (w, event, params, num_params) + Widget w; + XEvent *event; + String *params; + Cardinal *num_params; +{ + exit (0); +} + +/* ARGSUSED */ +static void ActionSetLableType (w, event, params, num_params) + Widget w; + XEvent *event; + String *params; + Cardinal *num_params; +{ + const char *cmd; + Boolean oldvar = options.show_variable, newvar; + + switch (*num_params) { + case 0: + cmd = "toggle"; + break; + case 1: + cmd = params[0]; + break; + default: + XBell (XtDisplay(w), 0); + return; + } + + if (XmuCompareISOLatin1 (cmd, "toggle") == 0) { + newvar = !oldvar; + } else if (XmuCompareISOLatin1 (cmd, "variable") == 0) { + newvar = TRUE; + } else if (XmuCompareISOLatin1 (cmd, "class") == 0) { + newvar = FALSE; + } else { + XBell (XtDisplay(w), 0); + return; + } + + if (newvar != oldvar) set_labeltype_menu (newvar, TRUE); + return; +} + +/* ARGSUSED */ +static void ActionSetOrientation (w, event, params, num_params) + Widget w; + XEvent *event; + String *params; + Cardinal *num_params; +{ + XtGravity newgrav = ForgetGravity; + + if (*num_params < 1) { + Arg arg; + XtGravity oldgrav = ForgetGravity; + + XtSetArg (arg, XtNgravity, &oldgrav); + XtGetValues (treeWidget, &arg, ONE); + switch (oldgrav) { + case WestGravity: newgrav = NorthGravity; break; + case NorthGravity: newgrav = WestGravity; break; + case EastGravity: newgrav = SouthGravity; break; + case SouthGravity: newgrav = EastGravity; break; + default: + return; + } + } else { + XrmValue fromval, toval; + + fromval.size = sizeof (String); + fromval.addr = (XPointer) params[0]; + toval.size = sizeof (XtGravity); + toval.addr = (XPointer) &newgrav; + XtConvertAndStore (treeWidget, XtRString, &fromval, + XtRGravity, &toval); + } + + switch (newgrav) { + case WestGravity: case NorthGravity: case EastGravity: case SouthGravity: + break; + default: + XBell (XtDisplay(w), 0); + return; + } + + set_orientation_menu (newgrav, TRUE); + return; +} + + +static void do_single_arg (w, params, nparams, table, nentries, proc) + Widget w; + String *params; + Cardinal nparams; + struct _nametable table[]; + int nentries; + void (*proc)(); +{ + int obj; + int i; + + if (nparams != 1) { + XBell (XtDisplay(w), 0); + return; + } + + for (i = 0; i < nentries; i++) { + if (XmuCompareISOLatin1 (params[0], table[i].name) == 0) { + obj = table[i].value; + goto found; + } + } + XBell (XtDisplay(w), 0); + return; + + found: + /* + * use any old widget + */ + (*proc) (w, (XtPointer) (long) obj, (XtPointer) NULL); +} + + +/* ARGSUSED */ +static void ActionSelect (w, event, params, num_params) + Widget w; + XEvent *event; + String *params; + Cardinal *num_params; +{ + do_single_arg (w, params, *num_params, select_nametable, + (int) XtNumber(select_nametable), select_callback); +} + + +/* ARGSUSED */ +static void ActionResources (w, event, params, num_params) + Widget w; + XEvent *event; + String *params; + Cardinal *num_params; +{ + if (*num_params == 0) { + show_resources_callback (w, (XtPointer) BOOL_TOGGLE, (XtPointer) NULL); + } else { + do_single_arg (w, params, *num_params, boolean_nametable, + (int) XtNumber(boolean_nametable), + show_resources_callback); + } +} + diff --git a/viewres.man b/viewres.man new file mode 100644 index 0000000..e6c5c3f --- /dev/null +++ b/viewres.man @@ -0,0 +1,216 @@ +.\" $XConsortium: viewres.man,v 1.8 94/04/17 20:43:25 gildea Exp $ +.\" Copyright (c) 1994 X Consortium +.\" +.\" Permission is hereby granted, free of charge, to any person obtaining +.\" a copy of this software and associated documentation files (the +.\" "Software"), to deal in the Software without restriction, including +.\" without limitation the rights to use, copy, modify, merge, publish, +.\" distribute, sublicense, and/or sell copies of the Software, and to +.\" permit persons to whom the Software is furnished to do so, subject to +.\" the following conditions: +.\" +.\" The above copyright notice and this permission notice shall be included +.\" in all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. +.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR +.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, +.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +.\" OTHER DEALINGS IN THE SOFTWARE. +.\" +.\" Except as contained in this notice, the name of the X Consortium shall +.\" not be used in advertising or otherwise to promote the sale, use or +.\" other dealings in this Software without prior written authorization +.\" from the X Consortium. +.\" +.\" $XFree86: xc/programs/viewres/viewres.man,v 1.3 2001/01/27 18:21:07 dawes Exp $ +.\" +.TH VIEWRES 1 __xorgversion__ +.SH NAME +viewres - graphical class browser for Xt +.SH SYNOPSIS +.B "viewres" +[-option ...] +.SH DESCRIPTION +.PP +The \fIviewres\fP 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. +.SH OPTIONS +\fIViewres\fP accepts all of the standard toolkit command line options as +well as the following: +.TP 8 +.B \-top \fIname\fP +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 \fIObject\fP. +.TP 8 +.B \-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 \fIText\fP). +.TP 8 +.B \-vertical +This option indicates that the tree should be displayed top to bottom +rather left to right. +.SH "VIEW MENU" +The way in which the tree is displayed may be changed through the +entries in the \fBView\fP menu: +.TP 8 +.B "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 \fBSetLabelType(variable)\fP translation. +.TP 8 +.B "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 +\fBSetLabelType(class)\fP translation. +.TP 8 +.B "Layout Horizontal" +This entry causes the tree to be laid out from left to right. This operation +may also be performed with the \fISetOrientation(West)\fP translation. +.TP 8 +.B "Layout Vertical" +This entry causes the tree to be laid out from top to bottom. This operation +may also be performed with the \fISetOrientation(North)\fP translation. +.TP 8 +.B "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 \fIResources(on)\fP translation. +.TP 8 +.B "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 \fIResources(off)\fP translation. +.SH "SELECT MENU" +Resources for a single widget class can be displayed by clicking +\fBButton2\fP on the corresponding node, or by adding the node to the +selection list with \fBButton1\fP and using the \fBShow Resource Boxes\fP +entry in the \fBView\fP menu. Since \fBButton1\fP actually toggles the +selection state of a node, clicking on a selected node will cause it to be +removed from the selected list. +.PP +Collections of nodes may also be selected through the various entries in +the \fBSelect\fP menu: +.TP 8 +.B "Unselect All" +This entry removes all nodes from the selection list. This operation +may also be performed with the \fISelect(nothing)\fP translation. +.TP 8 +.B "Select All" +This entry adds all nodes to the selection list. This operation +may also be performed with the \fISelect(all)\fP translation. +.TP 8 +.B "Invert All" +This entry adds unselected nodes to, and removes selected nodes from, the +selection list. This operation +may also be performed with the \fISelect(invert)\fP translation. +.TP 8 +.B "Select Parent" +This entry selects the immediate parents of all selected nodes. This operation +may also be performed with the \fISelect(parent)\fP translation. +.TP 8 +.B "Select Ancestors" +This entry recursively selects all parents of all selected nodes. This +operation may also be performed with the \fISelect(ancestors)\fP translation. +.TP 8 +.B "Select Children" +This entry selects the immediate children of all selected nodes. This +operation may also be performed with the \fISelect(children)\fP translation. +.TP 8 +.B "Select Descendants" +This entry recursively selects all children of all selected nodes. This +operation may also be performed with the \fISelect(descendants)\fP translation. +.TP 8 +.B "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 \fISelect(resources)\fP translation. +.TP 8 +.B "Select Shown Resource Boxes" +This entry selects all nodes whose resource boxes are currently expanded +(usually so that they can be closed with \fBHide Resource Boxes\fP). This +operation may also be performed with the \fISelect(shown)\fP translation. +.SH "ACTIONS" +The following application actions are provided: +.TP 8 +.B "Quit()" +.br +This action causes \fIviewres\fP to exit. +.TP 8 +.B "SetLabelType(\fItype\fP)" +This action sets the node labels to display the widget \fIvariable\fP or +\fIclass\fP names, according to the argument \fItype\fP. +.TP 8 +.B "SetOrientation(\fIdirection\fP)" +This action sets the root of the tree to be one of the following areas of +the window: \fIWest\fP, \fINorth\fP, \fIEast\fP, or \fISouth\fP. +.TP 8 +.B "Select(\fIwhat\fP)" +This action selects the indicated nodes, as described in the \fBVIEW MENU\fP +section: \fInothing\fP (unselects all nodes), \fIinvert\fP, \fIparent\fP, +\fIancestors\fP, \fIchildren\fP, \fIdescendants\fP, \fIresources\fP, +\fIshown\fP. +.TP 8 +.B "Resources(\fIop\fP)" +This action turns \fIon\fP, \fIoff\fP, or \fItoggles\fP 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. +.SH "WIDGET HIERARCHY" +Resources may be specified for the following widgets: +.sp +.nf +.ta .5i 1.0i 1.5i 2.0i 2.5i 3.0i 3.5i 4.0i 4.5i 5.0i 5.5i 6.0i 6.5i 7.0i +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 \fIvariable-name\fP + Toggle \fIvariable-name\fP + List \fIvariable-name\fP + Panner panner +.fi +.sp +where \fIvariable-name\fP is the widget variable name of each node. +.SH "SEE ALSO" +X(__miscmansuffix__), xrdb(1), listres(1), editres(1), appres(1), appropriate widget documents +.SH COPYRIGHT +Copyright ([\d,\s]*) X Consortium +.br +See \fIX(__miscmansuffix__)\fP for a full statement of rights and permissions. +.SH AUTHOR +Jim Fulton, MIT X Consortium |