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

FreeBSD Manual Pages

  
 
  

home | help
XmRowColumn(3)		   Library Functions Manual		XmRowColumn(3)

NAME
       XmRowColumn -- The RowColumn widget class

SYNOPSIS
       #include	<Xm/RowColumn.h>

DESCRIPTION
       The  RowColumn widget is	a general purpose RowColumn manager capable of
       containing any widget type as a child.  In general, it requires no spe-
       cial knowledge about how	its children function and provides nothing be-
       yond support for	several	different layout styles. However,  it  can  be
       configured  as a	menu, in which case, it	expects	only certain children,
       and it configures to a  particular  layout.  The	 menus	supported  are
       MenuBar,	 Pulldown or Popup menu	panes, and OptionMenu.	RowColumn uses
       the XmQTmenuSavvy trait and holds the XmQTmenuSystem trait.

       The type	of layout performed is controlled by how the  application  has
       set  the	various	layout resources.  It can be configured	to lay out its
       children	in either rows or columns. In addition,	 the  application  can
       specify how the children	are laid out, as follows:

	  o  The children are packed tightly together into either rows or col-
	     umns

	  o  Each child	is placed in an	identically  sized  box	 (producing  a
	     symmetrical look)

	  o  A	specific layout	(the current x and y positions of the children
	     control their location)

       In addition, the	application has	control	over both the spacing that oc-
       curs between each row and column	and the	margin spacing present between
       the edges of the	RowColumn widget and  any  children  that  are	placed
       against it.

       The  default  XmNinsertPosition procedure for the RowColumn returns the
       value of	XmNpositionIndex if one	has been specified for the child. Oth-
       erwise,	this  procedure	 returns the number of children	in the RowCol-
       umn's XmNnumChildren list.  In a	MenuBar, Pulldown menu pane, or	 Popup
       menu  pane the default for the XmNshadowThickness resource is 2.	 In an
       OptionMenu or a WorkArea, (such as a RadioBox  or  CheckBox)  this  re-
       source  is  not applicable and its use is undefined.  If	an application
       wishes to place a 3-D shadow around an OptionMenu or WorkArea,  it  can
       create the RowColumn as a child of a Frame widget.

       In a MenuBar, Pulldown menu pane, or Popup menu pane the	XmNnavigation-
       Type resource is	not  applicable	 and  its  use	is  undefined.	 In  a
       WorkArea,  the default for XmNnavigationType is XmTAB_GROUP.  In	an Op-
       tionMenu	the default for	XmNnavigationType is XmNONE.

       In a MenuBar, Pulldown menu pane, or Popup menu pane the	XmNtraversalOn
       resource	 is not	applicable and its use is undefined.  In an OptionMenu
       or WorkArea, the	default	for XmNtraversalOn is True.

       If the parent of	the RowColumn is a MenuShell, the XmNmappedWhenManaged
       resource	is forced to False when	the widget is realized.

       The user	can specify resources in a resource file for the automatically
       created widgets and gadgets of an OptionMenu. The following list	 iden-
       tifies  the  names of these widgets (or gadgets)	and the	associated Op-
       tionMenu	areas.

       Option Menu Label Gadget
		 OptionLabel

       Option Menu Cascade Button
		 OptionButton

       For the Popup and Pulldown Menupanes, popup  and	 pulldown  menus  have
       particular  behaviors  when  the	 <Btn1>	 button	is pressed outside the
       menus. These behaviors are summarized here.

       When there is already a popped up menu, a user can either press	<Btn1>
       in  the same area as the	popped up menu,	or can press <Btn1> in another
       area that should	have a menu popped up. When <Btn1> is pressed  in  the
       same  area  as  the  already popped up menu, that menu is unposted.  If
       <Btn1> is pressed in a different	area, the  associated  popup  menu  is
       posted  for  the	 new area. Note, however, that if the XmNpopupHandler-
       Callback	of either XmManager or	XmPrimitive  is	 available,  then  the
       callback	may override these default behaviors.

       For  pulldown  menus,  a	user can press <Btn1> on the Cascade button to
       post the	pulldown menu, then click on it	again. Upon the	second	click,
       the pulldown menu is unposted.

       Popup menus are not allowed to have NULL	parents.

   Tear-off Menus
       Pulldown	 and Popup menu	panes support tear-off menus, which enable the
       user to retain a	menu pane on the display to facilitate subsequent menu
       selections.  A  menu pane that can be torn-off is identified by a tear-
       off button that spans the width of the menu pane	and displays a	dashed
       line.  A	 torn-off menu pane contains a window manager system menu icon
       and a title bar.	The window title displays the  label  of  the  cascade
       button  that  initiated	the action when	the label type is XmSTRING. If
       the label contains a pixmap the window title is empty. A	tear-off  menu
       from  a	Popup  menu pane also displays an empty	title.	Tear-off menus
       should not be shared.

       The user	can tear off a menu pane using the mouse or keyboard.	Click-
       ing  <Btn1>  or pressing	<osfActivate> (or <osfSelect>) on the tear-off
       button, tears off the menu  pane	 at  the  current  position.  Pressing
       <Btn2>  on  the	tear-off button	tears off the menu pane	and allows the
       user to drag the	torn-off menu to a new position	designated by  releas-
       ing  the	 mouse button. Tearing off a menu pane unposts the current ac-
       tive menu. Only one tear-off copy for each menu pane is allowed.	Subse-
       quent  tear-off	actions	 of  a torn menu pane unpost the existing copy
       first.

       The name	of the tear-off	button of a torn-off menu pane is  TearOffCon-
       trol.  The name can be used to set resources in a resource file.	An ap-
       plication can also obtain the tear-off button itself using XmGetTearOf-
       fControl	and then set resource values by	calling	XtSetValues.

       The  tear-off button has	Separator-like behavior. Its appearance	can be
       specified with the following tear-off button resources:	XmNbackground,
       XmNbackgroundPixmap,  XmNbottomShadowColor,  XmNforeground,  XmNheight,
       XmNmargin, XmNseparatorType, XmNshadowThickness,	and XmNtopShadowColor.
       Refer  to  the XmSeparator reference page for a complete	description of
       each of these resources.

       The XmNtearOffModel,  XmNtearOffMenuActivateCallback,  and  XmNtearOff-
       MenuDeactivateCallback  are  RowColumn  resources  that affect tear-off
       menu behavior.  The XmNtearOffTitle resource enables the	application to
       specify the tear-off menu's title if the	menu is	torn off.

       By default, menus do not	tear off. Setting the XmNtearOffModel resource
       to XmTEAR_OFF_ENABLED enables tear-off functionality.  There is no  re-
       source  converter  preregistered	for XmNtearOffModel. To	allow tear-off
       functionality to	be enabled through the	resource  database,  call  the
       function	XmRepTypeInstallTearOffModelConverter.

       Tear-off	 menu  focus policy follows standard window manager policy. It
       is recommended that the startupKeyFocus and autoKeyFocus	mwm  resources
       be set to True.

   Descendants
       RowColumn  automatically	creates	the descendants	shown in the following
       table.  An application can use XtNameToWidget to	 gain  access  to  the
       named  descendant.  In  addition,  a user or an application can use the
       named descendant	when specifying	resource values.

       +-----------------+-------------------------+---------------------+
       |Named Descendant | Class		   | Identity		 |
       +-----------------+-------------------------+---------------------+
       +-----------------+-------------------------+---------------------+
       +-----------------+-------------------------+---------------------+
       |OptionButton	 | XmCascadeButtonGadget   | option menu button	 |
       +-----------------+-------------------------+---------------------+
       |OptionLabel	 | XmLabelGadget	   | option menu label	 |
       +-----------------+-------------------------+---------------------+
       |TearOffControl	 | subclass of XmPrimitive | tear-off button  of |
       |		 |			   | torn-off menu pane	 |
       +-----------------+-------------------------+---------------------+
       +-----------------+-------------------------+---------------------+
   Classes
       RowColumn  inherits  behavior, resources, and traits from Core, Compos-
       ite, Constraint,	and XmManager classes.

       The class pointer is xmRowColumnWidgetClass.

       The class name is XmRowColumn.

   New Resources
       The following table defines a set of widget resources used by the  pro-
       grammer	to specify data. The programmer	can also set the resource val-
       ues for the inherited classes to	set attributes	for  this  widget.  To
       reference  a  resource by name or by class in a .Xdefaults file,	remove
       the XmN or XmC prefix and use the remaining letters. To specify one  of
       the  defined  values for	a resource in a	.Xdefaults file, remove	the Xm
       prefix and use the remaining letters (in	either lowercase or uppercase,
       but  include  any  underscores between words).  The codes in the	access
       column indicate if the given resource can be set	at creation time  (C),
       set by using XtSetValues	(S), retrieved by using	XtGetValues (G), or is
       not applicable (N/A).

       +-----------------------------------------------------------------------------------------------------------+
       |				 |	 XmRowColumn Resource Set	 |			  |	   |
       |Name				 | Class		| Type		 | Default		  | Access |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNadjustLast			 | XmCAdjustLast	| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNadjustMargin			 | XmCAdjustMargin	| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNentryAlignment		 | XmCAlignment		| unsigned char	 | XmALIGNMENT_BEGINNING  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNentryBorder			 | XmCEntryBorder	| Dimension	 | 0			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNentryCallback		 | XmCCallback		| XtCallbackList | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNentryClass			 | XmCEntryClass	| WidgetClass	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNentryVerticalAlignment	 | XmCVerticalAlignment	| unsigned char	 | XmALIGNMENT_CENTER	  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNisAligned			 | XmCIsAligned		| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNisHomogeneous		 | XmCIsHomogeneous	| Boolean	 | dynamic		  | CG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNlabelString			 | XmCXmString		| XmString	 | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmapCallback			 | XmCCallback		| XtCallbackList | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmarginHeight			 | XmCMarginHeight	| Dimension	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmarginWidth			 | XmCMarginWidth	| Dimension	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmenuAccelerator		 | XmCAccelerators	| String	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmenuHelpWidget		 | XmCMenuWidget	| Widget	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmenuHistory			 | XmCMenuWidget	| Widget	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmenuPost			 | XmCMenuPost		| String	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmnemonic			 | XmCMnemonic		| KeySym	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNmnemonicCharSet		 | XmCMnemonicCharSet	| String	 | XmFONTLIST_DEFAULT_TAG | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNnumColumns			 | XmCNumColumns	| short		 | 1			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNorientation			 | XmCOrientation	| unsigned char	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNpacking			 | XmCPacking		| unsigned char	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNpopupEnabled			 | XmCPopupEnabled	| int		 | XmPOPUP_KEYBOARD	  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNradioAlwaysOne		 | XmCRadioAlwaysOne	| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNradioBehavior		 | XmCRadioBehavior	| Boolean	 | False		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNresizeHeight			 | XmCResizeHeight	| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNresizeWidth			 | XmCResizeWidth	| Boolean	 | True			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNrowColumnType		 | XmCRowColumnType	| unsigned char	 | XmWORK_AREA		  | CG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNspacing			 | XmCSpacing		| Dimension	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNsubMenuId			 | XmCMenuWidget	| Widget	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNtearOffMenuActivateCallback	 | XmCCallback		| XtCallbackList | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNtearOffMenuDeactivateCallback | XmCCallback		| XtCallbackList | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNtearOffModel			 | XmCTearOffModel	| unsigned char	 | XmTEAR_OFF_DISABLED	  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNtearOffTitle			 | XmCTearOffTitle	| XmString	 | NULL			  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNunmapCallback		 | XmCCallback		| XtCallbackList | NULL			  | C	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       |XmNwhichButton			 | XmCWhichButton	| unsigned int	 | dynamic		  | CSG	   |
       +---------------------------------+----------------------+----------------+------------------------+--------+
       +---------------------------------+----------------------+----------------+------------------------+--------+
       XmNadjustLast
		 Extends the last row of children to the bottom	edge  of  Row-
		 Column	 (when	XmNorientation is XmHORIZONTAL)	or extends the
		 last column to	the right edge of RowColumn (when  XmNorienta-
		 tion is XmVERTICAL).  Setting XmNadjustLast to	False disables
		 this feature.

       XmNadjustMargin
		 Specifies whether the inner minor margins of all  items  con-
		 tained	 within	 the  RowColumn	 widget	are forced to the same
		 value.	The inner minor	margin corresponds to  the  XmNmargin-
		 Left,	XmNmarginRight,	 XmNmarginTop, and XmNmarginBottom re-
		 sources supported by XmLabel and XmLabelGadget.

		 A horizontal orientation causes XmNmarginTop  and  XmNmargin-
		 Bottom	 for all items in a particular row to be forced	to the
		 same value; the value is the largest margin specified for one
		 of the	Label items.

		 A  vertical  orientation  causes XmNmarginLeft	and XmNmargin-
		 Right for all items in	a particular column to	be  forced  to
		 the same value; the value is the largest margin specified for
		 one of	the Label items.

		 This keeps all	text within each row or	column lined  up  with
		 all  other text in its	row or column.	If XmNrowColumnType is
		 either	XmMENU_POPUP or	XmMENU_PULLDOWN	and this  resource  is
		 True, only button children have their margins adjusted.

       XmNentryAlignment
		 Specifies the alignment type for children that	are subclasses
		 of XmLabel or XmLabelGadget  when  XmNisAligned  is  enabled.
		 The following are textual alignment types:

		    o  XmALIGNMENT_BEGINNING (default)

		    o  XmALIGNMENT_CENTER

		    o  XmALIGNMENT_END

		 See  the description of XmNalignment in the XmLabel(3)	refer-
		 ence page for an explanation of these actions.

       XmNentryBorder
		 Imposes a uniform border width	upon all RowColumn's children.
		 The default value is 0	(zero),	which disables the feature.

       XmNentryCallback
		 Disables  the XmNactivateCallback and XmNvalueChangedCallback
		 callbacks for all CascadeButton, DrawnButton, PushButton, and
		 ToggleButton widgets and gadgets contained within the RowCol-
		 umn widget.  If the application supplies this	resource,  the
		 XmNactivateCallback and XmNvalueChangedCallback callbacks are
		 then revectored to the	XmNentryCallback callbacks.  This  al-
		 lows  an  application to supply a single callback routine for
		 handling all items contained  in  a  RowColumn	 widget.   The
		 callback  reason  is  XmCR_ACTIVATE.  If the application does
		 not supply this resource, the XmNactivateCallback and XmNval-
		 ueChangedCallback  callbacks  for  each item in the RowColumn
		 widget	work as	normal.

		 The application must supply this resource when	this widget is
		 created.  Changing this resource using	the XtSetValues	is not
		 supported.

       XmNentryClass
		 Specifies the only widget class that can be added to the Row-
		 Column	 widget; this resource is meaningful only when the Xm-
		 NisHomogeneous	resource is set	to True.  Both widget and gad-
		 get  variants of the specified	class may be added to the wid-
		 get.

		 When XmCreateRadioBox is called or when  XmNrowColumnType  is
		 set  to XmWORK_AREA and XmNradioBehavior is True, the default
		 value of XmNentryClass	 is  xmToggleButtonGadgetClass.	  When
		 XmNrowColumnType  is  set  to XmMENU_BAR, the value of	XmNen-
		 tryClass is forced to xmCascadeButtonWidgetClass.

       XmNentryVerticalAlignment
		 Specifies the type of vertical	alignment  for	children  that
		 are  subclasses  of XmLabel, XmLabelGadget, and XmText.  This
		 resource is invalid if	XmNorientation is XmVERTICAL and  XmN-
		 packing  is XmPACK_TIGHT, because this	layout preserves vari-
		 able heights among the	children. The vertical alignment types
		 include:

		 XmALIGNMENT_BASELINE_BOTTOM
			   Causes the bottom baseline of all children in a row
			   to be aligned.  This	resource  is  applicable  only
			   when	all children in	a row contain textual data.

		 XmALIGNMENT_BASELINE_TOP
			   Causes the top baseline of all children in a	row to
			   be aligned.	This resource is applicable only  when
			   all children	in a row contain textual data.

		 XmALIGNMENT_CONTENTS_BOTTOM
			   Causes  the bottom of the contents (text or pixmap)
			   of all children in a	row to be aligned.

		 XmALIGNMENT_CENTER
			   Causes the center of	all children in	a  row	to  be
			   aligned.

		 XmALIGNMENT_CONTENTS_TOP
			   Causes  the top of the contents (text or pixmap) of
			   all children	in a row to be aligned.

       XmNisAligned
		 Specifies text	alignment for each item	within	the  RowColumn
		 widget; this applies only to items that are subclasses	of Xm-
		 Label or XmLabelGadget.  However, if the item is a Label wid-
		 get or	gadget and its parent is either	a Popup	menu pane or a
		 Pulldown menu pane, alignment is not performed; the Label  is
		 treated  as the title within the menu pane, and the alignment
		 set by	the application	is not overridden.   XmNentryAlignment
		 controls the type of textual alignment.

       XmNisHomogeneous
		 Indicates  whether  the RowColumn widget should enforce exact
		 homogeneity among the items it	contains; if this resource  is
		 set to	True, only the widgets that are	of the class indicated
		 by XmNentryClass are allowed as  children  of	the  RowColumn
		 widget.   This	 is  most  often used when creating a MenuBar.
		 Attempting to insert a	child that is  not  a  member  of  the
		 specified class generates a warning message.

		 In  a	MenuBar,  the  value  of XmNisHomogeneous is forced to
		 True.	In an OptionMenu, the value is forced to False.	  When
		 XmCreateRadioBox is called the	default	value is True.	Other-
		 wise, the default value is False.

       XmNlabelString
		 When XmNrowColumnType is set to XmMENU_OPTION,	this  resource
		 points	 to a text string that displays	the label with respect
		 to the	selection area.	The positioning	of the label  relative
		 to  the selection area	depends	on the layout direction	in the
		 horizontal orientation.  This resource	is not meaningful  for
		 all  other  RowColumn	types.	 If  the application wishes to
		 change	the label after	creation, it must get the  LabelGadget
		 ID  (XmOptionLabelGadget)  and	call XtSetValues on the	Label-
		 Gadget	directly. The default value is no label.

       XmNmapCallback
		 Specifies a widget-specific callback function that is invoked
		 when the window associated with the RowColumn widget is about
		 to be mapped. The callback reason is XmCR_MAP.

       XmNmarginHeight
		 Specifies the amount of blank space between the top  edge  of
		 the  RowColumn	 widget	and the	first item in each column, and
		 the bottom edge of the	RowColumn widget and the last item  in
		 each  column.	The default value is 0 (zero) for Pulldown and
		 Popup menu panes, and 3 pixels	for other RowColumn types.

       XmNmarginWidth
		 Specifies the amount of blank space between the left edge  of
		 the  RowColumn	widget and the first item in each row, and the
		 right edge of the RowColumn widget and	the last item in  each
		 row.	The  default  value is 0 (zero)	for Pulldown and Popup
		 menu panes, and 3 pixels for other RowColumn types.

       XmNmenuAccelerator
		 This resource is useful only when the	RowColumn  widget  has
		 been configured to operate as a Popup menu pane or a MenuBar.
		 The format of this resource is	similar	to the left side spec-
		 ification  of	a translation string, with the limitation that
		 it must specify a key event.  For a Popup menu	pane, when the
		 accelerator  is  typed	 by  the  user,	the Popup menu pane is
		 posted.  For a	MenuBar, when the accelerator is typed by  the
		 user,	the first item in the MenuBar is highlighted, and tra-
		 versal	is enabled in the MenuBar.  The	default	 for  a	 Popup
		 menu  pane  is	<osfMenu>.  The	default	for a MenuBar is <osf-
		 MenuBar>.  Setting the	XmNpopupEnabled	resource to False dis-
		 ables the accelerator.

       XmNmenuHelpWidget
		 Specifies  the	 widget	 ID  for  the  CascadeButton, which is
		 treated as the	Help widget if XmNrowColumnType	is set to  Xm-
		 MENU_BAR.   Which  corner  of	the MenuBar the	Help widget is
		 placed	at depends on the XmNlayoutDirection resource  of  the
		 widget.   If  the RowColumn widget is any type	other than Xm-
		 MENU_BAR, this	resource is not	meaningful.

       XmNmenuHistory
		 Specifies the widget ID of the	last menu entry	 to  be	 acti-
		 vated.	It is also useful for specifying the current selection
		 for an	OptionMenu. If XmNrowColumnType	is set	to  XmMENU_OP-
		 TION,	the specified menu item	is positioned under the	cursor
		 when the menu is displayed.

		 If the	RowColumn widget has the XmNradioBehavior resource set
		 to  True, the widget field associated with this resource con-
		 tains the widget ID of	the last ToggleButton or ToggleButton-
		 Gadget	 to  change  from unselected to	selected.  The default
		 value is the widget ID	of the first child in the widget.

       XmNmenuPost
		 Specifies an X	event description indicating  a	 button	 event
		 that  posts  a	 menu system.  The default for XmMENU_POPUP is
		 BMenu Press.  The default for XmMENU_OPTION, XmMENU_BAR,  and
		 XmWORK_AREA  is  <Btn1>  Press.  The XmNmenuPost resource for
		 pulldowns should be consistent	with  that  of	the  top-level
		 parent	 menu  (although  the event type is ignored).  Setting
		 this resource to BTransfer Press will conflict	with drag  and
		 drop  operations, which use BTransfer Press as	a default but-
		 ton binding.  Therefore, this resource	 cannot	 be  BTransfer
		 Press.

       XmNmnemonic
		 This  resource	is useful only when XmNrowColumnType is	set to
		 XmMENU_OPTION.	 It specifies a	keysym for a  key  that,  when
		 pressed  by  the user along with the MAlt modifier, posts the
		 associated Pulldown menu pane.	 The first  character  in  the
		 OptionMenu  label string that exactly matches the mnemonic in
		 the character set specified in	XmNmnemonicCharSet  is	under-
		 lined.	  The  user  can  post the menu	by pressing either the
		 shifted or the	unshifted mnemonic key.	  The  default	is  no
		 mnemonic.

       XmNmnemonicCharSet
		 Specifies  the	 character  set	of the mnemonic	for an Option-
		 Menu.	The default is XmFONTLIST_DEFAULT_TAG.	If the RowCol-
		 umn  widget  is  any  type other than XmMENU_OPTION, this re-
		 source	is not meaningful.

       XmNnumColumns
		 Specifies the number of minor dimension extensions  that  are
		 made to accommodate the entries; this attribute is meaningful
		 only when XmNpacking is set to	XmPACK_COLUMN.

		 For vertically	oriented RowColumn widgets, this attribute in-
		 dicates how many columns are built; the number	of entries per
		 column	is adjusted to maintain	this  number  of  columns,  if
		 possible.

		 For  horizontally  oriented RowColumn widgets,	this attribute
		 indicates how many rows are built.

		 The default value is 1.  In an	OptionMenu the value is	forced
		 to 1.	The value must be greater than 0 (zero).

       XmNorientation
		 Determines whether RowColumn layouts are row-major or column-
		 major.	 In a column-major layout, the children	of the RowCol-
		 umn are laid out in columns within the	widget.	In a row-major
		 layout	the children of	the RowColumn are laid	out  in	 rows.
		 The  direction	of the horizontal layout in the	row-major lay-
		 out (from left	or right), and the wrapping in the  column-ma-
		 jor  layout  (vertical), depend on the	XmNlayoutDirection re-
		 source	of the widget.	The XmVERTICAL resource	value  selects
		 a column-major	layout.	 XmHORIZONTAL selects a	row-major lay-
		 out.

		 When creating a MenuBar or  an	 OptionMenu,  the  default  is
		 XmHORIZONTAL.	 Otherwise,  the  default value	is XmVERTICAL.
		 The results of	specifying a value of XmVERTICAL for a MenuBar
		 are undefined.

       XmNpacking
		 Specifies  how	to pack	the items contained within a RowColumn
		 widget. This can be set to XmPACK_TIGHT, XmPACK_COLUMN	or Xm-
		 PACK_NONE.  When  a  RowColumn	widget packs the items it con-
		 tains,	it determines its major	dimension using	the  value  of
		 the XmNorientation resource.

		 XmPACK_TIGHT indicates	that given the current major dimension
		 (for example, vertical	if XmNorientation is XmVERTICAL),  en-
		 tries are placed one after the	other until the	RowColumn wid-
		 get must wrap.	RowColumn wraps	when there is no room left for
		 a  complete  child in that dimension.	Wrapping occurs	by be-
		 ginning a new row or column  in  the  next  available	space.
		 Wrapping  continues,  as often	as necessary, until all	of the
		 children are laid out.	 In the	vertical dimension  (columns),
		 boxes	are set	to the same width; in the horizontal dimension
		 (rows), boxes are set to the same depth.  Each	entry's	 posi-
		 tion  in  the major dimension is left unaltered (for example,
		 XmNy is left unchanged	when  XmNorientation  is  XmVERTICAL);
		 its  position in the minor dimension is set to	the same value
		 as the	greatest entry in that particular row or  column.  The
		 position in the minor dimension of any	particular row or col-
		 umn is	independent of all other rows or columns.

		 XmPACK_COLUMN indicates that all entries are placed in	 iden-
		 tically  sized	 boxes.	 The  boxes  are  based	on the largest
		 height	and width values of all	 the  children	widgets.   The
		 value of the XmNnumColumns resource determines	how many boxes
		 are placed in the major dimension, before  extending  in  the
		 minor dimension.

		 XmPACK_NONE  indicates	 that  no packing is performed.	 The x
		 and y attributes of each entry	are left alone,	and  the  Row-
		 Column	 widget	attempts to become large enough	to enclose all
		 entries.

		 When XmCreateRadioBox is called or when  XmNrowColumnType  is
		 set  to XmWORK_AREA and XmNradioBehavior is True, the default
		 value of XmNpacking is	XmPACK_COLUMN.	In an  OptionMenu  the
		 value	is  initialized	to XmPACK_TIGHT.  Otherwise, the value
		 defaults to XmPACK_TIGHT.

       XmNpopupEnabled
		 Allows	the menu system	to enable keyboard input (accelerators
		 and mnemonics)	defined	for the	Popup menu pane	and any	of its
		 submenus.  The	Popup menu pane	needs to be informed  whenever
		 its  accessibility to the user	changes	because	posting	of the
		 Popup menu pane is controlled by the application.   This  re-
		 source	can take four values, including:

		 XmPOPUP_KEYBOARD
			   Specifies that the keyboard input--accelerators and
			   mnemonics--defined for the Popup menu pane and  any
			   of its submenus is enabled. This is the default.

		 XmPOPUP_DISABLED
			   Specifies that the keyboard input is	disabled.

		 XmPOPUP_AUTOMATIC
			   Specifies  that  the	 keyboard is enabled for auto-
			   matic popup menus.

		 XmPOPUP_AUTOMATIC_RECURSIVE
			   Specifies that the keyboard is enabled  for	recur-
			   sive	automatic popup	menus.

       XmNradioAlwaysOne
		 If True, forces the active ToggleButton or ToggleButtonGadget
		 to be automatically selected after having been	unselected (if
		 no  other toggle was activated).  If False, the active	toggle
		 may be	unselected.  The default value is True.	This  resource
		 is important only when	XmNradioBehavior is True.

		 The application can always add	and subtract toggles from Row-
		 Column	regardless of the  selected/unselected	state  of  the
		 toggle.  The  application can also manage and unmanage	toggle
		 children of RowColumn at any time regardless of state.	There-
		 fore,	the  application can sometimes create a	RowColumn that
		 has XmNradioAlwaysOne set to True  and	 none  of  the	toggle
		 children  selected.   The result is undefined if the value of
		 this resource is True and the application sets	more than  one
		 ToggleButton at a time.

       XmNradioBehavior
		 Specifies  a Boolean value that when True, indicates that the
		 RowColumn widget should enforce a RadioBox-type  behavior  on
		 all  of  its children that are	ToggleButtons or ToggleButton-
		 Gadgets.

		 When the value	of this	resource is True, XmNindicatorType de-
		 faults	to XmONE_OF_MANY for ToggleButton and ToggleButtonGad-
		 get children.

		 RadioBox behavior dictates that when one toggle  is  selected
		 and the user selects another toggle, the first	toggle is uns-
		 elected automatically.	 The RowColumn usually	does  not  en-
		 force this behavior if	the application, rather	than the user,
		 changes the state of a	toggle.	 The  RowColumn	 does  enforce
		 this behavior if a toggle child is selected with XmToggleBut-
		 tonSetState or	XmToggleButtonGadgetSetState with a notify ar-
		 gument	of True.

		 When  XmCreateRadioBox	is called, the default value of	XmNra-
		 dioBehavior is	True.  Otherwise, the default value is False.

       XmNresizeHeight
		 Requests a new	height if necessary, when set  to  True.  When
		 this  resource	is set to False, the widget does not request a
		 new height regardless of any changes to  the  widget  or  its
		 children.

       XmNresizeWidth
		 Requests a new	width if necessary, when set to	True. When set
		 to False, the widget does not request a new width  regardless
		 of any	changes	to the widget or its children.

       XmNrowColumnType
		 Specifies  the	type of	RowColumn widget to be created.	 It is
		 a nonstandard resource	that cannot be	changed	 after	it  is
		 set.  If an application uses any of the convenience routines,
		 except	 XmCreateRowColumn,  this  resource  is	 automatically
		 forced	 to  the appropriate value by the convenience routine.
		 If an application uses	the Xt Intrinsics API  to  create  its
		 RowColumn  widgets, it	must specify this resource itself. The
		 set of	possible settings for this resource are

		    o  XmWORK_AREA (default)

		    o  XmMENU_BAR

		    o  XmMENU_PULLDOWN

		    o  XmMENU_POPUP

		    o  XmMENU_OPTION

		 This resource cannot be changed after the RowColumn widget is
		 created.  Any	changes	 attempted through XtSetValues are ig-
		 nored.

		 The value of this resource is used to determine the value  of
		 a  number  of	other resources. The descriptions of RowColumn
		 resources explain this	when it	is the case. The resource XmN-
		 navigationType,  inherited  from XmManager, is	changed	to Xm-
		 NONE if XmNrowColumnType is XmMENU_OPTION.

       XmNspacing
		 Specifies the horizontal and vertical spacing	between	 items
		 contained  within the RowColumn widget.  The default value is
		 3 pixels for XmOPTION_MENU and	XmWORK_AREA and	0  (zero)  for
		 other RowColumn types.

       XmNsubMenuId
		 Specifies  the	widget ID for the Pulldown menu	pane to	be as-
		 sociated with an OptionMenu. This  resource  is  useful  only
		 when  XmNrowColumnType	 is set	to XmMENU_OPTION.  The default
		 value is NULL.

       XmNtearOffMenuActivateCallback
		 Specifies the callback	list  that  notifies  the  application
		 when the tear-off menu	pane is	about to be activated. It pre-
		 cedes the tear-off's map callback.

		 Use this resource when	your application has shared menu panes
		 and  when the torn-off	menu can have two or more parents that
		 can have opposing sensitivity states for the same menu	 item.
		 This resource enables the application to track	whether	a menu
		 item is sensitive or insensitive and to set the state to  the
		 original  parent's  menu item state when the torn-off menu is
		 reposted.  The	application can	use  XmGetPostedFromWidget  to
		 determine  from  which	parent the menu	was torn. The callback
		 reason	is XmCR_TEAR_OFF_ACTIVATE.  The	default	is NULL.

       XmNtearOffMenuDeactivateCallback
		 Specifies the callback	list  that  notifies  the  application
		 when  the  tear-off  menu pane	is about to be deactivated. It
		 follows the tear-off's	unmap callback.

		 Use this resource when	your application has shared menu panes
		 and  when the torn-off	menu can have two or more parents that
		 can have opposing sensitivity states for the same menu	 item.
		 This resource enables the application to track	whether	a menu
		 item is sensitive or insensitive and to set the state to  the
		 original  parent's  menu item state when the torn-off menu is
		 reposted.  The	application can	use  XmGetPostedFromWidget  to
		 determine  from which parent the menu was torn.  The callback
		 reason	is XmCR_TEAR_OFF_DEACTIVATE. The default is NULL.

       XmNtearOffModel
		 Indicates whether tear-off functionality is enabled  or  dis-
		 abled	when XmNrowColumnType is set to	XmMENU_PULLDOWN	or Xm-
		 MENU_POPUP.   The   values    are    XmTEAR_OFF_ENABLED    or
		 XmTEAR_OFF_DISABLED (default value). This resource is invalid
		 for type XmMENU_OPTION; however, it does affect any  pulldown
		 submenus  within  an  OptionMenu.   The function XmRepTypeIn-
		 stallTearOffModelConverter installs a resource	converter  for
		 this resource.

       XmNtearoffTitle
		 Used  by  the	TearOff	 shell to set the title	for the	window
		 manager to display.

       XmNunmapCallback
		 Specifies a list of callbacks that is called after the	window
		 associated  with  the RowColumn widget	has been unmapped. The
		 callback reason is XmCR_UNMAP.	 The default value is NULL.

       XmNwhichButton
		 This resource is obsolete; it has been	replaced  by  XmNmenu-
		 Post  and is present for compatibility	with older releases of
		 Motif.	 This resource cannot be 2.

       +-----------------------------------------------------------------------+
       |		 XmRowColumn Constraint	Resource Set	      |	       |
       |Name		 | Class	    | Type  | Default	      |	Access |
       +-----------------+------------------+-------+-----------------+--------+
       |XmNpositionIndex | XmCPositionIndex | short | XmLAST_POSITION |	CSG    |
       +-----------------+------------------+-------+-----------------+--------+
       +-----------------+------------------+-------+-----------------+--------+
       XmNpositionIndex
		 Specifies the position	of the widget in its parent's list  of
		 children  (the	 value of the XmNchildren resource). The value
		 is an integer that is no less than 0 (zero)  and  no  greater
		 than the number of children in	the list at the	time the value
		 is specified. A value of 0 (zero) means  that	the  child  is
		 placed	 at  the  beginning of the list. The value can also be
		 specified as XmLAST_POSITION (the default), which means  that
		 the  child  is	placed at the end of the list. Any other value
		 is ignored.  XtGetValues returns the position of  the	widget
		 in  its parent's child	list at	the time of the	call to	XtGet-
		 Values.

		 When a	widget is inserted into	its parent's child  list,  the
		 positions  of	any existing children that are greater than or
		 equal to the  specified  widget's  XmNpositionIndex  are  in-
		 creased by 1.	The effect of a	call to	XtSetValues for	XmNpo-
		 sitionIndex is	to remove the specified	widget from  its  par-
		 ent's child list, decrease by 1 the positions of any existing
		 children that are greater than	the specified widget's	former
		 position  in  the  list, and then insert the specified	widget
		 into its parent's child list as described  in	the  preceding
		 sentence.

       +------------------------------------------------------------------------------------------------+
       |			  |    Simple Menu Creation Resource Set	     |	       |	|
       |Name			  | Class		      |	Type		     | Default | Access	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonAccelerators	  | XmCButtonAccelerators     |	StringTable	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonAcceleratorText  | XmCButtonAcceleratorText  |	XmStringTable	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonCount		  | XmCButtonCount	      |	int		     | 0       | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonMnemonicCharSets | XmCButtonMnemonicCharSets |	XmStringCharSetTable | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonMnemonics	  | XmCButtonMnemonics	      |	XmKeySymTable	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttons		  | XmCButtons		      |	XmStringTable	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonSet		  | XmCButtonSet	      |	int		     | -1      | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNbuttonType		  | XmCButtonType	      |	XmButtonTypeTable    | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNoptionLabel		  | XmCOptionLabel	      |	XmString	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNoptionMnemonic	  | XmCOptionMnemonic	      |	KeySym		     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNpostFromButton	  | XmCPostFromButton	      |	int		     | -1      | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       |XmNsimpleCallback	  | XmCCallback		      |	XtCallbackProc	     | NULL    | C	|
       +--------------------------+---------------------------+----------------------+---------+--------+
       +--------------------------+---------------------------+----------------------+---------+--------+
       XmNbuttonAccelerators
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	list of	accelerators for  the  buttons
		 created.  The list contains one element for each button, sep-
		 arator, and title created.

       XmNbuttonAcceleratorText
		 This resource is for use with the simple menu	creation  rou-
		 tines.	  It  specifies	 a list	of compound strings to display
		 for the accelerators for the buttons created.	The list  con-
		 tains	one element for	each button, separator,	and title cre-
		 ated.

       XmNbuttonCount
		 This resource is for use with the simple menu	creation  rou-
		 tines.	  It specifies the total number	of menu	buttons, sepa-
		 rators, and titles to create.	The value must	not  be	 nega-
		 tive.

       XmNbuttonMnemonicCharSets
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	list of	character sets with which but-
		 ton mnemonics are to be displayed.  The list contains one el-
		 ement for each	button,	separator, and title created.  The de-
		 fault	is  determined	dynamically depending on the locale of
		 the widget.

       XmNbuttonMnemonics
		 This resource is for use with the simple menu	creation  rou-
		 tines.	 It specifies a	list of	mnemonics for the buttons cre-
		 ated.	The list contains one element for each button, separa-
		 tor, and title	created.

       XmNbuttons
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	list of	compound strings to use	as la-
		 bels  for the buttons created.	 The list contains one element
		 for each button, separator, and title created.

       XmNbuttonSet
		 This resource is for use with the simple menu	creation  rou-
		 tines.	 It specifies which button of a	RadioBox or OptionMenu
		 Pulldown submenu is initially set.  The value is an integer n
		 indicating  the  nth  ToggleButtonGadget  specified for a Ra-
		 dioBox	or the nth PushButtonGadget specified for  an  Option-
		 Menu  Pulldown	submenu.  The first button specified is	number
		 0.  The value must not	be negative.

       XmNbuttonType
		 This resource is for use with the simple menu	creation  rou-
		 tines.	  It  specifies	a list of button types associated with
		 the buttons to	be created.  The list contains one element for
		 each  button, separator, and title created.  If this resource
		 is not	specified, each	button in a MenuBar is	a  CascadeBut-
		 tonGadget, each button	in a RadioBox or CheckBox is a Toggle-
		 ButtonGadget, and each	button in any other type of  RowColumn
		 widget	 is  a	PushButtonGadget.  Each	button type is of type
		 XmButtonType, an enumeration with the following possible val-
		 ues:

		 XmCASCADEBUTTON
			   Specifies  a	 CascadeButtonGadget  for  a  MenuBar,
			   Popup menu pane, or Pulldown	menu pane.

		 XmCHECKBUTTON
			   Specifies  a	 ToggleButtonGadget  for  a  CheckBox,
			   Popup menu pane, or Pulldown	menu pane.

		 XmDOUBLE_SEPARATOR
			   Specifies  a	SeparatorGadget	for a Popup menu pane,
			   Pulldown menu pane, or OptionMenu Pulldown submenu.
			   The separator type is XmDOUBLE_LINE.

		 XmPUSHBUTTON
			   Specifies a PushButtonGadget	for a Popup menu pane,
			   Pulldown menu pane, or OptionMenu Pulldown submenu.

		 XmRADIOBUTTON
			   Specifies  a	 ToggleButtonGadget  for  a  RadioBox,
			   Popup menu pane, or Pulldown	menu pane.

		 XmSEPARATOR
			   Specifies  a	SeparatorGadget	for a Popup menu pane,
			   Pulldown menu pane, or OptionMenu Pulldown submenu.

		 XmTITLE   Specifies a LabelGadget used	as a title for a Popup
			   menu	pane or	Pulldown menu pane.

       XmNoptionLabel
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	compound string	for the	 label	string
		 to be used on the left	side of	an OptionMenu.

       XmNoptionMnemonic
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	keysym for a key that, when pressed by
		 the  user  along with the MAlt	modifier, posts	the associated
		 Pulldown menu pane for	an OptionMenu.

       XmNpostFromButton
		 This resource is for use with the simple menu	creation  rou-
		 tines.	  For a	Pulldown menu pane, it specifies the button in
		 the parent to which the submenu is  attached.	 The  menu  is
		 then  posted from this	button.	 The value is an integer n in-
		 dicating the nth CascadeButton	or CascadeButtonGadget	speci-
		 fied  for  the	 parent	 of the	Pulldown menu pane.  The first
		 button	specified is number 0.	The value must	not  be	 nega-
		 tive.

       XmNsimpleCallback
		 This  resource	 is for	use with the simple menu creation rou-
		 tines.	 It specifies a	callback procedure to be called	when a
		 button	is activated or	when its value changes.	 This callback
		 function is added to each button after	creation.  For a  Cas-
		 cadeButtonGadget or a PushButtonGadget, the callback is added
		 as the	button's XmNactivateCallback, and it  is  called  when
		 the button is activated.  For a ToggleButtonGadget, the call-
		 back is added as the button's XmNvalueChangedCallback,	and it
		 is called when	the button's value changes.  The button	number
		 is passed in the client_data field.

   Inherited Resources
       RowColumn inherits behavior and resources  from	the  superclasses  de-
       scribed	in  the	 following tables.  For	a complete description of each
       resource, refer to the reference	page for that superclass.

       +----------------------------------------------------------------------------------------------------+
       |			|	      XmManager	Resource Set	    |			   |	    |
       |Name			| Class			| Type		    | Default		   | Access |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNbottomShadowColor	| XmCBottomShadowColor	| Pixel		    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNbottomShadowPixmap	| XmCBottomShadowPixmap	| Pixmap	    | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNforeground		| XmCForeground		| Pixel		    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhelpCallback		| XmCCallback		| XtCallbackList    | NULL		   | C	    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhighlightColor	| XmCHighlightColor	| Pixel		    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhighlightPixmap	| XmCHighlightPixmap	| Pixmap	    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNinitialFocus		| XmCInitialFocus	| Widget	    | NULL		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNlayoutDirection	| XmCLayoutDirection	| XmDirection	    | dynamic		   | CG	    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNnavigationType	| XmCNavigationType	| XmNavigationType  | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNpopupHandlerCallback	| XmCCallback		| XtCallbackList    | NULL		   | C	    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNshadowThickness	| XmCShadowThickness	| Dimension	    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNstringDirection	| XmCStringDirection	| XmStringDirection | dynamic		   | CG	    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtopShadowColor	| XmCTopShadowColor	| Pixel		    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtopShadowPixmap	| XmCTopShadowPixmap	| Pixmap	    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtraversalOn		| XmCTraversalOn	| Boolean	    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNunitType		| XmCUnitType		| unsigned char	    | dynamic		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNuserData		| XmCUserData		| XtPointer	    | NULL		   | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       +------------------------+-----------------------+-------------------+----------------------+--------+
       +---------------------------------------------------------------------------------+
       |		  |	     Composite|Resource	Set |			|	 |
       |Name		  | Class	      |	Type	    | Default		| Access |
       +------------------+-------------------+-------------+-------------------+--------+
       |XmNchildren	  | XmCReadOnly	      |	WidgetList  | NULL		| G	 |
       +------------------+-------------------+-------------+-------------------+--------+
       |XmNinsertPosition | XmCInsertPosition |	XtOrderProc | default procedure	| CSG	 |
       +------------------+-------------------+-------------+-------------------+--------+
       |XmNnumChildren	  | XmCReadOnly	      |	Cardinal    | 0			| G	 |
       +------------------+-------------------+-------------+-------------------+--------+
       +------------------+-------------------+-------------+-------------------+--------+
       +---------------------------------------------------------------------------------------------------------------+
       |			      |		      Core Resource SetName			      |	Class			      |	Type	       | Default	      |	Access |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNaccelerators		      |	XmCAccelerators		      |	XtAccelerators | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNancestorSensitive	      |	XmCSensitive		      |	Boolean	       | dynamic	      |	G      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackground		      |	XmCBackground		      |	Pixel	       | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackgroundPixmap	      |	XmCPixmap		      |	Pixmap	       | XmUNSPECIFIED_PIXMAP |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderColor		      |	XmCBorderColor		      |	Pixel	       | XtDefaultForeground  |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderPixmap		      |	XmCPixmap		      |	Pixmap	       | XmUNSPECIFIED_PIXMAP |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderWidth		      |	XmCBorderWidth		      |	Dimension      | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNcolormap		      |	XmCColormap		      |	Colormap       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdepth		      |	XmCDepth		      |	int	       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdestroyCallback	      |	XmCCallback		      |	XtCallbackList | NULL		      |	C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNheight		      |	XmCHeight		      |	Dimension      | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNinitialResourcesPersistent |	XmCInitialResourcesPersistent |	Boolean	       | True		      |	C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNmappedWhenManaged	      |	XmCMappedWhenManaged	      |	Boolean	       | True		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNscreen		      |	XmCScreen		      |	Screen *       | dynamic	      |	CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNsensitive		      |	XmCSensitive		      |	Boolean	       | True		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNtranslations		      |	XmCTranslations		      |	XtTranslations | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNwidth		      |	XmCWidth		      |	Dimension      | dynamic	      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNx			      |	XmCPosition		      |	Position       | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNy			      |	XmCPosition		      |	Position       | 0		      |	CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       +------------------------------+-------------------------------+----------------+----------------------+--------+
   Callback Information
       A pointer to the	following structure is passed to each callback:

       typedef struct
       {
	       int reason;
	       XEvent *	event;
	       Widget widget;
	       char * data;
	       char * callbackstruct;
       } XmRowColumnCallbackStruct;

       reason	 Indicates why the callback was	invoked

       event	 Points	to the XEvent that triggered the callback

       The following fields apply only when the	callback reason	is  XmCR_ACTI-
       VATE;  for  all	other  callback	reasons, these fields are set to NULL.
       The XmCR_ACTIVATE callback reason is generated only when	 the  applica-
       tion  has  supplied  an	entry callback,	which overrides	any activation
       callbacks registered with the individual	RowColumn items.

       widget	 Is set	to the widget ID of the	RowColumn item that  has  been
		 activated

       data	 Contains  the	client-data  value supplied by the application
		 when the RowColumn item's activation callback was registered

       callbackstruct
		 Points	to the callback	structure generated by	the  RowColumn
		 item's	activation callback

   Translations
       XmRowColumn  translations  depend  on the value of the XmNrowColumnType
       resource.

       If XmNrowColumnType is set to XmWORK_AREA, XmRowColumn inherits	trans-
       lations from XmManager.

       If  XmNrowColumnType is set to XmMENU_OPTION, XmRowColumn inherits tra-
       versal, <osfActivate>, and <osfCancel> translations from	XmManager  and
       has the following additional translations.

       The following key names are listed in the X standard key	event transla-
       tion table syntax.  This	format is the one used by Motif	to specify the
       widget  actions	corresponding to a given key.  A brief overview	of the
       format is provided under	VirtualBindings(3).  For a  complete  descrip-
       tion  of	the format, please refer to the	X Toolkit Instrinsics Documen-
       tation.

       <Btn2Down>:
		 MenuGadgetDrag()

       c<Btn1Down>:
		 MenuGadgetTraverseCurrent()

       c<Btn1Up>:
		 MenuGadgetTraverseCurrentUp()

       ~c<BtnDown>:
		 MenuBtnDown()

       ~c<BtnUp>:
		 MenuBtnUp()

       :<Key><osfHelp>:
		 MenuHelp()

       The translations	for XmRowColumn	if  XmNrowColumnType  is  set  to  Xm-
       MENU_BAR	 XmMENU_PULLDOWN, or XmMENU_POPUP are described	in the follow-
       ing list.  In a Popup menu system, <Btn3> also performs the <Btn1>  ac-
       tions.

       :<Key><osfHelp>:
		 MenuHelp()

       :<Key><osfLeft>:
		 MenuGadgetTraverseLeft()

       :<Key><osfRight>:
		 MenuGadgetTraverseRight()

       :<Key><osfUp>:
		 MenuGadgetTraverseUp()

       :<Key><osfDown>:
		 MenuGadgetTraverseDown()

   Action Routines
       The XmRowColumn action routines are

       Help():	 Calls	the  callbacks	for  XmNhelpCallback  if any exist. If
		 there are no help callbacks  for  this	 widget,  this	action
		 calls	the  help  callbacks for the nearest ancestor that has
		 them.

       ManagerGadgetSelect():
		 When a	gadget child of	the menu has the  focus,  invokes  the
		 gadget	 child's  behavior  associated with <osfSelect>.  This
		 generally has the effect of unposting the menu	hierarchy  and
		 arming	and activating the gadget, except that,	for a Cascade-
		 ButtonGadget with a submenu, it posts the submenu.

       MenuBtnDown():
		 When a	gadget child of	the menu has focus, invokes the	gadget
		 child's  behavior associated with <Btn1Down>.	This generally
		 has the effect	of unposting any menus posted  by  the	parent
		 menu,	enabling  mouse	 traversal in the menu,	and arming the
		 gadget.  For a	CascadeButtonGadget with a  submenu,  it  also
		 posts the associated submenu.

       MenuBtnUp():
		 When a	gadget child of	the menu has focus, invokes the	gadget
		 child's behavior associated with  <Btn1Up>.   This  generally
		 has the effect	of unposting the menu hierarchy	and activating
		 the gadget, except that for a CascadeButtonGadget with	a sub-
		 menu,	it posts the submenu and enables keyboard traversal in
		 the menu.

       MenuGadgetEscape():
		 In a top-level	Pulldown MenuPane from a MenuBar, unposts  the
		 menu, disarms the MenuBar CascadeButton and the MenuBar, and,
		 when the shell's keyboard focus  policy  is  XmEXPLICIT,  re-
		 stores	keyboard focus to the widget that had the focus	before
		 the MenuBar was entered.  In other  Pulldown  MenuPanes,  un-
		 posts the menu.

		 In  a	Popup MenuPane,	unposts	the menu and, when the shell's
		 keyboard focus	policy is XmEXPLICIT, restores keyboard	 focus
		 to  the  widget from which the	menu was posted.  In a TearOff
		 MenuPane that has no submenus	posted,	 dismisses  the	 menu;
		 otherwise,  if	 one  or more submenus are posted, unposts the
		 last menu pane.

       MenuGadgetTraverseDown():
		 If the	current	menu item has a	submenu	and is in  a  MenuBar,
		 then  this action posts the submenu, disarms the current menu
		 item, and arms	the submenu's first traversable	menu item.

		 If the	current	menu item is in	a MenuPane, then  this	action
		 disarms  the  current	menu  item and arms the	item below it.
		 This action wraps within the MenuPane.	The direction  of  the
		 wrapping depends on the XmNlayoutDirection resource.

       MenuGadgetTraverseLeft():
		 When  the current menu	item is	in a MenuBar, this action dis-
		 arms the current item and arms	the MenuBar item to the	 left.
		 This action wraps within the MenuBar.

		 In  MenuPanes,	 if  the  current menu item is not at the left
		 edge of a MenuPane, this action disarms the current item  and
		 arms  the  item  to its left.	If the current menu item is at
		 the left edge of a submenu attached to	a MenuBar  item,  then
		 this  action unposts the submenu and traverses	to the MenuBar
		 item to the left, wrapping if necessary. If that MenuBar item
		 has  a	 submenu, it posts the submenu and arms	the first tra-
		 versable item in the submenu.	If the current menu item is at
		 the left edge of a submenu not	directly attached to a MenuBar
		 item, then this action	unposts	the current submenu only.

		 In Popup or Torn-off MenuPanes, when the current menu item is
		 at  the  left edge, this action wraps within the MenuPane. If
		 the current menu item is at the left edge of the MenuPane and
		 not  in  the top row, this action wraps to the	rightmost menu
		 item in the row above.	If the current menu item is in the up-
		 per,  leftmost	corner,	this action wraps to the tear-off con-
		 trol, if present, or else it wraps to the  bottom,  rightmost
		 menu item in the MenuPane.

		 The preceding description applies when	the XmNlayoutDirection
		 horizontal direction is XmLEFT_TO_RIGHT. If the  XmNlayoutDi-
		 rection  horizontal  direction	 is  XmRIGHT_TO_LEFT, then the
		 following applies.

		 If the	current	menu item is in	a MenuBar,  then  this	action
		 disarms  the  current	item  and arms the MenuBar item	to the
		 left.	This action wraps within the MenuBar.

		 In MenuPanes, if the current menu item	 is  a	CascadeButton,
		 then  this  action posts its associated submenu.  If the cur-
		 rent menu item	is not a CascadeButton and is not at the  left
		 edge  of a MenuPane, this action disarms the current item and
		 arms the item to its left, wrapping  if  necessary.   If  the
		 current  menu	item is	not a CascadeButton and	is at the left
		 edge of a submenu that	is a descendent	 of  a	MenuBar,  then
		 this action unposts all submenus and traverses	to the MenuBar
		 item to the left.  If that MenuBar item  has  a  submenu,  it
		 posts	the  submenu  and arms the submenu's first traversable
		 item.

		 In Popup or Torn-off menus, if	the current menu item is not a
		 CascadeButton	and  is	 at the	left edge of a row (except the
		 bottom	row), this action wraps	to the rightmost menu item  in
		 the  row below. If the	current	menu item is not a CascadeBut-
		 ton and is in the bottom, leftmost corner of a	Popup or Pull-
		 down  MenuPane, this action wraps to the tear-off control, if
		 present, or else it wraps to the top, rightmost menu item  of
		 the MenuPane.

       MenuGadgetTraverseRight():
		 If  the  current  menu	item is	in a MenuBar, then this	action
		 disarms the current item and arms the	MenuBar	 item  to  the
		 right.	 This action wraps within the MenuBar.

		 In  MenuPanes,	 if  the current menu item is a	CascadeButton,
		 then this action posts	its associated submenu.	 If  the  cur-
		 rent menu item	is not a CascadeButton and is not at the right
		 edge of a MenuPane, this action disarms the current item  and
		 arms  the  item  to its right,	wrapping if necessary.	If the
		 current menu item is not a CascadeButton and is at the	 right
		 edge  of  a  submenu  that is a descendent of a MenuBar, then
		 this action unposts all submenus and traverses	to the MenuBar
		 item  to  the	right.	If that	MenuBar	item has a submenu, it
		 posts the submenu and arms the	 submenu's  first  traversable
		 item.

		 In Popup or Torn-off menus, if	the current menu item is not a
		 CascadeButton and is at the right edge	of a row  (except  the
		 bottom	 row),	this action wraps to the leftmost menu item in
		 the row below.	If the current menu item is not	a  CascadeBut-
		 ton  and  is  in  the	bottom,	rightmost corner of a Popup or
		 Pulldown MenuPane, this action	wraps to the tear-off control,
		 if  present,  or else it wraps	to the top, leftmost menu item
		 of the	MenuPane.

		 The preceding description applies when	the XmNlayoutDirection
		 horizontal  direction is XmLEFT_TO_RIGHT. If the XmNlayoutDi-
		 rection horizontal direction  is  XmRIGHT_TO_LEFT,  then  the
		 following  applies.   When  the  current  menu	 item  is in a
		 MenuBar, this action disarms the current item	and  arms  the
		 MenuBar  item	to  the	 left.	 This  action wraps within the
		 MenuBar.

		 In MenuPanes, if the current menu item	is not	at  the	 right
		 edge  of a MenuPane, this action disarms the current item and
		 arms the item to its right.  If the current menu item	is  at
		 the  right edge of a submenu attached to a MenuBar item, then
		 this action unposts the submenu and traverses to the  MenuBar
		 item  to  the	right,	wrapping if necessary. If that MenuBar
		 item has a submenu, it	posts the submenu and arms  the	 first
		 traversable item in the submenu.  If the current menu item is
		 at the	right edge of a	submenu	not  directly  attached	 to  a
		 MenuBar  item,	 then  this action unposts the current submenu
		 only.

		 In Popup or Torn-off MenuPanes, when the current menu item is
		 at  the right edge, this action wraps within the MenuPane. If
		 the current menu item is at the right edge  of	 the  MenuPane
		 and  not  in  the  top	row, this action wraps to the leftmost
		 menu item in the row above. If	the current menu  item	is  in
		 the  upper,  rightmost	corner,	this action wraps to the tear-
		 off control, if present, or else  it  wraps  to  the  bottom,
		 leftmost menu item in the MenuPane.

       MenuGadgetTraverseUp():
		 When the current menu item is in a MenuPane, then this	action
		 disarms the current menu item and arms	 the  item  above  it.
		 This  action  wraps within the	MenuPane. The direction	of the
		 wrapping depends on the XmNlayoutDirection resource.

   Related Behavior
       The following menu functions are	available:

       <osfMenuBar>:
		 In any	non-popup descendant of	a MenuBar's parent,  excluding
		 the  MenuBar  itself,	this action enables keyboard traversal
		 and moves keyboard focus to the first item  in	 the  MenuBar.
		 In  the MenuBar or any	menu cascaded from it, this action un-
		 posts the menu	hierarchy and, when the	shell's	keyboard focus
		 policy	 is  XmEXPLICIT, restores focus	to the widget that had
		 the focus when	the menu system	was entered.

       <osfMenu>:
		 Pops up the menu associated with the  control	that  has  the
		 keyboard  focus.  Enables keyboard traversal in the menu.  In
		 the Popup menu	system or any menu cascaded from it, this  ac-
		 tion  unposts	the  menu hierarchy and, when the shell's key-
		 board focus policy is XmEXPLICIT, restores focus to the  wid-
		 get that had the focus	when the menu system was entered.

   Virtual Bindings
       The  bindings  for  virtual  keys are vendor specific.  For information
       about bindings for virtual buttons and keys, see	VirtualBindings(3).

RELATED
       Composite(3), Constraint(3), Core(3),  XmCreateMenuBar(3),  XmCreateOp-
       tionMenu(3), XmCreatePopupMenu(3), XmCreatePulldownMenu(3), XmCreateRa-
       dioBox(3), XmCreateRowColumn(3),	XmCreateSimpleCheckBox(3),  XmCreateS-
       impleMenuBar(3),	   XmCreateSimpleOptionMenu(3),	  XmCreateSimplePopup-
       Menu(3),	XmCreateSimplePulldownMenu(3), XmCreateSimpleRadioBox(3),  Xm-
       CreateWorkArea(3), XmGetMenuCursor(3), XmGetPostedFromWidget(3),	XmGet-
       TearOffControl, XmLabel(3), XmManager(3), XmMenuPosition(3),  XmOption-
       ButtonGadget(3),	 XmOptionLabelGadget(3), XmRepTypeInstallTearOffModel-
       Converter,   XmSetMenuCursor(3),	  XmUpdateDisplay(3),	XmVaCreateMan-
       agedRowColumn(3),  XmVaCreateRowColumn(3), XmVaCreateSimpleCheckBox(3),
       XmVaCreateSimpleMenuBar(3), XmVaCreateSimpleOptionMenu(3), XmVaCreateS-
       implePopupMenu(3),  XmVaCreateSimplePulldownMenu(3), and	XmVaCreateSim-
       pleRadioBox(3).

								XmRowColumn(3)

NAME | SYNOPSIS | DESCRIPTION | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmRowColumn&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help