1XmManager(library call) XmManager(library call)
2
6 XmManager — The Manager widget class
7
9 #include <Xm/Xm.h>
10
12 Manager is a widget class used as a supporting superclass for other
13 widget classes. It supports the visual resources, graphics contexts,
14 and traversal resources necessary for the graphics and traversal mecha‐
15 nisms.
16 Classes
18 Manager inherits behavior and resources from Core, Composite, and Con‐
19 straint.
20 The class pointer is xmManagerWidgetClass.
22 The class name is XmManager.
24 New Resources
26 The following table defines a set of widget resources used by the pro‐
27 grammer to specify data. The programmer can also set the resource val‐
28 ues for the inherited classes to set attributes for this widget. To
29 reference a resource by name or by class in a .Xdefaults file, remove
30 the XmN or XmC prefix and use the remaining letters. To specify one of
31 the defined values for a resource in a .Xdefaults file, remove the Xm
32 prefix and use the remaining letters (in either lowercase or uppercase,
33 but include any underscores between words). The codes in the access
34 column indicate if the given resource can be set at creation time (C),
35 set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
36 not applicable (N/A).
37 ┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
39 │ │ XmManager │Resource Set │ │ │
40 │Name │ Class │ Type │ Default │ Access │
41 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
42 │XmNbottomShadowColor │ XmCBottomShadowColor │ Pixel │ dynamic │ CSG │
43 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
44 │XmNbottomShadowPixmap │ XmCBottomShadowPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
45 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
46 │XmNforeground │ XmCForeground │ Pixel │ dynamic │ CSG │
47 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
48 │XmNhelpCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
49 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
50 │XmNhighlightColor │ XmCHighlightColor │ Pixel │ dynamic │ CSG │
51 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
52 │XmNhighlightPixmap │ XmCHighlightPixmap │ Pixmap │ dynamic │ CSG │
53 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
54 │XmNinitialFocus │ XmCInitialFocus │ Widget │ NULL │ CSG │
55 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
56 │XmNlayoutDirection │ XmCLayoutDirection │ XmDirection │ dynamic │ CG │
57 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
58 │XmNnavigationType │ XmCNavigationType │ XmNavigationType │ XmTAB_GROUP │ CSG │
59 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
60 │XmNpopupHandlerCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
61 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
62 │XmNshadowThickness │ XmCShadowThickness │ Dimension │ 0 │ CSG │
63 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
64 │XmNstringDirection │ XmCStringDirection │ XmStringDirection │ dynamic │ CG │
65 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
66 │XmNtopShadowColor │ XmCTopShadowColor │ Pixel │ dynamic │ CSG │
67 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
68 │XmNtopShadowPixmap │ XmCTopShadowPixmap │ Pixmap │ dynamic │ CSG │
69 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
70 │XmNtraversalOn │ XmCTraversalOn │ Boolean │ True │ CSG │
71 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
72 │XmNunitType │ XmCUnitType │ unsigned char │ dynamic │ CSG │
73 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
74 │XmNuserData │ XmCUserData │ XtPointer │ NULL │ CSG │
75 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
76 └────────────────────────┴───────────────────────┴───────────────────┴──────────────────────┴────────┘
77 XmNbottomShadowColor
78 Specifies the color to use to draw the bottom and right sides
79 of the border shadow. This color is used if the XmNbot‐
80 tomShadowPixmap resource is NULL.
81 XmNbottomShadowPixmap
83 Specifies the pixmap to use to draw the bottom and right
84 sides of the border shadow.
85 XmNforeground
87 Specifies the foreground drawing color used by manager wid‐
88 gets.
89 XmNhelpCallback
91 Specifies the list of callbacks that are called when the help
92 key sequence is pressed. The reason sent by this callback is
93 XmCR_HELP.
94 XmNhighlightColor
96 Specifies the color of the highlighting rectangle. This
97 color is used if the highlight pixmap resource is XmUNSPECI‐
98 FIED_PIXMAP.
99 XmNhighlightPixmap
101 Specifies the pixmap used to draw the highlighting rectangle.
102 XmNinitialFocus
104 Specifies the ID of a widget descendant of the manager. The
105 widget must meet these conditions:
106 · The widget must be either a tab group or a non-tab-
108 group widget that can receive keyboard focus. For the
109 definition of a tab group, see the description of the
110 Manager, Primitive, and Gadget XmNnavigationType
111 resources. In general a widget can receive keyboard
112 focus when it is a primitive, a gadget, or a manager
113 (such as a DrawingArea with no traversable children)
114 that acts as a primitive.
115 · The widget must not be a descendant of a tab group that
117 is itself a descendant of the manager. That is, the
118 widget cannot be contained within a tab group that is
119 nested inside the manager.
120 · The widget and its ancestors must have a value of True
122 for their XmNtraversalOn resources.
123 If the widget does not meet these conditions, XmNinitialFocus
125 is treated as if the value were NULL.
126 This resource is meaningful only when the nearest shell
128 ancestor's XmNkeyboardFocusPolicy is XmEXPLICIT. It is used
129 to determine which widget receives focus in these situations:
130 · When the manager is the child of a shell and the shell
132 hierarchy receives focus for the first time
133 · When focus is inside the shell hierarchy, the manager
135 is a composite tab group, and the user traverses to the
136 manager via the keyboard
137 Focus is then determined as follows:
139 · If XmNinitialFocus is a traversable non-tab-group wid‐
141 get, that widget receives focus.
142 · If XmNinitialFocus is a traversable tab group, that tab
144 group receives focus. If that tab group is a composite
145 with descendant tab groups or traversable non-tab-group
146 widgets, these procedures are used recursively to
147 assign focus to a descendant of that tab group.
148 · If XmNinitialFocus is NULL, the first traversable non-
150 tab-group widget that is not contained within a nested
151 tab group receives focus.
152 · If XmNinitialFocus is NULL and no traversable non-tab-
154 group widget exists, the first traversable tab group
155 that is not contained within a nested tab group
156 receives focus. If that tab group is a composite with
157 descendant tab groups or traversable non-tab-group wid‐
158 gets, these procedures are used recursively to assign
159 focus to a descendant of that tab group.
160 If a shell hierarchy regains focus after losing it, focus
162 returns to the widget that had the focus at the time it left
163 the hierarchy.
164 The use of XmNinitialFocus is undefined if the manager is a
166 MenuBar, PulldownMenu, PopupMenu, or OptionMenu.
167 XmNlayoutDirection
169 Specifies the direction in which components of the manager
170 (including strings) are laid out. The values are of type
171 XmDirection. If the widget's parent is a manager or shell,
172 the value is inherited from the widget's parent. Otherwise,
173 it is inherited from the closest ancestor vendor or menu
174 shell. Refer to the XmDirection(3) reference page for the
175 possible direction values.
176 XmNnavigationType
178 Determines whether the widget is a tab group.
179 XmNONE Indicates that the widget is not a tab group.
181 XmTAB_GROUP
183 Indicates that the widget is a tab group, unless
184 the XmNnavigationType of another widget in the
185 hierarchy is XmEXCLUSIVE_TAB_GROUP.
186 XmSTICKY_TAB_GROUP
188 Indicates that the widget is a tab group, even if
189 the XmNnavigationType of another widget in the
190 hierarchy is XmEXCLUSIVE_TAB_GROUP.
191 XmEXCLUSIVE_TAB_GROUP
193 Indicates that the widget is a tab group and that
194 widgets in the hierarchy whose XmNnavigationType is
195 XmTAB_GROUP are not tab groups.
196 When a parent widget has an XmNnavigationType of
198 XmEXCLUSIVE_TAB_GROUP, traversal of non-tab-group
199 widgets within the group is based on the order of
200 those widgets in their parent's XmNchildren list.
201 When the XmNnavigationType of any widget in a hier‐
203 archy is XmEXCLUSIVE_TAB_GROUP, traversal of tab
204 groups in the hierarchy proceeds to widgets in the
205 order in which their XmNnavigationType resources
206 were specified as XmEXCLUSIVE_TAB_GROUP or
207 XmSTICKY_TAB_GROUP, whether by creating the widgets
208 with that value, by calling XtSetValues, or by
209 calling XmAddTabGroup.
210 XmNpopupHandlerCallback
212 Allows the application to control which popup menu will be
213 automatically posted. The reason can either be XmCR_POST or
214 XmCR_REPOST:
215 XmCR_POST Indicates that this is a regular posting request.
217 XmCR_REPOST
219 Indicates that the menu was just unposted and that
220 this callback was invoked on a replay.
221 This callback uses the XmPopupHandlerCallbackStruct structure
223 to pass information.
224 XmNshadowThickness
226 Specifies the thickness of the drawn border shadow. XmBul‐
227 letinBoard and its descendants set this value dynamically.
228 If the widget is a top-level window, this value is set to 1.
229 If it is not a top-level window, this value is set to 0
230 (zero).
231 XmNstringDirection
233 Is a synthetic resource for setting XmNlayoutDirection. The
234 values for this resource are XmSTRING_DIRECTION_L_TO_R and
235 XmSTRING_DIRECTION_R_TO_L. Refer to the XmNlayoutDirection
236 resource description. The XmNstringDirection resource is
237 obsoleted by XmNlayoutDirection, but is kept here for back‐
238 ward compatibility.
239 XmNtopShadowColor
241 Specifies the color to use to draw the top and left sides of
242 the border shadow. This color is used if the XmNtopShadow‐
243 Pixmap resource is NULL.
244 XmNtopShadowPixmap
246 Specifies the pixmap to use to draw the top and left sides of
247 the border shadow.
248 XmNtraversalOn
250 Specifies whether traversal is activated for this widget.
251 XmNunitType
253 Provides the basic support for resolution independence. It
254 defines the type of units a widget uses with sizing and posi‐
255 tioning resources. If the widget's parent is a subclass of
256 XmManager and if the XmNunitType resource is not explicitly
257 set, it defaults to the unit type of the parent widget. If
258 the widget's parent is not a subclass of XmManager, the
259 resource has a default unit type of XmPIXELS.
260 The unit type can also be specified in resource files, with
262 the following format:
263 <floating value><unit>
265 where:
267 unit is <" ", pixels, inches, centimeters, millimeters,
269 points, font units>
270 pixels is <pix, pixel, pixels>
272 inches is <in, inch, inches>
274 centimeter
276 is <cm, centimeter, centimeters>
277 millimeters
279 is <mm, millimeter, millimeters>
280 points is <pt, point, points>
282 font units
284 is <fu, font_unit, font_units>
285 float is {"+"|"-"}{{<"0"-"9">*}.}<"0"-"9">*
287 Note that the type Dimension must always be posi‐
289 tive.
290 For example,
292 xmfonts*XmMainWindow.height: 10.4cm
294 *PostIn.width: 3inches
295 XmNunitType can have the following values:
297 XmPIXELS All values provided to the widget are treated as
299 normal pixel values.
300 XmMILLIMETERS
302 All values provided to the widget are treated as
303 normal millimeter values.
304 Xm100TH_MILLIMETERS
306 All values provided to the widget are treated as
307 1/100 of a millimeter.
308 XmCENTIMETERS
310 All values provided to the widget are treated as
311 normal centimeter values.
312 XmINCHES All values provided to the widget are treated as
314 normal inch values.
315 Xm1000TH_INCHES
317 All values provided to the widget are treated as
318 1/1000 of an inch.
319 XmPOINTS All values provided to the widget are treated as
321 normal point values. A point is a unit used in text
322 processing applications and is defined as 1/72 of
323 an inch.
324 Xm100TH_POINTS
326 All values provided to the widget are treated as
327 1/100 of a point. A point is a unit used in text
328 processing applications and is defined as 1/72 of
329 an inch.
330 XmFONT_UNITS
332 All values provided to the widget are treated as
333 normal font units. A font unit has horizontal and
334 vertical components. These are the values of the
335 XmScreen resources XmNhorizontalFontUnit and XmN‐
336 verticalFontUnit.
337 Xm100TH_FONT_UNITS
339 All values provided to the widget are treated as
340 1/100 of a font unit. A font unit has horizontal
341 and vertical components. These are the values of
342 the XmScreen resources XmNhorizontalFontUnit and
343 XmNverticalFontUnit.
344 XmNuserData
346 Allows the application to attach any necessary specific data
347 to the widget. This is an internally unused resource.
348 Dynamic Color Defaults
350 The foreground, background, top shadow, bottom shadow, and highlight
351 color resources are dynamically defaulted. If no color data is speci‐
352 fied, the colors are automatically generated. On a single-plane system,
353 a black and white color scheme is generated. Otherwise, four colors are
354 generated, which display the correct shading for the 3-D visuals. If
355 the background is the only color specified for a widget, the top shadow
356 and bottom shadow colors are generated to give the 3-D appearance.
357 Foreground and highlight colors are generated to provide sufficient
358 contrast with the background color.
359 Colors are generated only at creation. Resetting the background through
361 XtSetValues does not regenerate the other colors. XmChangeColor can be
362 used to recalculate all associated colors based on a new background
363 color.
364 Inherited Resources
366 Manager inherits resources from the superclasses described in the fol‐
367 lowing tables. For a complete description of each resource, refer to
368 the reference page for that superclass.
369 ┌───────────────────────────────────────────────────────────────────────┐
371 │ │ Composite Reso│urce Set │ │ │
372 │Name │ Class │ Type │ Default │ Access │
373 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
374 │XmNchildren │ XmCReadOnly │ WidgetList │ NULL │ G │
375 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
376 │XmNinsertPosition │ XmCInsertPosition │ XtOrderProc │ NULL │ CSG │
377 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
378 │XmNnumChildren │ XmCReadOnly │ Cardinal │ 0 │ G │
379 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
380 └──────────────────┴───────────────────┴─────────────┴─────────┴────────┘
381 ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
382 │ │ Core Resource Se│t │ │ │
383 │Name │ Class │ Type │ Default │ Access │
384 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
385 │XmNaccelerators │ XmCAccelerators │ XtAccelerators │ dynamic │ CSG │
386 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
387 │XmNancestorSensitive │ XmCSensitive │ Boolean │ dynamic │ G │
388 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
389 │XmNbackground │ XmCBackground │ Pixel │ dynamic │ CSG │
390 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
391 │XmNbackgroundPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
392 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
393 │XmNborderColor │ XmCBorderColor │ Pixel │ XtDefaultForeground │ CSG │
394 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
395 │XmNborderPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
396 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
397 │XmNborderWidth │ XmCBorderWidth │ Dimension │ 0 │ CSG │
398 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
399 │XmNcolormap │ XmCColormap │ Colormap │ dynamic │ CG │
400 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
401 │XmNdepth │ XmCDepth │ int │ dynamic │ CG │
402 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
403 │XmNdestroyCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
404 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
405 │XmNheight │ XmCHeight │ Dimension │ dynamic │ CSG │
406 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
407 │XmNinitialResourcesPersistent │ XmCInitialResourcesPersistent │ Boolean │ True │ C │
408 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
409 │XmNmappedWhenManaged │ XmCMappedWhenManaged │ Boolean │ True │ CSG │
410 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
411 │XmNscreen │ XmCScreen │ Screen * │ dynamic │ CG │
412 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
413 │XmNsensitive │ XmCSensitive │ Boolean │ True │ CSG │
414 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
415 │XmNtranslations │ XmCTranslations │ XtTranslations │ dynamic │ CSG │
416 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
417 │XmNwidth │ XmCWidth │ Dimension │ dynamic │ CSG │
418 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
419 │XmNx │ XmCPosition │ Position │ 0 │ CSG │
420 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
421 │XmNy │ XmCPosition │ Position │ 0 │ CSG │
422 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
423 └──────────────────────────────┴───────────────────────────────┴────────────────┴──────────────────────┴────────┘
424 Callback Information
425 A pointer to the following structure is passed to each callback for
426 XmNhelpCallback:
427 typedef struct
429 {
430 int reason;
431 XEvent * event;
432 } XmAnyCallbackStruct;
433 reason Indicates why the callback was invoked. For this callback,
435 reason is set to XmCR_HELP.
436 event Points to the XEvent that triggered the callback.
438 A pointer to the following structure is passed to each callback for
440 XmNpopupHandlerCallback:
441 typedef struct
443 {
444 int reason;
445 XEvent * event;
446 Widget menuToPost;
447 Boolean postIt;
448 Widget target;
449 } XmPopupHandlerCallbackStruct;
450 reason Indicates why the callback was invoked.
452 event Points to the XEvent that triggered the handler.
454 menuToPost
456 Specifies the popup menu that the menu system believes should
457 be posted. The application may modify this field.
458 postIt Indicates whether the posting process should continue. The
460 application may modify this field.
461 target Specifies the most specific widget or gadget that the menu
463 sytem found from the event that matches the event.
464 Translations
466 The following set of translations are used by Manager widgets that have
467 Gadget children. Because Gadgets cannot have translations associated
468 with them, it is the responsibility of the Manager widget to intercept
469 the events of interest and pass them to any Gadget child with focus.
470 These events are ignored if no Gadget child has the focus.
471 The following key names are listed in the X standard key event transla‐
473 tion table syntax. This format is the one used by Motif to specify the
474 widget actions corresponding to a given key. A brief overview of the
475 format is provided under VirtualBindings(3). For a complete descrip‐
476 tion of the format, please refer to the X Toolkit Instrinsics Documen‐
477 tation.
478 <BtnMotion>:
480 ManagerGadgetButtonMotion()
481 c<Btn1Down>:
483 ManagerGadgetTraverseCurrent()
484 ∼c<Btn1Down>:
486 ManagerGadgetArm()
487 ∼c<Btn1Down>,∼c<Btn1Up>:
489 ManagerGadgetActivate()
490 ∼c<Btn1Up>:
492 ManagerGadgetActivate()
493 ∼c<Btn1Down>(2+):
495 ManagerGadgetMultiArm()
496 ∼c<Btn1Up>(2+):
498 ManagerGadgetMultiActivate()
499 <Btn2Down>:
501 ManagerGadgetDrag()
502 :<Key><osfActivate>:
504 ManagerParentActivate()
505 :<Key><osfCancel>:
507 ManagerParentCancel()
508 :<Key><osfSelect>:
510 ManagerGadgetSelect()
511 :<Key><osfHelp>:
513 ManagerGadgetHelp()
514 ∼s ∼m ∼a <Key>Return:
516 ManagerParentActivate()
517 ∼s ∼m ∼a <Key>space:
519 ManagerGadgetSelect()
520 <Key>: ManagerGadgetKeyInput()
522 :<Key><osfBeginLine>:
524 ManagerGadgetTraverseHome()
525 :<Key><osfUp>:
527 ManagerGadgetTraverseUp()
528 :<Key><osfDown>:
530 ManagerGadgetTraverseDown()
531 :<Key><osfLeft>:
533 ManagerGadgetTraverseLeft()
534 :<Key><osfRight>:
536 ManagerGadgetTraverseRight()
537 s ∼m ∼a <Key>Tab:
539 ManagerGadgetPrevTabGroup()
540 ∼m ∼a <Key>Tab:
542 ManagerGadgetNextTabGroup()
543 Action Routines
545 The XmManager action routines are
546 GadgetTakeFocus():
548 Causes the current gadget to take keyboard focus when
549 Ctrl<Btn1Down> is pressed.
550 ManagerGadgetActivate():
552 Causes the current gadget to be activated.
553 ManagerGadgetArm():
555 Causes the current gadget to be armed.
556 ManagerGadgetButtonMotion():
558 Causes the current gadget to process a mouse motion event.
559 ManagerGadgetDrag():
561 Causes the current gadget to begin a drag operation. This
562 action is undefined for gadgets used in a menu system.
563 ManagerGadgetHelp():
565 Calls the callbacks for the current gadget's XmNhelpCallback
566 if any exist. If there are no help callbacks for this wid‐
567 get, this action calls the help callbacks for the nearest
568 ancestor that has them.
569 ManagerGadgetKeyInput():
571 Causes the current gadget to process a keyboard event.
572 ManagerGadgetMultiActivate():
574 Causes the current gadget to process a multiple mouse click.
575 ManagerGadgetMultiArm():
577 Causes the current gadget to process a multiple mouse button
578 press.
579 ManagerGadgetNextTabGroup():
581 This action depends on the value of the Display resource
582 XmNenableButtonTab. When XmNenableButtonTab is False
583 (default), this action traverses to the first item in the
584 next tab group. If the current tab group is the last entry in
585 the tab group list, it wraps to the beginning of the tab
586 group list.
587 When XmNenableButtonTab is True, this action moves to the
589 next item within the current tab group, unless it is the last
590 item in the tab group. When the item is the last in the
591 group, the action traverses to the first item in the next tab
592 group. The XmNenableButtonTab behavior applies only to Push‐
593 Button, ArrowButton, and DrawnArrow.
594 ManagerGadgetPrevTabGroup():
596 This action depends on the value of the Display resource
597 XmNenableButtonTab. When XmNenableButtonTab is False
598 (default), this action traverses to the first item in the
599 previous tab group. If the beginning of the tab group list is
600 reached, it wraps to the end of the tab group list.
601 When XmNenableButtonTab is True, this action moves to the
603 previous item within the current tab group unless it is the
604 first item in the tab group. When the item is the first in
605 the group, the action traverses to the first item in the pre‐
606 vious tab group. The XmNenableButtonTab behavior applies only
607 PushButton, ArrowButton, and DrawnButton.
608 ManagerGadgetSelect():
610 Causes the current gadget to be armed and activated.
611 ManagerGadgetTraverseCurrent
613 Causes the current gadget to take keyboard focus when
614 Ctrl<Btn1Down> is pressed. Gadget is not activated.
615 ManagerGadgetTraverseDown():
617 Traverses to the next item below the current gadget in the
618 current tab group, wrapping if necessary. The wrapping
619 direction depends on the layout direction of the widget tab
620 group.
621 ManagerGadgetTraverseHome():
623 Traverses to the first widget or gadget in the current tab
624 group.
625 ManagerGadgetTraverseLeft():
627 Traverses to the next item to the left of the current gadget
628 in the current tab group, wrapping if necessary. The wrap‐
629 ping direction depends on the layout direction of the widget
630 tab group.
631 ManagerGadgetTraverseNext():
633 Traverses to the next item in the current tab group, wrapping
634 if necessary. The wrapping direction depends on the layout
635 direction of the widget tab group.
636 ManagerGadgetTraversePrev():
638 Traverses to the previous item in the current tab group,
639 wrapping if necessary. The wrapping direction depends on the
640 layout direction of the widget tab group.
641 ManagerGadgetTraverseRight()
643 Traverses to the next item to the right of the current gadget
644 in the current tab, wrapping if necessary. widget tab group.
645 The wrapping direction depends on the layout direction of the
646 widget tab group.
647 ManagerGadgetTraverseUp():
649 Traverses to the next item above the current gadget in the
650 current tab group, wrapping if necessary. The wrapping
651 direction depends on the layout direction of the widget tab
652 group.
653 ManagerParentActivate():
655 If the parent is a manager, passes the <osfActivate> event
656 received by the current widget/gadget to its parent.
657 ManagerParentCancel():
659 If the parent is a manager, passes the <osfCancel> event
660 received by the current widget/gadget to its parent.
661 Additional Behavior
663 This widget has the additional behavior described below:
664 <FocusIn>:
666 If the shell's keyboard focus policy is XmEXPLICIT and the
667 event occurs in a gadget, causes the gadget to be highlighted
668 and to take the focus.
669 <FocusOut>:
671 If the shell's keyboard focus policy is XmEXPLICIT and the
672 event occurs in a gadget, causes the gadget to be unhigh‐
673 lighted and to lose the focus.
674 Virtual Bindings
676 The bindings for virtual keys are vendor specific. For information
677 about bindings for virtual buttons and keys, see VirtualBindings(3).
678
680 Composite(3), Constraint(3), Core(3), XmDirection(3), XmChangeColor(3),
681 XmGadget(3), and XmScreen(3).
682 XmManager(library call)