


XmSelectionBox(3X)					   XmSelectionBox(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSeelleeccttiioonnBBooxx - The SelectionBox widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>

DESCRIPTION
  SelectionBox is a general dialog widget that allows the user to select one
  item from a list.  By	default	a SelectionBox includes	the following:

    oo++  A scrolling list	of alternatives

    oo++  An editable text	field for the selected alternative

    oo++  Labels for the list and text field

    oo++  Three or	four buttons

  The default button labels are	OOKK, CCaanncceell, and	HHeellpp.  By default an AAppppllyy
  button is also created; if the parent	of the SelectionBox is a DialogShell
  it is	managed, and otherwise it is unmanaged.	 Additional children may be
  added	to the SelectionBox after creation.  The first child is	used as	a
  work area.  The value	of XXmmNNcchhiillddPPllaacceemmeenntt determines	if the work area is
  placed above or below	the Text area, or above	or below the List area.
  Additional children are laid out in the following manner:

    oo++  Menubar-The first menu bar child	is placed at the top of	the window.

    oo++  Buttons-All XXmmPPuusshhBBuuttttoonn	widgets	or gadgets, and	their subclasses are
       placed after the	OOKK button in the order of their	creation.

    oo++  The layout of additional	children which are not in the above
       categories is undefined.

  The user can select an item in two ways: by scrolling	through	the list and
  selecting the	desired	item or	by entering the	item name directly into	the
  text edit area.  Selecting an	item from the list causes that item name to
  appear in the	selection text edit area.

  The user may select a	new item as many times as desired.  The	item is	not
  actually selected until the user presses the OOKK PushButton.

  The default value for	the XXmmBBuulllleettiinnBBooaarrdd resource XXmmNNccaanncceellBBuuttttoonn is	the
  Cancel button	unless XXmmNNddiiaallooggTTyyppee is	XXmmDDIIAALLOOGG__CCOOMMMMAANNDD, when the default is
  NULL.	 The default value for the XXmmBBuulllleettiinnBBooaarrdd resource XXmmNNddeeffaauullttBBuuttttoonn
  is the OK button unless XXmmNNddiiaallooggTTyyppee	is XXmmDDIIAALLOOGG__CCOOMMMMAANNDD, when the default
  is NULL.

  For SelectionBox and its subclasses, the default value for XXmmNNiinniittiiaallFFooccuuss
  is the text edit area.

  The user can specify resources in a resource file for	the automatically
  created widgets and gadgets of SelectionBox.	The following list identifies
  the names of these widgets (or gadgets) and the associated SelectionBox
  areas.

    oo++  List Items Label-"Items"

    oo++  List Items-"ItemsList"

    oo++  Selection Label-"Selection"

    oo++  Selection Text-"Text"

    oo++  Selection Separator-"Separator"

  Classes

  SelectionBox inherits	behavior and resources from CCoorree, CCoommppoossiittee, CCoonn--
  ssttrraaiinntt, XXmmMMaannaaggeerr, and XXmmBBuulllleettiinnBBooaarrdd Classes.

  The class pointer is xxmmSSeelleeccttiioonnBBooxxWWiiddggeettCCllaassss.

  The class name is XXmmSSeelleeccttiioonnBBooxx.

  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mSSeelleeccttiioonnBBooxx	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
       ________________________________________________________________
       ________________________________________________________________
       XmNapplyCallback		       NULL			 C
	     XmCCallback		      XtCallbackList
       ________________________________________________________________
       XmNapplyLabelString	       dynamic			 CSG
	     XmCApplyLabelString	      XmString
       ________________________________________________________________
       XmNcancelCallback	       NULL			 C
	     XmCCallback		      XtCallbackList
       ________________________________________________________________
       XmNcancelLabelString	       dynamic			 CSG
	     XmCCancelLabelString	      XmString
       ________________________________________________________________
       XmNchildPlacement	       XmPLACE_ABOVE_SELECTION	 CSG
	     XmCChildPlacement		      unsigned char
       ________________________________________________________________
       XmNdialogType		       dynamic			 CG
	     XmCDialogType		      unsigned char
       ________________________________________________________________
       XmNhelpLabelString	       dynamic			 CSG
	     XmCHelpLabelString		      XmString
       ________________________________________________________________
       XmNlistItemCount		       0			 CSG
	     XmCItemCount		      int
       ________________________________________________________________
       XmNlistItems		       NULL			 CSG
	     XmCItems			      XmStringTable
       ________________________________________________________________
       XmNlistLabelString	       dynamic			 CSG
	     XmCListLabelString		      XmString
       ________________________________________________________________
       XmNlistVisibleItemCount	       dynamic			 CSG
	     XmCVisibleItemCount	      int
       ________________________________________________________________
       XmNminimizeButtons	       False			 CSG
	     XmCMinimizeButtons		      Boolean
       ________________________________________________________________
       XmNmustMatch		       False			 CSG
	     XmCMustMatch		      Boolean
       ________________________________________________________________
       XmNnoMatchCallback	       NULL			 C
	     XmCCallback		      XtCallbackList
       ________________________________________________________________
       XmNokCallback		       NULL			 C
	     XmCCallback		      XtCallbackList
       ________________________________________________________________
       XmNokLabelString		       dynamic			 CSG
	     XmCOkLabelString		      XmString
       ________________________________________________________________
       XmNselectionLabelString	       dynamic			 CSG
	     XmCSelectionLabelString	      XmString
       ________________________________________________________________
       XmNtextAccelerators	       default			 C
	     XmCTextAccelerators	      XtAccelerators
       ________________________________________________________________
       XmNtextColumns		       dynamic			 CSG
	     XmCColumns			      short
       ________________________________________________________________
       XmNtextString		       ""			 CSG
	     XmCTextString		      XmString
       ________________________________________________________________

  XXmmNNaappppllyyCCaallllbbaacckk
	    Specifies the list of callbacks called when	the user activates
	    the	AAppppllyy button.  The callback reason is XXmmCCRR__AAPPPPLLYY.

  XXmmNNaappppllyyLLaabbeellSSttrriinngg
	    Specifies the string label for the AAppppllyy button.  The default for
	    this resource depends on the locale.  In the C locale the default
	    is "Apply".

  XXmmNNccaanncceellCCaallllbbaacckk
	    Specifies the list of callbacks called when	the user activates
	    the	CCaanncceell button.	The callback reason is XXmmCCRR__CCAANNCCEELL.

  XXmmNNccaanncceellLLaabbeellSSttrriinngg
	    Specifies the string label for the CCaanncceell button.  The default
	    for	this resource depends on the locale.  In the C locale the
	    default is "Cancel".

  XXmmNNcchhiillddPPllaacceemmeenntt
	    Specifies the placement of the work	area child.  The possible
	    values are:

	      oo++
	      XXmmPPLLAACCEE__AABBOOVVEE__SSEELLEECCTTIIOONN-places the work area child above the
	      Text area

	      oo++
	      XXmmPPLLAACCEE__BBEELLOOWW__SSEELLEECCTTIIOONN-places the work area child below the
	      Text area

	      oo++
	      XXmmPPLLAACCEE__TTOOPP-places the work area child above the List area, and
	      below a menubar, if one is present

  XXmmNNddiiaallooggTTyyppee
	    Determines the set of SelectionBox children	widgets	that are
	    created and	managed	at initialization.  The	following are possi-
	    ble	values:

	      oo++
	      XXmmDDIIAALLOOGG__PPRROOMMPPTT-all standard children except the list and	list
	      label are	created, and all except	the AAppppllyy button are managed

	      oo++
	      XXmmDDIIAALLOOGG__CCOOMMMMAANNDD-only the	list, the selection label, and the
	      text field are created and managed

	      oo++
	      XXmmDDIIAALLOOGG__SSEELLEECCTTIIOONN-all standard children are created and
	      managed

	      oo++
	      XXmmDDIIAALLOOGG__FFIILLEE__SSEELLEECCTTIIOONN-all standard children are	created	and
	      managed

	      oo++
	      XXmmDDIIAALLOOGG__WWOORRKK__AARREEAA-all standard children are created, and	all
	      except the AAppppllyy button are managed
  If the parent	of the SelectionBox is a DialogShell, the default is
  XXmmDDIIAALLOOGG__SSEELLEECCTTIIOONN; otherwise, the default is	XXmmDDIIAALLOOGG__WWOORRKK__AARREEAA.
  XXmmCCrreeaatteePPrroommppttDDiiaalloogg and XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg set and append this
  resource to the creation _a_r_g_l_i_s_t supplied by the application.	 This
  resource cannot be modified after creation.

  XXmmNNhheellppLLaabbeellSSttrriinngg
	    Specifies the string label for the HHeellpp button.  The default for
	    this resource depends on the locale.  In the C locale the default
	    is "Help".

  XXmmNNlliissttIItteemmss
	    Specifies the items	in the SelectionBox list.  XXttGGeettVVaalluueess for
	    this resource returns the list items themselves, not a copy	of
	    the	list items.  The application must not free the returned
	    items.

  XXmmNNlliissttIItteemmCCoouunntt
	    Specifies the number of items in the SelectionBox list.  The
	    value must not be negative.

  XXmmNNlliissttLLaabbeellSSttrriinngg
	    Specifies the string label to appear above the SelectionBox	list
	    containing the selection items.  The default for this resource
	    depends on the locale.  In the C locale the	default	is "Items"
	    unless XXmmNNddiiaallooggTTyyppee is XXmmDDIIAALLOOGG__PPRROOMMPPTT; in	that case the default
	    is NULL.

  XXmmNNlliissttVViissiibblleeIItteemmCCoouunntt
	    Specifies the number of items displayed in the SelectionBox	list.
	    The	value must be greater than 0 unless XXmmNNddiiaallooggTTyyppee is
	    XXmmDDIIAALLOOGG__PPRROOMMPPTT; in	that case the value is always 0.  The default
	    is dynamic based on	the height of the list.

  XXmmNNmmiinniimmiizzeeBBuuttttoonnss
	    Sets the buttons to	the width of the widest	button and height of
	    the	tallest	button if False.  If True, button width	and height
	    are	not modified.

  XXmmNNmmuussttMMaattcchh
	    Specifies whether the selection widget should check	if the user's
	    selection in the text edit field has an exact match	in the Selec-
	    tionBox list when the OOKK button is activated.  If the selection
	    does not have an exact match, and XXmmNNmmuussttMMaattcchh is True, the
	    XXmmNNnnooMMaattcchhCCaallllbbaacckk callbacks are called.  If the selection does
	    have an exact match	or if XXmmNNmmuussttMMaattcchh is False, XXmmNNookkCCaallllbbaacckk
	    callbacks are called.

  XXmmNNnnooMMaattcchhCCaallllbbaacckk
	    Specifies the list of callbacks called when	the user makes a
	    selection from the text edit field that does not have an exact
	    match with any of the items	in the list box.  The callback reason
	    is XXmmCCRR__NNOO__MMAATTCCHH.  Callbacks in this list are called only if
	    XXmmNNmmuussttMMaattcchh is true.

  XXmmNNookkCCaallllbbaacckk
	    Specifies the list of callbacks called when	the user activates
	    the	OOKK button.  The	callback reason	is XXmmCCRR__OOKK.  If	the selection
	    text does not match	a list item, and XXmmNNmmuussttMMaattcchh is True, the
	    XXmmNNnnooMMaattcchhCCaallllbbaacckk callbacks are called instead.

  XXmmNNookkLLaabbeellSSttrriinngg
	    Specifies the string label for the OOKK button.  The default for
	    this resource depends on the locale.  In the C locale the default
	    is "OK".

  XXmmNNsseelleeccttiioonnLLaabbeellSSttrriinngg
	    Specifies the string label for the selection text edit field.
	    The	default	for this resource depends on the locale.  In the C
	    locale the default is "Selection".

  XXmmNNtteexxttAAcccceelleerraattoorrss
	    Specifies translations added to the	Text widget child of the
	    SelectionBox.  The default includes	bindings for the up and	down
	    keys for auto selection of list items.  This resource is ignored
	    if XXmmNNaacccceelleerraattoorrss is initialized to a nondefault value.

  XXmmNNtteexxttCCoolluummnnss
	    Specifies the number of columns in the Text	widget.	 The value
	    must be greater than 0.

  XXmmNNtteexxttSSttrriinngg
	    Specifies the text in the text edit	selection field.

  Inherited Resources

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

			 XXmmBBuulllleettiinnBBooaarrdd 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
	   _________________________________________________________
	   _________________________________________________________
	   XmNallowOverlap	      True		      CSG
		 XmCAllowOverlap	     Boolean
	   _________________________________________________________
	   XmNautoUnmanage	      True		      CG
		 XmCAutoUnmanage	     Boolean
	   _________________________________________________________
	   XmNbuttonFontList	      dynamic		      CSG
		 XmCButtonFontList	     XmFontList
	   _________________________________________________________
	   XmNcancelButton	      dynamic		      SG
		 XmCWidget		     Widget
	   _________________________________________________________
	   XmNdefaultButton	      dynamic		      SG
		 XmCWidget		     Widget
	   _________________________________________________________
	   XmNdefaultPosition	      True		      CSG
		 XmCDefaultPosition	     Boolean
	   _________________________________________________________
	   XmNdialogStyle	      dynamic		      CSG
		 XmCDialogStyle		     unsigned char
	   _________________________________________________________
	   XmNdialogTitle	      NULL		      CSG
		 XmCDialogTitle		     XmString
	   _________________________________________________________
	   XmNfocusCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________
	   XmNlabelFontList	      dynamic		      CSG
		 XmCLabelFontList	     XmFontList
	   _________________________________________________________
	   XmNmapCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________
	   XmNmarginHeight	      10		      CSG
		 XmCMarginHeight	     Dimension
	   _________________________________________________________
	   XmNmarginWidth	      10		      CSG
		 XmCMarginWidth		     Dimension
	   _________________________________________________________
	   XmNnoResize		      False		      CSG
		 XmCNoResize		     Boolean
	   _________________________________________________________
	   XmNresizePolicy	      XmRESIZE_ANY	      CSG
		 XmCResizePolicy	     unsigned char
	   _________________________________________________________
	   XmNshadowType	      XmSHADOW_OUT	      CSG
		 XmCShadowType		     unsigned char
	   _________________________________________________________
	   XmNtextFontList	      dynamic		      CSG
		 XmCTextFontList	     XmFontList
	   _________________________________________________________
	   XmNtextTranslations	      NULL		      C
		 XmCTranslations	     XtTranslations
	   _________________________________________________________
	   XmNunmapCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________

			    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		      dynamic			 CSG
	      XmCInitialFocus		     Widget
	_______________________________________________________________
	XmNnavigationType	      XmTAB_GROUP		 CSG
	      XmCNavigationType		     XmNavigationType
	_______________________________________________________________
	XmNshadowThickness	      dynamic			 CSG
	      XmCShadowThickness	     Dimension
	_______________________________________________________________
	XmNstringDirection	      dynamic			 CG
	      XmCStringDirection	     XmStringDirection
	_______________________________________________________________
	XmNtopShadowColor	      dynamic			 CSG
	      XmCTopShadowColor		     Pixel
	_______________________________________________________________
	XmNtopShadowPixmap	      dynamic			 CSG
	      XmCTopShadowPixmap	     Pixmap
	_______________________________________________________________
	XmNtraversalOn		      True			 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	       NULL		    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		   N/A
	   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;;
    XXmmSSttrriinngg	 _v_a_l_u_e;;
    iinntt		 _l_e_n_g_t_h;;
  }} XXmmSSeelleeccttiioonnBBooxxC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

  _v_a_l_u_e	 Indicates the XXmmSSttrriinngg	value selected by the user from	the Selec-
	 tionBox list or entered into the SelectionBox text field

  _l_e_n_g_t_h Indicates the size in bytes of	the XXmmSSttrriinngg value

  Translations

  XmSelectionBox inherits translations from XmBulletinBoard.

  Accelerators

  The XXmmNNtteexxttAAcccceelleerraattoorrss are added to the Text	descendant of XmSelectionBox.
  The default accelerators are listed below.  These accelerators may not
  directly correspond to a translation table.

       KKUUpp::	      SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((00))
       KKDDoowwnn::	      SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((11))
       KKBBeeggiinnDDaattaa::    SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((22))
       KKEEnnddDDaattaa::      SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((33))
       KKRReessttoorree::      SSeelleeccttiioonnBBooxxRReessttoorree(())

  Action Routines

  The XmSelectionBox action routines are described below:

  SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((00||11||22||33)):
	    When called	with a 0 argument, selects the previous	item in	the
	    list and replaces the text with that item.
	    When called	with a 1 argument, selects the next item in the	list
	    and	replaces the text with that item.
	    When called	with a 2 argument, selects the first item in the list
	    and	replaces the text with that item.
	    When called	with a 3 argument, selects the last item in the	list
	    and	replaces the text with that item.

  SSeelleeccttiioonnBBooxxRReessttoorree(()):
	    Replaces the text value with the list selection.  If no item in
	    the	list is	selected, clears the text.

  Additional Behavior

  The SelectionBox widget has the additional behavior described	below:

  MMAAnnyy KKCCaanncceell:
	    Calls the activate callbacks for the cancel	button if it is	sen-
	    sitive.  If	no cancel button exists	and the	parent of the Selec-
	    tionBox is a manager, passes the event to the parent.

  KKAAccttiivvaattee:
	    Calls the activate callbacks for the button	with the keyboard
	    focus.  If no button has the keyboard focus, calls the activate
	    callbacks for the default button if	it is sensitive.  In a List
	    widget or single-line Text widget, the List	or Text	action asso-
	    ciated with	KKAAccttiivvaattee is called before the SelectionBox actions
	    associated with KKAAccttiivvaattee.	In a multi-line	Text widget, any KKAAcc--
	    ttiivvaattee event except	KKEEnntteerr calls the Text action associated	with
	    KKAAccttiivvaattee, then the	SelectionBox actions associated	with KKAAcc--
	    ttiivvaattee.  If	no button has the focus, no default button exists,
	    and	the parent of the SelectionBox is a manager, passes the	event
	    to the parent.

  <<OOKK BBuuttttoonn AAccttiivvaatteedd>>:
	    If XXmmNNmmuussttMMaattcchh is True and	the text does not match	an item	in
	    the	file list, calls the XXmmNNnnooMMaattcchhCCaallllbbaacckk	callbacks with reason
	    XXmmCCRR__NNOO__MMAATTCCHH.  Otherwise, calls the XXmmNNookkCCaallllbbaacckk callbacks with
	    reason XXmmCCRR__OOKK.

  <<AAppppllyy BBuuttttoonn	AAccttiivvaatteedd>>:
	    Calls the XXmmNNaappppllyyCCaallllbbaacckk callbacks with reason XXmmCCRR__AAPPPPLLYY.

  <<CCaanncceell BBuuttttoonn AAccttiivvaatteedd>>:
	    Calls the XXmmNNccaanncceellCCaallllbbaacckk	callbacks with reason XXmmCCRR__CCAANNCCEELL.

  <<HHeellpp	BBuuttttoonn AAccttiivvaatteedd>>:
	    Calls the XXmmNNhheellppCCaallllbbaacckk callbacks	with reason XXmmCCRR__HHEELLPP.

  <<MMaappWWiinnddooww>>:
	    Calls the callbacks	for XXmmNNmmaappCCaallllbbaacckk if the SelectionBox is a
	    child of a Dialog shell.

  <<UUnnmmaappWWiinnddooww>>:
	    Calls the callbacks	for XXmmNNuunnmmaappCCaallllbbaacckk if	the SelectionBox is
	    the	child of a DialogShell.

  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mBBuulllleettiinnBBooaarrdd((33XX)),
  XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx((33XX)), XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg((33XX)),
  XXmmCCrreeaatteePPrroommppttDDiiaalloogg((33XX)), XXmmMMaannaaggeerr((33XX)), and XXmmSSeelleeccttiioonnBBooxxGGeettCChhiilldd((33XX)).









































