


XmLabel(3X)							  XmLabel(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmLLaabbeell - The	Label widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//LLaabbeell..hh>>

DESCRIPTION
  Label	is an instantiable widget and is also used as a	superclass for other
  button widgets, such as PushButton and ToggleButton.	The Label widget does
  not accept any button	or key input, and the help callback is the only	call-
  back defined.	 Label also receives enter and leave events.

  Label	can contain either text	or a pixmap.  Label text is a compound
  string.  Refer to the	_O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r'_s Guide for more information on
  compound strings.  The text can be multilingual, multiline, and/or multi-
  font.	 When a	Label is insensitive, its text is stippled, or the user-
  supplied insensitive pixmap is displayed.

  Label	supports both accelerators and mnemonics primarily for use in Label
  subclass widgets that	are contained in menus.	 Mnemonics are available in a
  menu system when the button is visible.  Accelerators	in a menu system are
  accessible even when the button is not visible.  The Label widget displays
  the mnemonic by underlining the first	matching character in the text
  string.  The accelerator is displayed	as a text string adjacent to the
  label	text or	pixmap.

  Label	consists of many margin	fields surrounding the text or pixmap.	These
  margin fields	are resources that may be set by the user, but Label subc-
  lasses and Manager parents also modify some of these fields.	They tend to
  modify the XXmmNNmmaarrggiinnLLeefftt, XXmmNNmmaarrggiinnR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 and	leave the XXmmNNmmaarrggiinnWWiiddtthh and XXmmNNmmaarrggiinnHHeeiigghhtt resources as set
  by the application.

  Label	takes into account XXmmNNsshhaaddoowwTThhiicckknneessss in determining its layout	but
  does not draw	the shadow.  That is, if XXmmNNsshhaaddoowwTThhiicckknneessss is greater than
  0, Label leaves space	for the	shadow,	but the	shadow does not	appear.

  In a Label XXmmNNttrraavveerrssaallOOnn and	XXmmNNhhiigghhlliigghhttOOnnEEnntteerr are	forced to False
  inside Popup MenuPanes, Pulldown MenuPanes, and OptionMenus.	Otherwise
  these	resources default to False.

  Classes

  Label	inherits behavior and resources	from CCoorree and XXmmPPrriimmiittiivvee Classes.

  The class pointer is xxmmLLaabbeellWWiiddggeettCCllaassss.

  The class name is XXmmLLaabbeell.


  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mLLaabbeell 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
      ___________________________________________________________________
      ___________________________________________________________________
      XmNaccelerator			NULL			   CSG
	    XmCAccelerator		       String
      ___________________________________________________________________
      XmNacceleratorText		NULL			   CSG
	    XmCAcceleratorText		       XmString
      ___________________________________________________________________
      XmNalignment			dynamic			   CSG
	    XmCAlignment		       unsigned	char
      ___________________________________________________________________
      XmNfontList			dynamic			   CSG
	    XmCFontList			       XmFontList
      ___________________________________________________________________
      XmNlabelInsensitivePixmap		XmUNSPECIFIED_PIXMAP	   CSG
	    XmCLabelInsensitivePixmap	       Pixmap
      ___________________________________________________________________
      XmNlabelPixmap			XmUNSPECIFIED_PIXMAP	   CSG
	    XmCLabelPixmap		       Pixmap
      ___________________________________________________________________
      XmNlabelString			dynamic			   CSG
	    XmCXmString			       XmString
      ___________________________________________________________________
      XmNlabelType			XmSTRING		   CSG
	    XmCLabelType		       unsigned	char
      ___________________________________________________________________
      XmNmarginBottom			0			   CSG
	    XmCMarginBottom		       Dimension
      ___________________________________________________________________
      XmNmarginHeight			2			   CSG
	    XmCMarginHeight		       Dimension
      ___________________________________________________________________
      XmNmarginLeft			0			   CSG
	    XmCMarginLeft		       Dimension
      ___________________________________________________________________
      XmNmarginRight			0			   CSG
	    XmCMarginRight		       Dimension
      ___________________________________________________________________
      XmNmarginTop			0			   CSG
	    XmCMarginTop		       Dimension
      ___________________________________________________________________
      XmNmarginWidth			2			   CSG
	    XmCMarginWidth		       Dimension
      ___________________________________________________________________
      XmNmnemonic			NULL			   CSG
	    XmCMnemonic			       KeySym
      ___________________________________________________________________
      XmNmnemonicCharSet		XmFONTLIST_DEFAULT_TAG	   CSG
	    XmCMnemonicCharSet		       String
      ___________________________________________________________________
      XmNrecomputeSize			True			   CSG
	    XmCRecomputeSize		       Boolean
      ___________________________________________________________________
      XmNstringDirection		dynamic			   CSG
	    XmCStringDirection		       XmStringDirection
      ___________________________________________________________________

  XXmmNNaacccceelleerraattoorr
	    Sets the accelerator on a button widget in a menu, which
	    activates a	visible	or invisible, but managed, button from the
	    keyboard.  This resource is	a string that describes	a set of
	    modifiers and the key that may be used to select the button.  The
	    format of this string is identical to that used by the transla-
	    tions manager, with	the exception that only	a single event may be
	    specified and only KKeeyyPPrreessss	events are allowed.

	    Accelerators for buttons are supported only	for PushButtons	and
	    ToggleButtons in Pulldown and Popup	MenuPanes.

  XXmmNNaacccceelleerraattoorrTTeexxtt
	    Specifies the text displayed for the accelerator.  The text	is
	    displayed adjacent to the label string or pixmap.  Accelerator
	    text for buttons is	displayed only for PushButtons and ToggleBut-
	    tons in Pulldown and Popup Menus.

  XXmmNNaalliiggnnmmeenntt
	    Specifies the label	alignment for text or pixmap.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__BBEEGGIINNNNIINNGG (left alignment)-causes the	left sides of
	      the lines	of text	to be vertically aligned with the left edge
	      of the widget window.  For a pixmap, its left side is verti-
	      cally aligned with the left edge of the widget window.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR (center alignment)-causes the centers of the
	      lines of text to be vertically aligned in	the center of the
	      widget window.  For a pixmap, its	center is vertically aligned
	      with the center of the widget window.

	      oo++
	      XXmmAALLIIGGNNMMEENNTT__EENNDD (right alignment)-causes the right sides of the
	      lines of text to be vertically aligned with the right edge of
	      the widget window.  For a	pixmap,	its right side is vertically
	      aligned with the right edge of the widget	window.

  The above descriptions for text are correct when XXmmNNssttrriinnggDDiirreeccttiioonn is
  XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__LL__TTOO__RR.  When that	resource is
  XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__RR__TTOO__LL, the descriptions for XXmmAALLIIGGNNMMEENNTT__BBEEGGIINNNNIINNGG	and
  XXmmAALLIIGGNNMMEENNTT__EENNDD are switched.

  If the parent	is a RowColumn whose XXmmNNiissAAlliiggnneedd resource is True, XXmmNNaalliiggnn--
  mmeenntt is forced to the	same value as the RowColumn's XXmmNNeennttrryyAAlliiggnnmmeenntt	if
  the RowColumn's XXmmNNrroowwCCoolluummnnTTyyppee is XXmmWWOORRKK__AARREEAA or if	the widget is a	sub-
  class	of XmLabel.  Otherwise,	the default is XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR.

  XXmmNNffoonnttLLiisstt
	    Specifies the font of the text used	in the widget.	If this	value
	    is NULL at initialization, the font	 list is initialized by	look-
	    ing	up the parent hierarchy	of the widget for an ancestor that is
	    a subclass of the XmBulletinBoard, VendorShell, or XmMenuShell
	    widget class.  If such  an ancestor	is found, the font list	is
	    initialized	to the XXmmNNbbuuttttoonnFFoonnttLLiisstt  (for button subclasses) or
	    XXmmNNllaabbeellFFoonnttLLiisstt of	the ancestor widget.  If no such ancestor is
	    found, the default is implementation dependent.  Refer to
	    XXmmFFoonnttLLiisstt((33XX)) for more information	on the creation	and structure
	    of a font list.

  XXmmNNllaabbeellIInnsseennssiittiivveePPiixxmmaapp
	    Specifies a	pixmap used as the button face if XXmmNNllaabbeellTTyyppee is
	    XXmmPPIIXXMMAAPP and the button is insensitive.  The default value,
	    XXmmUUNNSSPPEECCIIFFIIEEDD__PPIIXXMMAAPP, displays an empty label.

  XXmmNNllaabbeellPPiixxmmaapp
	    Specifies the pixmap when XXmmNNllaabbeellTTyyppee is XXmmPPIIXXMMAAPP.	 The default
	    value, XXmmUUNNSSPPEECCIIFFIIEEDD__PPIIXXMMAAPP, displays an empty label.

  XXmmNNllaabbeellSSttrriinngg
	    Specifies the compound string when the XXmmNNllaabbeellTTyyppee	is XXmmSSTTRRIINNGG.
	    If this value is NULL, it is initialized by	converting the name
	    of the widget to a compound	string.	 Refer to XXmmSSttrriinngg((33XX)) for
	    more information on	the creation and structure of compound
	    strings.

  XXmmNNllaabbeellTTyyppee
	    Specifies the label	type.

	      oo++
	      XXmmSSTTRRIINNGG-displays	text using XXmmNNllaabbeellSSttrriinngg.

	      oo++
	      XXmmPPIIXXMMAAPP-displays	pixmap using XXmmNNllaabbeellPPiixxmmaapp or XXmmNNllaabbeellIInnsseenn--
	      ssiittiivveePPiixxmmaapp.

  XXmmNNmmaarrggiinnBBoottttoomm
	    Specifies the amount of spacing between the	bottom of the label
	    text and the top of	the bottom margin specified by XXmmNNmmaarr--
	    ggiinnHHeeiigghhtt.	This may be modified by	Label's	subclasses.  For
	    example, CascadeButton may increase	this field to make room	for
	    the	cascade	pixmap.

  XXmmNNmmaarrggiinnHHeeiigghhtt
	    Specifies an equal amount of spacing above the margin defined by
	    XXmmNNmmaarrggiinnTToopp and below the margin defined by XXmmNNmmaarrggiinnBBoottttoomm.
	    XXmmNNmmaarrggiinnHHeeiigghhtt specifies the amount of spacing between the	top
	    edge of the	margin set by XXmmNNmmaarrggiinnTToopp and the bottom edge of the
	    top	shadow,	and the	amount of spacing between the bottom edge of
	    the	margin specified by XXmmNNmmaarrggiinnBBoottttoomm and	the top	edge of	the
	    bottom shadow.

  XXmmNNmmaarrggiinnLLeefftt
	    Specifies the amount of spacing between the	left edge of the
	    label text and the right side of the left margin (specified	by
	    XXmmNNmmaarrggiinnWWiiddtthh).  This may be modified by Label's subclasses.
	    For	example, ToggleButton may increase this	field to make room
	    for	the toggle indicator and for spacing between the indicator
	    and	label.	Whether	this actually applies to the left or right
	    side of the	label may depend on the	value of XXmmNNssttrriinnggDDiirreeccttiioonn.

  XXmmNNmmaarrggiinnRRiigghhtt
	    Specifies the amount of spacing between the	right edge of the
	    label text and the left side of the	right margin (specified	by
	    XXmmNNmmaarrggiinnWWiiddtthh).  This may be modified by Label's subclasses.
	    For	example, CascadeButton may increase this field to make room
	    for	the cascade pixmap.  Whether this actually applies to the
	    left or right side of the label may	depend on the value of
	    XXmmNNssttrriinnggDDiirreeccttiioonn.





  XXmmNNmmaarrggiinnTToopp
	    Specifies the amount of spacing between the	top of the label text
	    and	the bottom of the top margin specified by XXmmNNmmaarrggiinnHHeeiigghhtt.
	    This may be	modified by Label's subclasses.	 For example, Cas-
	    cadeButton may increase this field to make room for	the cascade
	    pixmap.

  XXmmNNmmaarrggiinnWWiiddtthh
	    Specifies an equal amount of spacing to the	left of	the margin
	    defined by XXmmNNmmaarrggiinnLLeefftt and to the	right of the margin defined
	    by XXmmNNmmaarrggiinnRRiigghhtt.	XXmmNNmmaarrggiinnWWiiddtthh specifies the amount of spac-
	    ing	between	the left edge of the margin set	by XXmmNNmmaarrggiinnLLeefftt and
	    the	right edge of the left shadow, and the amount of spacing
	    between the	right edge of the margin specified by XXmmNNmmaarrggiinnRRiigghhtt
	    and	the left edge of the right shadow.

  XXmmNNmmnneemmoonniicc
	    Provides the user with an alternate	means of activating a button.
	    A button in	a MenuBar, a Popup MenuPane, or	a Pulldown MenuPane
	    can	have a mnemonic.

	    This resource contains a keysym as listed in the X11 keysym
	    table.  The	first character	in the label string that exactly
	    matches the	mnemonic in the	character set specified	in XXmmNNmmnneemmoonn--
	    iiccCChhaarrSSeett is underlined when the button is displayed.

	    When a mnemonic has	been specified,	the user activates the button
	    by pressing	the mnemonic key while the button is visible.  If the
	    button is a	CascadeButton in a MenuBar and the MenuBar does	not
	    have the focus, the	user must use the MMAAlltt modifier	while press-
	    ing	the mnemonic.  The user	can activate the button	by pressing
	    either the shifted or the unshifted	mnemonic key.

  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 the	label.	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.

  XXmmNNrreeccoommppuutteeSSiizzee
	    Specifies a	Boolean	value that indicates whether the widget
	    shrinks or expands to accommodate its contents (label string or
	    pixmap) as a result	of an XXttSSeettVVaalluueess resource value that would
	    change the size of the widget.  If True, the widget	shrinks	or
	    expands to exactly fit the label string or pixmap.	If False, the
	    widget never attempts to change size on its	own.

  XXmmNNssttrriinnggDDiirreeccttiioonn
	    Specifies the direction in which the string	is to be drawn.	 The
	    following are the values:

	      oo++
	      XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__LL__TTOO__RR-left to	right

	      oo++
	      XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__RR__TTOO__LL-right to left

  The default for this resource	is determined at creation time.	 If no value
  is specified for this	resource and the widget's parent is a manager, the
  value	is inherited from the parent; otherwise, it defaults to
  XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__LL__TTOO__RR.

  Inherited Resources

  Label	inherits behavior and resources	from the following superclasses.  For
  a complete description of each resource, refer to the	man page for that
  superclass.

			   XXmmPPrriimmiittiivve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
	______________________________________________________________
	______________________________________________________________
	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
	______________________________________________________________
	XmNhighlightOnEnter	      False			CSG
	      XmCHighlightOnEnter	     Boolean
	______________________________________________________________
	XmNhighlightPixmap	      dynamic			CSG
	      XmCHighlightPixmap	     Pixmap
	______________________________________________________________
	XmNhighlightThickness	      0				CSG
	      XmCHighlightThickness	     Dimension
	______________________________________________________________
	XmNnavigationType	      XmNONE			CSG
	      XmCNavigationType		     XmNavigationType
	______________________________________________________________
	XmNshadowThickness	      0				CSG
	      XmCShadowThickness	     Dimension
	______________________________________________________________
	XmNtopShadowColor	      dynamic			CSG
	      XmCTopShadowColor		     Pixel
	______________________________________________________________
	XmNtopShadowPixmap	      dynamic			CSG
	      XmCTopShadowPixmap	     Pixmap
	______________________________________________________________
	XmNtraversalOn		      False			CSG
	      XmCTraversalOn		     Boolean
	______________________________________________________________
	XmNunitType		      dynamic			CSG
	      XmCUnitType		     unsigned char
	______________________________________________________________
	XmNuserData		      NULL			CSG
	      XmCUserData		     XtPointer
	______________________________________________________________

			      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
     ____________________________________________________________________

  Translations














  XmLabel includes translations	from Primitive.	 The XmLabel translations are
  listed below.	 These translations may	not directly correspond	to a transla-
  tion table.

       BBDDrraagg PPrreessss::   PPrroocceessssDDrraagg(())
       KKHHeellpp::	      HHeellpp(())

  The translations used	by subclasses of XmLabel for menu traversal are
  listed below.	 These translations may	not directly correspond	to a transla-
  tion table.

       KKLLeefftt::	      MMeennuuTTrraavveerrsseeLLeefftt(())
       KKRRiigghhtt::	      MMeennuuTTrraavveerrsseeRRiigghhtt(())
       KKUUpp::	      MMeennuuTTrraavveerrsseeUUpp(())
       KKDDoowwnn::	      MMeennuuTTrraavveerrsseeDDoowwnn(())
       MMAAnnyy KKCCaanncceell::  MMeennuuEEssccaappee(())

  Action Routines

  The XmLabel action routines are described below:

  HHeellpp(()):   In a Popup or Pulldown MenuPane, unposts all menus in 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 keyboard focus to the	widget that had	the focus
	    before the menu system was entered.	 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MeennuuEEssccaappee(()):
	    In a MenuBar, disarms the CascadeButton and	the menu and, when
	    the	shell's	keyboard focus policy is XXmmEEXXPPLLIICCIITT, restores key-
	    board focus	to the widget that had the focus before	the menu was
	    entered.

	    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 and	moves
	    the	focus to its CascadeButton.

	    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.

  MMeennuuT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uT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uT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uT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.

  PPrroocceessssDDrraagg(()):
	    Drags the contents of a Label, identified by pressing BBDDrraagg.
	    This action	creates	a DragContext object whose XXmmNNeexxppoorrttTTaarrggeettss
	    resource is	set to "COMPOUND_TEXT" for a label type	of XXmmSSTTRRIINNGG;
	    otherwise, "PIXMAP"	if the label type is XXmmPPIIXXMMAAPP.	This action
	    is undefined for Labels used in a menu system.

  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orree((33XX)), XXmmCCrreeaatteeLLaabbeell((33XX)), XXmmFFoonnttLLiissttAAppppeennddEEnnttrryy((33XX)), XXmmSSttrriinnggCCrreeaattee((33XX)),
  XXmmSSttrriinnggCCrreeaatteeLLttooRR((33XX)), and XXmmPPrriimmiittiivvee((33XX)).



