


XmRowColumn(3X)						      XmRowColumn(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmRRoowwCCoolluummnn -	The RowColumn widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

DESCRIPTION
  The RowColumn	widget is a general purpose RowColumn manager capable of con-
  taining any widget type as a child.  In general, it requires no special
  knowledge about how its children function and	provides nothing beyond	sup-
  port 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	MenuPanes, and OptionMenu.

  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o++  The children are	packed tightly together	into either rows or columns.

    oo++  Each child is placed in an identically sized box	(producing a symmetr-
       ical look).

    oo++  A specific layout (the current _x	and _y positions	of the children	con-
       trol their location).

  In addition, the application has control over	both the spacing that occurs
  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.

  In a MenuBar,	Pulldown MenuPane, or Popup MenuPane the default for the
  XXmmNNsshhaaddoowwTThhiicckknneessss resource is 2.  In	an OptionMenu or a WorkArea (such as
  a RadioBox or	CheckBox) this resource	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 MenuPane, or Popup MenuPane the XXmmNNnnaavviiggaattiioonnTTyyppee
  resource is not applicable and its use is undefined.	In a WorkArea the
  default for XXmmNNnnaavviiggaattiioonnTTyyppee	is XXmmTTAABB__GGRROOUUPP.	 In an OptionMenu the default
  for XXmmNNnnaavviiggaattiioonnTTyyppee	is XXmmNNOONNEE.

  In a MenuBar,	Pulldown MenuPane, or Popup MenuPane the XXmmNNttrraavveerrssaallOOnn
  resource is not applicable and its use is undefined.	In an OptionMenu or
  WorkArea the default for XXmmNNttrraavveerrssaallOOnn is True.

  If the parent	of the RowColumn is a MenuShell, the XXmmNNmmaappppeeddWWhheennMMaannaaggeedd
  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 identi-
  fies the names of these widgets (or gadgets) and the associated OptionMenu
  areas:

    oo++  Option Menu Label Gadget-"OptionLabel"

    oo++  Option Menu Cascade Button-"OptionButton"

  Tear-off Menus

  Pulldown and Popup MenuPanes support tear-off	menus, which enable the	user
  to retain a MenuPane on the display to facilitate subsequent menu selec-
  tions.  A MenuPane that can be torn-off is identified	by a tear-off button
  that spans the width of the MenuPane and displays a dashed line.  A torn-
  off MenuPane 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 XXmmSSTTRRIINNGG.  If the label contains a pixmap
  the window title is empty.  A	tear-off menu from a Popup MenuPane also
  displays an empty title.

  The user can tear-off	a MenuPane using the mouse or keyboard.	 Clicking
  BBSSeelleecctt or pressing KKAAccttiivvaattee	(or KKSSeelleecctt) on	the tear-off button, tears
  off the MenuPane at the current position.  Pressing BBDDrraagg on the tear-off
  button tears off the MenuPane, and allows the	user to	drag the torn-off
  menu to a new	position designated by releasing the mouse button.  Tearing
  off a	MenuPane unposts the current active menu.  Only	one tear-off copy for
  each MenuPane	is allowed.  Subsequent	tear-off actions of a torn MenuPane
  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
  application can also obtain the tear-off button itself using XXmmGGeett--
  TTeeaarrOOffffCCoonnttrrooll and then set resource values by calling XXttSSeettVVaalluueess.

  The tear-off button has Separator-like behavior.  Its	appearance can be
  specified using the following	tear-off button	resources: XXmmNNbbaacckkggrroouunndd,
  XXmmNNbbaacckkggrroouunnddPPiixxmmaapp,XXmmNNbboottttoommSShhaaddoowwCCoolloorr, XXmmNNffoorreeggrroouunndd, XXmmNNhheeiigghhtt, XXmmNNmmaarr--
  ggiinn, XXmmNNsseeppaarraattoorrTTyyppee, XXmmNNsshhaaddoowwTThhiicckknneessss, and XXmmNNttooppSShhaaddoowwCCoolloorr.  Refer to
  the XXmmSSeeppaarraattoorr man page for a complete description of each of these
  resources.

  RowColumn resources that affect tear-off menu	behavior are XXmmNNtteeaarrOOffffMMooddeell,
  XXmmNNtteeaarrOOffffMMeennuuAAccttiivvaatteeCCaallllbbaacckk, and XXmmNNtteeaarrOOffffMMeennuuDDeeaaccttiivvaatteeCCaallllbbaacckk.

  By default, menus do not tear	off; tear off functionality may	be enabled by
  setting the XXmmNNtteeaarrOOffffMMooddeell resource to XXmmTTEEAARR__OOFFFF__EENNAABBLLEEDD.  There is	no
  resource converter pre-registered for	XXmmNNtteeaarrOOffffMMooddeell.  To allow tear-off
  functionality	to be enabled through the resource database call the function
  XXmmRReeppTTyyppeeIInnssttaallllTTeeaarrOOffffMMooddeellCCoonnvveerrtteerr.

  Tear-off menu	focus policy follows standard window manager policy.  It is
  recommended that the following mmwwmm resources are set to True:	ssttaarrttuuppKKeeyy--
  FFooccuuss	and aauuttooKKeeyyFFooccuuss.

  Classes

  RowColumn inherits behavior and resources from CCoorree, CCoommppoossiittee, CCoonnssttrraaiinntt,
  and XXmmMMaannaaggeerr	classes.

  The class pointer is xxmmRRoowwCCoolluummnnWWiiddggeettCCllaassss.

  The class name is XXmmRRoowwCCoolluummnn.


  New Resources

  The following	table defines a	set of widget resources	used by	the program-
  mer to specify data.	The programmer can also	set the	resource values	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	XXmmNN or XXmmCC
  prefix and use the remaining letters.	 To specify one	of the defined values
  for a	resource in a .Xdefaults file, remove the XXmm prefix and	use the
  remaining letters (in	either lowercase or uppercase, but include any under-
  scores between words).  The codes in the access column indicate if the
  given	resource can be	set at creation	time (C), set by using XXttSSeettVVaalluueess
  (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable	(N/A).

			   XXmmRRoowwCCoolluummnn RReessoouurrccee	SSeett
      __________________________________________________________________
      NNaammee				 DDeeffaauulltt		  AAcccceessss
	    CCllaassss			       TTyyppee
      __________________________________________________________________
      __________________________________________________________________
      XmNadjustLast			 True			  CSG
	    XmCAdjustLast			Boolean
      __________________________________________________________________
      XmNadjustMargin			 True			  CSG
	    XmCAdjustMargin			Boolean
      __________________________________________________________________
      XmNentryAlignment			 XmALIGNMENT_BEGINNING	  CSG
	    XmCAlignment			unsigned char
      __________________________________________________________________
      XmNentryBorder			 0			  CSG
	    XmCEntryBorder			Dimension
      __________________________________________________________________
      XmNentryCallback			 NULL			  C
	    XmCCallback				XtCallbackList
      __________________________________________________________________
      XmNentryClass			 dynamic		  CSG
	    XmCEntryClass			WidgetClass
      __________________________________________________________________
      XmNentryVerticalAlignment		 XmALIGNMENT_CENTER	  CSG
	    XmCVerticalAlignment		unsigned char
      __________________________________________________________________
      XmNisAligned			 True			  CSG
	    XmCIsAligned			Boolean
      __________________________________________________________________
      XmNisHomogeneous			 dynamic		  CG
	    XmCIsHomogeneous			Boolean
      __________________________________________________________________
      XmNlabelString			 NULL			  C
	    XmCXmString				XmString
      __________________________________________________________________
      XmNmapCallback			 NULL			  C
	    XmCCallback				XtCallbackList
      __________________________________________________________________
      XmNmarginHeight			 dynamic		  CSG
	    XmCMarginHeight			Dimension
      __________________________________________________________________
      XmNmarginWidth			 dynamic		  CSG
	    XmCMarginWidth			Dimension
      __________________________________________________________________
      XmNmenuAccelerator		 dynamic		  CSG
	    XmCAccelerators			String
      __________________________________________________________________
      XmNmenuHelpWidget			 NULL			  CSG
	    XmCMenuWidget			Widget
      __________________________________________________________________
      XmNmenuHistory			 NULL			  CSG
	    XmCMenuWidget			Widget
      __________________________________________________________________
      XmNmenuPost			 NULL			  CSG
	    XmCMenuPost				String
      __________________________________________________________________
      XmNmnemonic			 NULL			  CSG
	    XmCMnemonic				KeySym
      __________________________________________________________________
      XmNmnemonicCharSet		 XmFONTLIST_DEFAULT_TAG	  CSG
	    XmCMnemonicCharSet			String
      __________________________________________________________________
      XmNnumColumns			 1			  CSG
	    XmCNumColumns			short
      __________________________________________________________________
      XmNorientation			 dynamic		  CSG
	    XmCOrientation			unsigned char
      __________________________________________________________________
      XmNpacking			 dynamic		  CSG
	    XmCPacking				unsigned char
      __________________________________________________________________
      XmNpopupEnabled			 True			  CSG
	    XmCPopupEnabled			Boolean
      __________________________________________________________________
	    XmCPostFromCount			int
      __________________________________________________________________
	    XmCPostFromList			WidgetList
      __________________________________________________________________
      XmNradioAlwaysOne			 True			  CSG
	    XmCRadioAlwaysOne			Boolean
      __________________________________________________________________
      XmNradioBehavior			 False			  CSG
	    XmCRadioBehavior			Boolean
      __________________________________________________________________
      XmNresizeHeight			 True			  CSG
	    XmCResizeHeight			Boolean
      __________________________________________________________________
      XmNresizeWidth			 True			  CSG
	    XmCResizeWidth			Boolean
      __________________________________________________________________
      XmNrowColumnType			 XmWORK_AREA		  CG
	    XmCRowColumnType			unsigned char
      __________________________________________________________________
      XmNspacing			 dynamic		  CSG
	    XmCSpacing				Dimension
      __________________________________________________________________
      XmNsubMenuId			 NULL			  CSG
	    XmCMenuWidget			Widget
      __________________________________________________________________
      XmNtearOffMenuActivateCallback	 NULL			  C
	    XmCCallback				XtCallbackList
      __________________________________________________________________
      XmNtearOffMenuDeactivateCallback	 NULL			  C
	    XmCCallback				XtCallbackList
      __________________________________________________________________
      XmNtearOffModel			 XmTEAR_OFF_DISABLED	  CSG
	    XmCTearOffModel			unsigned char
      __________________________________________________________________
      XmNunmapCallback			 NULL			  C
	    XmCCallback				XtCallbackList
      __________________________________________________________________
      XmNwhichButton			 dynamic		  CSG
	    XmCWhichButton			unsigned int
      __________________________________________________________________

  XXmmNNaaddjjuussttLLaasstt
	    Extends the	last row of children to	the bottom edge	of RowColumn
	    (when XXmmNNoorriieennttaattiioonn is XXmmHHOORRIIZZOONNTTAALL) or extends the last column
	    to the right edge of RowColumn (when XXmmNNoorriieennttaattiioonn	is XXmmVVEERRTTII--
	    CCAALL).  This	feature	is disabled by setting XXmmNNaaddjjuussttLLaasstt to
	    False.

  XXmmNNaaddjjuussttMMaarrggiinn
	    Specifies whether the inner	minor margins of all items contained
	    within the RowColumn widget	are forced to the same value.  The
	    inner minor	margin corresponds to the XXmmNNmmaarrggiinnLLeefftt, XXmmNNmmaarrggiinn--
	    RRiigghhtt, XXmmNNmmaarrggiinnTToopp, and XXmmNNmmaarrggiinnBBoottttoomm resources supported by
	    XXmmLLaabbeell and	XXmmLLaabbeellGGaaddggeett.

	    A horizontal orientation causes XXmmNNmmaarrggiinnTToopp and XXmmNNmmaarrggiinnBBoottttoomm
	    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 XXmmNNmmaarrggiinnLLeefftt	and XXmmNNmmaarrggiinnRRiigghhtt
	    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 the XXmmNNrroowwCCoolluummnnTTyyppee is
	    either XXmmMMEENNUU__PPOOPPUUPP	or XXmmMMEENNUU__PPUULLLLDDOOWWNN and this resource is	True,
	    only button	children have their margins adjusted.

  XXmmNNeennttrryyAAlliiggnnmmeenntt
	    Specifies the alignment type for children that are subclasses of
	    XXmmLLaabbeell or XXmmLLaabbeellGGaaddggeett when XXmmNNiissAAlliiggnneedd is enabled.  The	fol-
	    lowing are textual alignment types:

	    XXmmAALLIIGGNNMMEENNTT__BBEEGGIINNNNIINNGG-the default

	    XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR

	    XXmmAALLIIGGNNMMEENNTT__EENNDD

	    See	the description	of XXmmNNaalliiggnnmmeenntt	in the XXmmLLaabbeell((33XX)) man page
	    for	an explanation of these	actions.

  XXmmNNeennttrryyBBoorrddeerr
	    Imposes a uniform border width upon	all RowColumn's	children.
	    The	default	value is 0, which disables the feature.

  XXmmNNeennttrryyCCaallllbbaacckk
	    Disables the XXmmNNaaccttiivvaatteeCCaallllbbaacckk and XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk
	    callbacks for all CascadeButton, DrawnButton, PushButton, and
	    ToggleButton widgets and gadgets contained within the RowColumn
	    widget.  If	the application	supplies this resource,	the XXmmNNaacc--
	    ttiivvaatteeCCaallllbbaacckk and XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk callbacks are then
	    revectored to the XXmmNNeennttrryyCCaallllbbaacckk callbacks.  This	allows an
	    application	to supply a single callback routine for	handling all
	    items contained in a RowColumn widget.  The	callback reason	is
	    XXmmCCRR__AACCTTIIVVAATTEE.  If the application does not	supply this resource,
	    the	XXmmNNaaccttiivvaatteeCCaallllbbaacckk and	XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk	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 XXttSSeettVVaalluueess is not
	    supported.







  XXmmNNeennttrryyCCllaassss
	    Specifies the only widget class that can be	added to the
	    RowColumn widget; this resource is meaningful only when the
	    XXmmNNiissHHoommooggeenneeoouuss resource is set to	True.  Both widget and gadget
	    variants of	the specified class may	be added to the	widget.

	    When XXmmCCrreeaatteeRRaaddiiooBBooxx is called or when XXmmNNrroowwCCoolluummnnTTyyppee is	set
	    to XXmmWWOORRKK__AARREEAA and XXmmNNrraaddiiooBBeehhaavviioorr	is True, the default value of
	    XXmmNNeennttrryyCCllaassss is xxmmTToogggglleeBBuuttttoonnGGaaddggeettCCllaassss.	 When
	    XXmmNNrroowwCCoolluummnnTTyyppee is	set to XXmmMMEENNUU__BBAARR, the value of	XXmmNNeennttrryyCCllaassss
	    is forced to xxmmCCaassccaaddeeBBuuttttoonnWWiiddggeettCCllaassss.

  XXmmNNeennttrryyVVeerrttiiccaallAAlliiggnnmmeenntt
	    Specifies the type of vertical alignment for children that are
	    subclasses of XXmmLLaabbeell, XXmmLLaabbeellGGaaddggeett,, aanndd XXmmTTeexxtt.  This resource
	    is invalid if XXmmNNoorriieennttaattiioonn is XXmmVVEERRTTIICCAALL and XXmmNNppaacckkiinngg is
	    XXmmPPAACCKK__TTIIGGHHTT because this layout preserves variable	heights	among
	    the	children.  The vertical	alignment types	include:

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__BBAASSEELLIINNEE__BBOOTTTTOOMM-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.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__BBAASSEELLIINNEE__TTOOPP-causes the top baseline of all chil-
	      dren in a	row to be aligned.  This resource is applicable	only
	      when all children	in a row contain textual data.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__CCOONNTTEENNTTSS__BBOOTTTTOOMM-causes the bottom of the contents
	      (text or pixmap) of all children in a row	to be aligned.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR-causes	the center of all children in a	row
	      to be aligned.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__CCOONNTTEENNTTSS__TTOOPP-causes the top of the contents (text
	      or pixmap) of all	children in a row to be	aligned.

  XXmmNNiissAAlliiggnneedd
	    Specifies text alignment for each item within the RowColumn
	    widget; this applies only to items that are	subclasses of XXmmLLaabbeell
	    or XXmmLLaabbeellGGaaddggeett.  However,	if the item is a Label widget or
	    gadget and its parent is either a Popup MenuPane or	a Pulldown
	    MenuPane, alignment	is not performed; the Label is treated as the
	    title within the MenuPane, and the alignment set by	the applica-
	    tion is not	overridden.  XXmmNNeennttrryyAAlliiggnnmmeenntt controls	the type of
	    textual alignment.

  XXmmNNiissHHoommooggeenneeoouuss
	    Indicates whether the RowColumn widget should enforce exact	homo-
	    geneity among the items it contains; if True, only the widgets
	    that are of	the class indicated by XXmmNNeennttrryyCCllaassss 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 XXmmNNiissHHoommooggeenneeoouuss is forced to True.  In
	    an OptionMenu the value is forced to False.	 When XXmmCCrreeaatteeRRaa--
	    ddiiooBBooxx is called the default value is True.	 Otherwise, the
	    default value is False.



  XXmmNNllaabbeellSSttrriinngg
	    Points to a	text string, which displays the	label to one side of
	    the	selection area when XXmmNNrroowwCCoolluummnnTTyyppee is	set to XXmmMMEENNUU__OOPPTTIIOONN.
	    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	(XXmmOOppttiioonnLLaabbeellGGaaddggeett) and call XXttSSeett--
	    VVaalluueess on the LabelGadget directly.	 The default value is no
	    label.

  XXmmNNmmaappCCaallllbbaacckk
	    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 XXmmCCRR__MMAAPP.

  XXmmNNmmaarrggiinnHHeeiigghhtt
	    Specifies the amount of blank space	between	the top	edge of	the
	    RowColumn widget and the first item	in each	column,	and the	bot-
	    tom	edge of	the RowColumn widget and the last item in each
	    column.  The default value is 0 for	Pulldown and Popup MenuPanes,
	    and	3 pixels for other RowColumn types.

  XXmmNNmmaarrggiinnWWiiddtthh
	    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 for Pulldown and	Popup MenuPanes, and 3 pixels
	    for	other RowColumn	types.

  XXmmNNmmeennuuAAcccceelleerraattoorr
	    This resource is useful only when the RowColumn widget has been
	    configured to operate as a Popup MenuPane or a MenuBar.  The for-
	    mat	of this	resource is similar to the left	side specification of
	    a translation string, with the limitation that it must specify a
	    key	event.	For a Popup MenuPane, when the accelerator is typed
	    by the user, the Popup MenuPane is posted.	For a MenuBar, when
	    the	accelerator is typed by	the user, the first item in the	Menu-
	    Bar	is highlighted,	and traversal is enabled in the	MenuBar.  The
	    default for	a Popup	MenuPane is KKMMeennuu.  The	default	for a MenuBar
	    is KKMMeennuuBBaarr.  The accelerator can be disabled by setting the
	    XXmmNNppooppuuppEEnnaabblleedd resource to	False.

  XXmmNNmmeennuuHHeellppWWiiddggeett
	    Specifies the widget ID for	the CascadeButton, which is treated
	    as the Help	widget if XXmmNNrroowwCCoolluummnnTTyyppee is set to XXmmMMEENNUU__BBAARR.  The
	    MenuBar always places the Help widget at the bottom	right corner
	    (in	a lef to right environment) of the MenuBar.  If	the RowColumn
	    widget is any type other than XXmmMMEENNUU__BBAARR, this resource is not
	    meaningful.

  XXmmNNmmeennuuHHiissttoorryy
	    Specifies the widget ID of the last	menu entry to be activated.
	    It is also useful for specifying the current selection for an
	    OptionMenu.	 If XXmmNNrroowwCCoolluummnnTTyyppee is	set to XXmmMMEENNUU__OOPPTTIIOONN, the
	    specified menu item	is positioned under the	cursor when the	menu
	    is displayed.

	    If the RowColumn widget has	the XXmmNNrraaddiiooBBeehhaavviioorr resource set to
	    True, the widget field associated with this	resource contains the
	    widget ID of the last ToggleButton or ToggleButtonGadget to
	    change from	unselected to selected.	 The default value is the
	    widget ID of the first child in the	widget.

  XXmmNNmmeennuuPPoosstt
	    Specifies an X event description indicating	a button event that
	    posts a menu system.  The default for XXmmMMEENNUU__PPOOPPUUPP is BBMMeennuu
	    PPrreessss.  The	default	for XXmmMMEENNUU__OOPPTTIIOONN, XXmmMMEENNUU__BBAARR, and
	    XXmmWWOORRKK__AARREEAA	is BBSSeelleecctt PPrreessss.  The XXmmNNmmeennuuPPoosstt resource for	pull-
	    downs should be consistent with that of top-level parent menu
	    (although the event	type is	ignored).  Setting this	resource to
	    BBDDrraagg PPrreessss	will conflict with drag	and drop operations, which
	    use	BBDDrraagg PPrreessss as a default button	binding.

  XXmmNNmmnneemmoonniicc
	    This resource is useful only when XXmmNNrroowwCCoolluummnnTTyyppee is set to
	    XXmmMMEENNUU__OOPPTTIIOONN.  Specifies a	keysym for a key that, when pressed
	    by the user	along with the MMAAlltt modifier, posts the	associated
	    Pulldown MenuPane.	The first character in the OptionMenu label
	    string that	exactly	matches	the mnemonic in	the character set
	    specified in XXmmNNmmnneemmoonniiccCChhaarrSSeett is underlined.  The	user can post
	    the	menu by	pressing either	the shifted or the unshifted mnemonic
	    key.  The default is no mnemonic.

  XXmmNNmmnneemmoonniiccCChhaarrSSeett
	    Specifies the character set	of the mnemonic	for an OptionMenu.
	    The	default	is XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG.  If the RowColumn widget
	    is any type	other than XXmmMMEENNUU__OOPPTTIIOONN, this resource	is not mean-
	    ingful.

  XXmmNNnnuummCCoolluummnnss
	    Specifies the number of minor dimension extensions that are	made
	    to accommodate the entries;	this attribute is meaningful only
	    when XXmmNNppaacckkiinngg is set to XXmmPPAACCKK__CCOOLLUUMMNN.

	    For	vertically oriented RowColumn widgets, this attribute indi-
	    cates how many columns are built; the number of entries per
	    column is adjusted to maintain this	number of columns, if possi-
	    ble.

	    For	horizontally oriented RowColumn	widgets, this attribute	indi-
	    cates 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.

  XXmmNNoorriieennttaattiioonn
	    Determines whether RowColumn layouts are row-major or column-
	    major.  In a column-major layout, the children of the RowColumn
	    are	laid out in columns top	to bottom within the widget.  In a
	    row-major layout the children of the RowColumn are laid out	in
	    rows.  XXmmVVEERRTTIICCAALL resource value selects a column-major layout.
	    XXmmHHOORRIIZZOONNTTAALL resource value	selects	a row-major layout.

	    When creating a MenuBar or an OptionMenu, the default is XXmmHHOORR--
	    IIZZOONNTTAALL.  Otherwise, the default value is XXmmVVEERRTTIICCAALL.  The
	    results of specifying a value of XXmmVVEERRTTIICCAALL	for a MenuBar are
	    undefined.

  XXmmNNppaacckkiinngg
	    Specifies how to pack the items contained within a RowColumn
	    widget.  This can be set to	XXmmPPAACCKK__TTIIGGHHTT,, XXmmPPAACCKK__CCOOLLUUMMNN or
	    XXmmPPAACCKK__NNOONNEE.  When a RowColumn widget packs	the items it con-
	    tains, it determines its major dimension using the value of	the
	    XXmmNNoorriieennttaattiioonn resource.









	    XXmmPPAACCKK__TTIIGGHHTT indicates that	given the current major	dimension
	    (for example, vertical if XXmmNNoorriieennttaattiioonn is	XXmmVVEERRTTIICCAALL), entries
	    are	placed one after the other until the RowColumn widget must
	    wrap.  RowColumn wraps when	there is no room left for a complete
	    child in that dimension.  Wrapping occurs by beginning 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 position in the major dimension is left
	    unaltered (for example, XXmmNNyy is left unchanged when	XXmmNNoorriieennttaa--
	    ttiioonn is XXmmVVEERRTTIICCAALL); 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 column is independent of all	other rows or columns.

	    XXmmPPAACCKK__CCOOLLUUMMNN indicates that all entries are placed	in identi-
	    cally sized	boxes.	The box	is based on the	largest	height and
	    width values of all	the children widgets.  The value of the
	    XXmmNNnnuummCCoolluummnnss resource determines how many boxes are placed	in
	    the	major dimension, before	extending in the minor dimension.

	    XXmmPPAACCKK__NNOONNEE	indicates that no packing is performed.	 The x and y
	    attributes of each entry are left alone, and the RowColumn widget
	    attempts to	become large enough to enclose all entries.

	    When XXmmCCrreeaatteeRRaaddiiooBBooxx is called or when XXmmNNrroowwCCoolluummnnTTyyppee is	set
	    to XXmmWWOORRKK__AARREEAA and XXmmNNrraaddiiooBBeehhaavviioorr	is True, the default value of
	    XXmmNNppaacckkiinngg is XXmmPPAACCKK__CCOOLLUUMMNN.  In an	OptionMenu the value is	ini-
	    tialized to	XXmmPPAACCKK__TTIIGGHHTT.  Otherwise, the value defaults to
	    XXmmPPAACCKK__TTIIGGHHTT.

  XXmmNNppooppuuppEEnnaabblleedd
	    Allows the menu system to enable keyboard input (accelerators and
	    mnemonics) defined for the Popup MenuPane and any of its sub-
	    menus.  The	Popup MenuPane needs to	be informed whenever its
	    accessibility to the user changes because posting of the Popup
	    MenuPane is	controlled by the application.	The default value of
	    this resource is True (keyboard input-accelerators and
	    mnemonics-defined for the Popup MenuPane and any of	its submenus
	    is enabled).

  XXmmNNrraaddiiooAAllwwaayyssOOnnee
	    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 impor-
	    tant only when XXmmNNrraaddiiooBBeehhaavviioorr is True.

	    The	application can	always add and subtract	toggles	from
	    RowColumn regardless of the	selected/unselected state of the tog-
	    gle.  The application can also manage and unmanage toggle chil-
	    dren of RowColumn at any time regardless of	state.	Therefore,
	    the	application can	sometimes create a RowColumn that has XXmmNNrraa--
	    ddiiooAAllwwaayyssOOnnee 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.

  XXmmNNrraaddiiooBBeehhaavviioorr
	    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 ToggleButtonGadgets.

	    When the value of this resource is True, XXmmNNiinnddiiccaattoorrTTyyppee
	    defaults to	XXmmOONNEE__OOFF__MMAANNYY for ToggleButton and ToggleButtonGadget
	    children.





	    RadioBox behavior dictates that when one toggle is selected	and
	    the	user selects another toggle, the first toggle is unselected
	    automatically.  The	RowColumn usually does not enforce 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 using XXmmTToogggglleeBBuuttttoonnSSeettSSttaattee or XXmmTToogg--
	    gglleeBBuuttttoonnGGaaddggeettSSeettSSttaattee with a _n_o_t_i_f_y argument of True.

	    When XXmmCCrreeaatteeRRaaddiiooBBooxx is called the	default	value of XXmmNNrraa--
	    ddiiooBBeehhaavviioorr	is True.  Otherwise, the default value is False.

  XXmmNNrreessiizzeeHHeeiigghhtt
	    Requests a new height if necessary,	when set to True.  When	set
	    to False, the widget does not request a new	height regardless of
	    any	changes	to the widget or its children.

  XXmmNNrreessiizzeeWWiiddtthh
	    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.

  XXmmNNrroowwCCoolluummnnTTyyppee
	    Specifies the type of RowColumn widget to be created.  It is a
	    non-standard resource that cannot be changed after it is set.  If
	    an application uses	any of the convenience routines, except
	    XXmmCCrreeaatteeRRoowwCCoolluummnn, 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:

	    XXmmWWOORRKK__AARREEAA-the default

	    XXmmMMEENNUU__BBAARR

	    XXmmMMEENNUU__PPUULLLLDDOOWWNN

	    XXmmMMEENNUU__PPOOPPUUPP

	    XXmmMMEENNUU__OOPPTTIIOONN

	    This resource cannot be changed after the RowColumn	widget is
	    created.  Any changes attempted through XXttSSeettVVaalluueess	are ignored.

	    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 XXmmNNnnaa--
	    vviiggaattiioonnTTyyppee, inherited from XXmmMMaannaaggeerr, is changed to XXmmNNOONNEE if
	    XXmmNNrroowwCCoolluummnnTTyyppee is	XXmmMMEENNUU__OOPPTTIIOONN.

  XXmmNNssppaacciinngg
	    Specifies the horizontal and vertical spacing between items	con-
	    tained within the RowColumn	widget.	 The default value is 3	pix-
	    els	for XXmmOOPPTTIIOONN__MMEENNUU and XXmmWWOORRKK__AARREEAA and 0	for other RowColumn
	    types.

  XXmmNNssuubbMMeennuuIIdd
	    Specifies the widget ID for	the Pulldown MenuPane to be associ-
	    ated with an OptionMenu.  This resource is useful only when
	    XXmmNNrroowwCCoolluummnnTTyyppee is	set to XXmmMMEENNUU__OOPPTTIIOONN.  The default value is
	    NULL.

  XXmmNNtteeaarrOOffffMMeennuuAAccttiivvaatteeCCaallllbbaacckk
	    Specifies the callback list	that notifies the application when
	    the	tear-off MenuPane is about to be activated.  It	precedes the
	    tear-off's map callback.

	    Use	this resource when your	application has	shared MenuPanes 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	XXmmGGeettPPoosstteeddFFrroommWWiiddggeett to determine from	which
	    parent the menu was	torn.  The callback reason is
	    XXmmCCRR__TTEEAARR__OOFFFF__AACCTTIIVVAATTEE.  The default is NULL.

  XXmmNNtteeaarrOOffffMMeennuuDDeeaaccttiivvaatteeCCaallllbbaacckk
	    Specifies the callback list	that notifies the application when
	    the	tear-off MenuPane is about to be deactivated.  It follows the
	    tear-off's unmap callback.

	    Use	this resource when your	application has	shared MenuPanes 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	XXmmGGeettPPoosstteeddFFrroommWWiiddggeett to determine from	which
	    parent the menu was	torn.  The callback reason is
	    XXmmCCRR__TTEEAARR__OOFFFF__DDEEAACCTTIIVVAATTEE.  The default is NULL.

  XXmmNNtteeaarrOOffffMMooddeell
	    Indicates whether tear-off functionality is	enabled	or disabled
	    when XXmmNNrroowwCCoolluummnnTTyyppee is set to XXmmMMEENNUU__PPUULLLLDDOOWWNN or XXmmMMEENNUU__PPOOPPUUPP.
	    The	values are: XXmmTTEEAARR__OOFFFF__EENNAABBLLEEDD or XXmmTTEEAARR__OOFFFF__DDIISSAABBLLEEDD
	    (default value).  This resource is invalid for type
	    XXmmMMEENNUU__OOPPTTIIOONN; however, it does affect any pulldown	submenus
	    within an OptionMenu.  The function	XXmmRReeppTTyyppeeIInnssttaallllTTeeaarrOOffffMMooddeell--
	    CCoonnvveerrtteerr installs a resource converter for	this resource.

  XXmmNNuunnmmaappCCaallllbbaacckk
	    Specifies a	list of	callbacks that is called after the window
	    associated with the	RowColumn widget has been unmapped.  The
	    callback reason is XXmmCCRR__UUNNMMAAPP.  The	default	value is NULL.

  XXmmNNwwhhiicchhBBuuttttoonn
	    This resource is obsolete; it has been replaced by XXmmNNmmeennuuPPoosstt
	    and	is present for compatibility with older	releases of 1/Motif.

			   XXmmRRoowwCCoolluummnn CCoonnssttrraaiinntt RReessoouurrccee SSeett
		    _________________________________________________
		    NNaammee		     DDeeffaauulltt	       AAcccceessss
			  CCllaassss			   TTyyppee
		    _________________________________________________
		    _________________________________________________
		    XmNpositionIndex	     XmLAST_POSITION   CSG
			  XmCPositionIndex	    short
		    _________________________________________________

  XXmmNNppoossiittiioonnIInnddeexx
	    Specifies the position of the widget in its	parent's list of
	    children (the value	of the XXmmNNcchhiillddrreenn resource).  The value is
	    an integer that is no less than zero and no	greater	than the
	    number of children in the list at the time the value is
	    specified.	A value	of zero	means that the child is	placed at the
	    beginning of the list.  The	value can also be  specified as
	    XXmmLLAASSTT__PPOOSSIITTIIOONN (the default), which means that the	child is
	    placed at the end of the list.  Any	other value is ignored.
	    XXttGGeettVVaalluueess	returns	the position of	the widget in its parent's
	    child list at the time of the call to XXttGGeettVVaalluueess.

	    When a widget is inserted into its parent's	child list, the	posi-
	    tions of any existing children that	are greater than or equal to
	    the	specified widget's XXmmNNppoossiittiioonnIInnddeexx are	increased by one.
	    The	effect of a call to XXttSSeettVVaalluueess	for XXmmNNppoossiittiioonnIInnddeexx is	to
	    remove the specified widget	from its parent's child	list,
	    decrease by	one 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.

		      SSiimmppllee MMeennuu CCrreeaattiioonn RReessoouurrccee SSeett
    ______________________________________________________________________
    NNaammee			      DDeeffaauulltt			    AAcccceessss
	  CCllaassss				    TTyyppee
    ______________________________________________________________________
    ______________________________________________________________________
    XmNbuttonAccelerators	      NULL			    C
	  XmCButtonAccelerators		     StringTable
    ______________________________________________________________________
    XmNbuttonAcceleratorText	      NULL			    C
	  XmCButtonAcceleratorText	     XmStringTable
    ______________________________________________________________________
    XmNbuttonCount		      0				    C
	  XmCButtonCount		     int
    ______________________________________________________________________
    XmNbuttonMnemonicCharSets	      NULL			    C
	  XmCButtonMnemonicCharSets	     XmStringCharSetTable
    ______________________________________________________________________
    XmNbuttonMnemonics		      NULL			    C
	  XmCButtonMnemonics		     XmKeySymTable
    ______________________________________________________________________
    XmNbuttons			      NULL			    C
	  XmCButtons			     XmStringTable
    ______________________________________________________________________
    XmNbuttonSet		      -1			    C
	  XmCButtonSet			     int
    ______________________________________________________________________
    XmNbuttonType		      NULL			    C
	  XmCButtonType			     XmButtonTypeTable
    ______________________________________________________________________
    XmNoptionLabel		      NULL			    C
	  XmCOptionLabel		     XmString
    ______________________________________________________________________
    XmNoptionMnemonic		      NULL			    C
	  XmCOptionMnemonic		     KeySym
    ______________________________________________________________________
    XmNpostFromButton		      -1			    C
	  XmCPostFromButton		     int
    ______________________________________________________________________
    XmNsimpleCallback		      NULL			    C
	  XmCCallback			     XtCallbackProc
    ______________________________________________________________________

  XXmmNNbbuuttttoonnAAcccceelleerraattoorrss
	    This resource is for use with the simple menu creation routines.
	    It specifies a list	of accelerators	for the	buttons	created.  The
	    list contains one element for each button, separator, and title
	    created.


  XXmmNNbbuuttttoonnAAcccceelleerraattoorrTTeexxtt
	    This resource is for use with the simple menu creation routines.
	    It specifies a list	of compound strings to display for the
	    accelerators for the buttons created.  The list contains one ele-
	    ment for each button, separator, and title created.

  XXmmNNbbuuttttoonnCCoouunntt
	    This resource is for use with the simple menu creation routines.
	    It specifies the total number of menu buttons, separators, and
	    titles to create.  The value must not be negative.

  XXmmNNbbuuttttoonnMMnneemmoonniiccCChhaarrSSeettss
	    This resource is for use with the simple menu creation routines.
	    It specifies a list	of character sets with which button mnemonics
	    are	to be displayed.  The list contains one	element	for each but-
	    ton, separator, and	title created.	The default is determined
	    dynamically	depending on the locale	of the widget.

  XXmmNNbbuuttttoonnMMnneemmoonniiccss
	    This resource is for use with the simple menu creation routines.
	    It specifies a list	of mnemonics for the buttons created.  The
	    list contains one element for each button, separator, and title
	    created.

  XXmmNNbbuuttttoonnss
	    This resource is for use with the simple menu creation routines.
	    It specifies a list	of compound strings to use as labels for the
	    buttons created.  The list contains	one element for	each button,
	    separator, and title created.

  XXmmNNbbuuttttoonnSSeett
	    This resource is for use with the simple menu creation routines.
	    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 RadioBox	or the _nth
	    PushButtonGadget specified for an OptionMenu Pulldown submenu.
	    The	first button specified is number 0.  The value must not	be
	    negative.

  XXmmNNbbuuttttoonnTTyyppee
	    This resource is for use with the simple menu creation routines.
	    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 CascadeButtonGadget, each button in
	    a RadioBox or CheckBox is a	ToggleButtonGadget, and	each button
	    in any other type of RowColumn widget is a PushButtonGadget.
	    Each button	type is	of type	XXmmBBuuttttoonnTTyyppee, an enumeration with the
	    following possible values:

	    XXmmCCAASSCCAADDEEBBUUTTTTOONN-Specifies a	CascadeButtonGadget for	a MenuBar,
	    Popup MenuPane, or Pulldown	MenuPane.

	    XXmmCCHHEECCKKBBUUTTTTOONN-Specifies a ToggleButtonGadget for a CheckBox,
	    Popup MenuPane, or Pulldown	MenuPane.

	    XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR-Specifies a SeparatorGadget for a Popup Menu-
	    Pane, Pulldown MenuPane, or	OptionMenu Pulldown submenu.  The
	    separator type is XXmmDDOOUUBBLLEE__LLIINNEE.

	    XXmmPPUUSSHHBBUUTTTTOONN-Specifies a PushButtonGadget for a Popup MenuPane,
	    Pulldown MenuPane, or OptionMenu Pulldown submenu.

	    XXmmRRAADDIIOOBBUUTTTTOONN-Specifies a ToggleButtonGadget for a RadioBox,
	    Popup MenuPane, or Pulldown	MenuPane.

	    XXmmSSEEPPAARRAATTOORR-Specifies a SeparatorGadget for	a Popup	MenuPane,
	    Pulldown MenuPane, or OptionMenu Pulldown submenu.

	    XXmmTTIITTLLEE-Specifies a	LabelGadget used as a title for	a Popup	Menu-
	    Pane or Pulldown MenuPane.

  XXmmNNooppttiioonnLLaabbeell
	    This resource is for use with the simple menu creation routines.
	    It specifies a compound string for the label string	to be used on
	    the	left side of an	OptionMenu.

  XXmmNNooppttiioonnMMnneemmoonniicc
	    This resource is for use with the simple menu creation routines.
	    It specifies a keysym for a	key that, when pressed by the user
	    along with the MMAAlltt	modifier, posts	the associated Pulldown	Menu-
	    Pane for an	OptionMenu.

  XXmmNNppoossttFFrroommBBuuttttoonn
	    This resource is for use with the simple menu creation routines.
	    For	a Pulldown MenuPane, 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 indicating the _nth CascadeBut-
	    ton	or CascadeButtonGadget specified for the parent	of the Pull-
	    down MenuPane.  The	first button specified is number 0.  The
	    value must not be negative.

  XXmmNNssiimmpplleeCCaallllbbaacckk
	    This resource is for use with the simple menu creation routines.
	    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	CascadeButtonGadget
	    or a PushButtonGadget, the callback	is added as the	button's
	    XXmmNNaaccttiivvaatteeCCaallllbbaacckk, and it	is called when the button is
	    activated.	For a ToggleButtonGadget, the callback is added	as
	    the	button's XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk, and it is called when	the
	    button's value changes.  The button	number is passed in the
	    _c_l_i_e_n_t__d_a_t_a	field.

  Inherited Resources

  RowColumn inherits behavior and resources from the following named superc-
  lasses.  For a complete description of each resource,	refer to the man page
  for that superclass.

			    XXmmMMaannaaggeerr RReessoouurrccee SSeett
	_______________________________________________________________
	NNaammee			      DDeeffaauulltt			 AAcccceessss
	      CCllaassss			    TTyyppee
	_______________________________________________________________
	_______________________________________________________________
	XmNbottomShadowColor	      dynamic			 CSG
	      XmCBottomShadowColor	     Pixel
	_______________________________________________________________
	XmNbottomShadowPixmap	      XmUNSPECIFIED_PIXMAP	 CSG
	      XmCBottomShadowPixmap	     Pixmap
	_______________________________________________________________
	XmNforeground		      dynamic			 CSG
	      XmCForeground		     Pixel
	_______________________________________________________________
	XmNhelpCallback		      NULL			 C
	      XmCCallback		     XtCallbackList
	_______________________________________________________________
	XmNhighlightColor	      dynamic			 CSG
	      XmCHighlightColor		     Pixel
	_______________________________________________________________
	XmNhighlightPixmap	      dynamic			 CSG
	      XmCHighlightPixmap	     Pixmap
	_______________________________________________________________
	XmNinitialFocus		      NULL			 CSG
	      XmCInitialFocus		     Widget
	_______________________________________________________________
	XmNnavigationType	      dynamic			 CSG
	      XmCNavigationType		     XmNavigationType
	_______________________________________________________________
	XmNshadowThickness	      dynamic			 CSG
	      XmCShadowThickness	     Dimension
	_______________________________________________________________
	XmNstringDirection	      dynamic			 CG
	      XmCStringDirection	     XmStringDirection
	_______________________________________________________________
	XmNtopShadowColor	      dynamic			 CSG
	      XmCTopShadowColor		     Pixel
	_______________________________________________________________
	XmNtopShadowPixmap	      dynamic			 CSG
	      XmCTopShadowPixmap	     Pixmap
	_______________________________________________________________
	XmNtraversalOn		      dynamic			 CSG
	      XmCTraversalOn		     Boolean
	_______________________________________________________________
	XmNunitType		      dynamic			 CSG
	      XmCUnitType		     unsigned char
	_______________________________________________________________
	XmNuserData		      NULL			 CSG
	      XmCUserData		     XtPointer
	_______________________________________________________________

			    CCoommppoossiittee RReessoouurrccee SSeett
	     _____________________________________________________
	     NNaammee		       DDeeffaauulltt		    AAcccceessss
		   CCllaassss		     TTyyppee
	     _____________________________________________________
	     _____________________________________________________
	     XmNchildren	       NULL		    G
		   XmCReadOnly		      WidgetList
	     _____________________________________________________
	     XmNinsertPosition	       default procedure    CSG
		   XmCInsertPosition	      XtOrderProc
	     _____________________________________________________
	     XmNnumChildren	       0		    G
		   XmCReadOnly		      Cardinal
	     _____________________________________________________

			      CCoorree RReessoouurrccee SSeett
     ____________________________________________________________________
     NNaammee				   DDeeffaauulltt		   AAcccceessss
	   CCllaassss				 TTyyppee
     ____________________________________________________________________
     ____________________________________________________________________
     XmNaccelerators			   dynamic		   CSG
	   XmCAccelerators			  XtAccelerators
     ____________________________________________________________________
     XmNancestorSensitive		   dynamic		   G
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNbackground			   dynamic		   CSG
	   XmCBackground			  Pixel
     ____________________________________________________________________
     XmNbackgroundPixmap		   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderColor			   XtDefaultForeground	   CSG
	   XmCBorderColor			  Pixel
     ____________________________________________________________________
     XmNborderPixmap			   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderWidth			   0			   CSG
	   XmCBorderWidth			  Dimension
     ____________________________________________________________________
     XmNcolormap			   dynamic		   CG
	   XmCColormap				  Colormap
     ____________________________________________________________________
     XmNdepth				   dynamic		   CG
	   XmCDepth				  int
     ____________________________________________________________________
     XmNdestroyCallback			   NULL			   C
	   XmCCallback				  XtCallbackList
     ____________________________________________________________________
     XmNheight				   dynamic		   CSG
	   XmCHeight				  Dimension
     ____________________________________________________________________
     XmNinitialResourcesPersistent	   True			   C
	   XmCInitialResourcesPersistent	  Boolean
     ____________________________________________________________________
     XmNmappedWhenManaged		   True			   CSG
	   XmCMappedWhenManaged			  Boolean
     ____________________________________________________________________
     XmNscreen				   dynamic		   CG
	   XmCScreen				  Screen *
     ____________________________________________________________________
     XmNsensitive			   True			   CSG
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNtranslations			   dynamic		   CSG
	   XmCTranslations			  XtTranslations
     ____________________________________________________________________
     XmNwidth				   dynamic		   CSG
	   XmCWidth				  Dimension
     ____________________________________________________________________
     XmNx				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________
     XmNy				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________

  Callback Information

  A pointer to the following structure is passed to each callback:


  ttyyppeeddeeff ssttrruucctt
  {{
    iinntt	     _r_e_a_s_o_n;;
    XXEEvveenntt   * _e_v_e_n_t;;
    WWiiddggeett   _w_i_d_g_e_t;;
    cchhaarr     * _d_a_t_a;;
    cchhaarr     * _c_a_l_l_b_a_c_k_s_t_r_u_c_t;;
  }} XXmmRRoowwCCoolluummnnCCaallllbbaacckkSSttrruucctt;;

  _r_e_a_s_o_n    Indicates why the callback was invoked

  _e_v_e_n_t	    Points to the XXEEvveenntt that triggered	the callback

  The following	fields apply only when the callback reason is XXmmCCRR__AACCTTIIVVAATTEE;
  for all other	callback reasons, these	fields are set to NULL.	 The
  XXmmCCRR__AACCTTIIVVAATTEE	callback reason	is generated only when the application has
  supplied an entry callback, which overrides any activation callbacks
  registered with the individual RowColumn items.

  _w_i_d_g_e_t    Is set to the widget ID of the RowColumn item that has been
	    activated

  _d_a_t_a	    Contains the client-data value supplied by the application when
	    the	RowColumn item's activation callback was registered

  _c_a_l_l_b_a_c_k_s_t_r_u_c_t
	    Points to the callback structure generated by the RowColumn
	    item's activation callback

  Translations

  XmRowColumn translations depend on the value of the XXmmNNrroowwCCoolluummnnTTyyppee
  resource.

  If XXmmNNrroowwCCoolluummnnTTyyppee is set to	XXmmWWOORRKK__AARREEAA, XmRowColumn inherits transla-
  tions	from XmManager.

  If XXmmNNrroowwCCoolluummnnTTyyppee is set to	XXmmMMEENNUU__OOPPTTIIOONN, XmRowColumn inherits traver-
  sal, KActivate, and KCancel translations from	XmManager and has the addi-
  tional translations listed below.  These translations	may not	directly
  correspond to	a translation table.

       BBSSeelleecctt PPrreessss:: MMeennuuBBttnnDDoowwnn(())
       BBSSeelleecctt RReelleeaassee::MMeennuuBBttnnUUpp(())
       KKSSeelleecctt::	      MMaannaaggeerrGGaaddggeettSSeelleecctt(())
       KKHHeellpp::	      HHeellpp(())

  The translations for XmRowColumn if XXmmNNrroowwCCoolluummnnTTyyppee is set to XXmmMMEENNUU__BBAARR
  XXmmMMEENNUU__PPUULLLLDDOOWWNN, or XXmmMMEENNUU__PPOOPPUUPP are listed below.  In a Popup menu system,
  BBMMeennuu	also performs the BBSSeelleecctt actions.  These translations may not
  directly correspond to a translation table.

       BBSSeelleecctt PPrreessss:: MMeennuuBBttnnDDoowwnn(())
       BBSSeelleecctt RReelleeaassee::MMeennuuBBttnnUUpp(())
       KKAAccttiivvaattee::     MMaannaaggeerrGGaaddggeettSSeelleecctt(())
       KKSSeelleecctt::	      MMaannaaggeerrGGaaddggeettSSeelleecctt(())
       MMAAnnyy KKCCaanncceell::  MMeennuuGGaaddggeettEEssccaappee(())
       KKHHeellpp::	      HHeellpp(())
       KKLLeefftt::	      MMeennuuGGaaddggeettTTrraavveerrsseeLLeefftt(())
       KKRRiigghhtt::	      MMeennuuGGaaddggeettTTrraavveerrsseeRRiigghhtt(())
       KKUUpp::	      MMeennuuGGaaddggeettTTrraavveerrsseeUUpp(())
       KKDDoowwnn::	      MMeennuuGGaaddggeettTTrraavveerrsseeDDoowwnn(())

  Action Routines

  The XmRowColumn action routines are described	below:

  HHeellpp(()):   Calls the callbacks	for XXmmNNhheellppCCaallllbbaacckk 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.

  MMaannaaggeerrGGaaddggeettSSeelleecctt(()):
	    When a gadget child	of the menu has	the focus, invokes the gadget
	    child's behavior associated	with KKSSeelleecctt.  This generally has the
	    effect of unposting	the menu hierarchy and arming and activating
	    the	gadget,	except that for	a CascadeButtonGadget with a submenu,
	    it posts the submenu.

  MMeennuuBBttnnDDoowwnn(()):
	    When a gadget child	of the menu has	the focus, invokes the gadget
	    child's behavior associated	with BBSSeelleecctt PPrreessss.  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 associ-
	    ated submenu.




  MMeennuuBBttnnUUpp(()):
	    When a gadget child	of the menu has	the focus, invokes the gadget
	    child's behavior associated	with BBSSeelleecctt RReelleeaassee.  This generally
	    has	the effect of unposting	the menu hierarchy and activating the
	    gadget, except that	for a CascadeButtonGadget with a submenu, it
	    posts the submenu and enables keyboard traversal in	the menu.

  MMeennuuGGaaddggeettEEssccaappee(()):
	    In a toplevel Pulldown MenuPane from a MenuBar, unposts the	menu,
	    disarms the	MenuBar	CascadeButton and the MenuBar, and, when the
	    shell's keyboard focus policy is XXmmEEXXPPLLIICCIITT, restores keyboard
	    focus to the widget	that had the focus before the MenuBar was
	    entered.  In other Pulldown	MenuPanes, unposts the menu.

	    In a Popup MenuPane, unposts the menu and, when the	shell's	key-
	    board focus	policy is XXmmEEXXPPLLIICCIITT, 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.

  MMeennuuGGaaddggeettTTrraavveerrsseeDDoowwnn(()):
	    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.  When the	current	menu item is
	    at the MenuPane's bottom edge, then	this action wraps to the top-
	    most menu item in the column to the	right, if one exists.  When
	    the	current	menu item is at	the bottom, rightmost corner of	the
	    MenuPane, then this	action wraps to	the tear-off control, if
	    present, or	to the top, leftmost menu item.

  MMeennuuGGaaddggeettTTrraavveerrsseeLLeefftt(()):
	    When 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 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, wrap-
	    ping 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 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 upper, leftmost
	    corner, this action	wraps to the tear-off control, if present, or
	    else it wraps to the bottom, rightmost menu	item in	the MenuPane.



  MMeennuuGGaaddggeettTTrraavveerrsseeRRiigghhtt(()):
	    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 current 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	bot-
	    tom	row), this action wraps	to the leftmost	menu item in the row
	    below.  If the current menu	item is	not a CascadeButton 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.

  MMeennuuGGaaddggeettTTrraavveerrsseeUUpp(()):
	    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.  When the	current	menu item is
	    at the MenuPane's top edge,	then this action wraps to the bottom-
	    most menu item in the column to the	left, if one exists.  When
	    the	current	menu item is at	the top, leftmost corner of the	Menu-
	    Pane, then this action wraps to the	tear-off control, if present,
	    or to the bottom, rightmost	menu item.

  Related Behavior

  The following	menu functions are available.

  KKMMeennuuBBaarr: 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 unposts the menu
	    hierarchy and, when	the shell's keyboard focus policy is XXmmEEXXPPLLII--
	    CCIITT, restores focus	to the widget that had the focus when the
	    menu system	was entered.

  KKMMeennuu:    Pops up the	menu associated	with the control that has the key-
	    board focus.  Enables keyboard traversal in	the menu.  In the
	    Popup menu system or any menu cascaded from	it, this action
	    unposts the	menu hierarchy and, when the shell's keyboard focus
	    policy is XXmmEEXXPPLLIICCIITT, restores focus to the	widget 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 VViirrttuuaallBBiinnddiinnggss((33XX)).

RELATED	INFORMATION
  CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmCCrreeaatteeMMeennuuBBaarr((33XX)),
  XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)),
  XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)),	XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
  XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)), XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)),
  XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)),
  XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)), XXmmGGeettMMeennuuCCuurrssoorr((33XX)),
  XXmmGGeettPPoosstteeddFFrroommWWiiddggeett((33XX)), XXmmGGeettTTeeaarrOOffffCCoonnttrrooll, XXmmLLaabbeell((33XX)), XXmmMMaannaaggeerr((33XX)),
  XXmmMMeennuuPPoossiittiioonn((33XX)), XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX)),	XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX)),
  XXmmRReeppTTyyppeeIInnssttaallllTTeeaarrOOffffMMooddeellCCoonnvveerrtteerr, XXmmSSeettMMeennuuCCuurrssoorr((33XX)),
  XXmmUUppddaatteeDDiissppllaayy((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
  XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)),
  XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), and
  XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).

































































