


XmDropSite(3X)						       XmDropSite(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDrrooppSSiittee - The DropSite Registry

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggDDrroopp..hh>>

DESCRIPTION
  A client registers a widget or gadget	as a drop site using the XXmmDDrrooppSSii--
  tteeRReeggiisstteerr function.	In addition, this routine defines the behavior and
  capabilities of a drop site by specifying appropriate	resources.  For	exam-
  ple, the XXmmNNiimmppoorrttTTaarrggeettss and	XXmmNNnnuummIImmppoorrttTTaarrggeettss resources identify
  respectively the selection target types and number of	types supported	by a
  drop site.  The visual animation effects associated with a drop site are
  also described with DropSite resources.

  Drop site animation effects that occur in response to	the pointer entering
  a valid drop site are	called drag-under effects.  A receiver can select
  from several animation styles	supplied by the	toolkit	or can provide cus-
  tomized animation effects.  Drag-under effects supplied by the toolkit
  include border highlighting, shadow in/out drawing, and pixmap representa-
  tion.

  When a preregister drag protocol style is used, the toolkit generates
  drag-under visual effects based on the value of the XXmmNNaanniimmaattiioonnSSttyyllee
  resource.  In	dynamic	mode, if the drop site XXmmNNddrraaggPPrroocc resource is NULL,
  the toolkit also provides animation effects based on the XXmmNNaanniimmaattiioonnSSttyyllee
  resource.  Otherwise,	if the XXmmNNddrraaggPPrroocc routine is specified, the receiver
  can either assume responsibility for animation effects (through the
  XXmmNNddrraaggPPrroocc routine) or rely on the toolkit to provide animation.

  Drop sites may overlap.  The initial stacking	order corresponds to the
  order	in which the drop sites	were registered.  When a drop site overlaps
  another drop site, the drag-under effects of the drop	site underneath	are
  clipped by the obscuring drop	site(s).

  The XXmmDDrrooppSSiitteeUUppddaattee routine sets resources for a widget that	is registered
  as a drop site.  XXmmDDrrooppSSiitteeRReettrriieevvee gets drop	site resource values previ-
  ously	specified for a	registered widget.  These routines are used instead
  of XXttSSeettVVaalluueess and XXttGGeettVVaalluueess.

  Classes

  XmDropSite does not inherit from any widget class.

  New Resources

  The following	table defines a	set of widget resources	used by	the program-
  mer to specify data.	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 underscores between words).
  The codes in the access column indicate if the given resource	can be set at
  creation time	(CC), set by using XXmmDDrrooppSSiitteeUUppddaattee (SS),	retrieved by using
  XXmmDDrrooppSSiitteeRReettrriieevvee (GG), or is	not applicable (NN//AA).

			   XXmmDDrrooppS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
      __________________________________________________________________
      __________________________________________________________________
      XmNanimationMask		      XmUNSPECIFIED_PIXMAP	  CSG
	    XmCAnimationMask		     Pixmap
      __________________________________________________________________
      XmNanimationPixmap	      XmUNSPECIFIED_PIXMAP	  CSG
	    XmCAnimationPixmap		     Pixmap
      __________________________________________________________________
      XmNanimationPixmapDepth	      0				  CSG
	    XmCAnimationPixmapDepth	     int
      __________________________________________________________________
       XmNanimationStyle	      XmDRAG_UNDER_HIGHLIGHT	  CSG
	    XmCAnimationStyle		     unsigned char
      __________________________________________________________________
      XmNdragProc		      NULL			  CSG
	    XmCDragProc			     XtCallbackProc
      __________________________________________________________________
      XmNdropProc		      NULL			  CSG
	    XmCDropProc			     XtCallbackProc
      __________________________________________________________________
      XmNdropRectangles		      dynamic			  CSG
	    XmCDropRectangles		     XRectangle	*
      __________________________________________________________________
      XmNdropSiteActivity	      XmDROP_SITE_ACTIVE	  CSG
	    XmCDropSiteActivity		     unsigned char
      __________________________________________________________________
      XmNdropSiteOperations	      XmDROP_MOVE   XmDROP_COPY	  CSG
	    XmCDropSiteOperations	     unsigned char
      __________________________________________________________________
      XmNdropSiteType		      XmDROP_SITE_SIMPLE	  CG
	    XmCDropSiteType		     unsigned char
      __________________________________________________________________
      XmNimportTargets		      NULL			  CSG
	    XmCImportTargets		     Atom *
      __________________________________________________________________
      XmNnumDropRectangles	      1				  CSG
	    XmCNumDropRectangles	     Cardinal
      __________________________________________________________________
      XmNnumImportTargets	      0				  CSG
	    XmCNumImportTargets		     Cardinal
      __________________________________________________________________

  XXmmNNaanniimmaattiioonnMMaasskk
	    Specifies a	mask to	use with the pixmap specified by XXmmNNaanniimmaa--
	    ttiioonnPPiixxmmaapp when the	animation style	is XXmmDDRRAAGG__UUNNDDEERR__PPIIXXMMAAPP.

  XXmmNNaanniimmaattiioonnPPiixxmmaapp
	    Specifies a	pixmap for drag-under animation	when the animation
	    style is XXmmDDRRAAGG__UUNNDDEERR__PPIIXXMMAAPP.  The pixmap is drawn with its	ori-
	    gin	at the upper left corner of the	bounding box of	the drop
	    site.  If the drop site window is larger than the animation	pix-
	    map, the portion of	the window not covered by the pixmap will be
	    tiled with the window's background color.

  XXmmNNaanniimmaattiioonnPPiixxmmaappDDeepptthh
	    Specifies the depth	of the pixmap specified	by the
	    XXmmNNaanniimmaattiioonnPPiixxmmaapp resource.  When the depth is 1, the colors are
	    taken from the foreground and background of	the drop site widget.
	    For	any other value, drop site animation occurs only if the
	    XXmmNNaanniimmaattiioonnPPiixxmmaappDDeepptthh matches the	depth of the drop site win-
	    dow.  Colors are derived from the current colormap.

  XXmmNNaanniimmaattiioonnSSttyyllee
	    Specifies the drag-under animation style used when a drag enters
	    a valid drop site.	The possible values are:

	    XXmmDDRRAAGG__UUNNDDEERR__HHIIGGHHLLIIGGHHTT
	      The drop site uses highlighting effects.

	    XXmmDDRRAAGG__UUNNDDEERR__SSHHAADDOOWW__OOUUTT
	      The drop site uses an outset shadow.

	    XXmmDDRRAAGG__UUNNDDEERR__SSHHAADDOOWW__IINN
	      The drop site uses an inset shadow.

	    XXmmDDRRAAGG__UUNNDDEERR__PPIIXXMMAAPP
	      The drop site uses the pixmap specified by XXmmNNaanniimmaattiioonnPPiixxmmaapp
	      to indicate that it can receive the drop.

	    XXmmDDRRAAGG__UUNNDDEERR__NNOONNEE
	      The drop site does not use animation effects.  A client using a
	      dynamic protocol,	may provide drag-under effects in its
	      XXmmNNddrraaggPPrroocc routine.

  XXmmNNddrraaggPPrroocc
	    Specifies the procedure that is invoked when the drop site
	    receives a crossing, motion, or operation changed message.	This
	    procedure is called	only when a dynamic protocol is	used.  The
	    type of structure whose address is passed to this procedure	is
	    XXmmDDrraaggPPrrooccCCaallllbbaacckkSSttrruucctt.  The reason sent to the procedure	is
	    one	of the following:

	    XXmmCCRR__DDRROOPP__SSIITTEE__EENNTTEERR__MMEESSSSAAGGEE

	    XXmmCCRR__DDRROOPP__SSIITTEE__LLEEAAVVEE__MMEESSSSAAGGEE

	    XXmmCCRR__DDRRAAGG__MMOOTTIIOONN__MMEESSSSAAGGEE

	    XXmmCCRR__OOPPEERRAATTIIOONN__CCHHAANNGGEEDD__MMEESSSSAAGGEE

  The drag procedure may change	the values of some members of the XXmmDDrraaggPPrroocc--
  CCaallllbbaacckkSSttrruucctt passed	to it.	After the drag procedure returns, the toolkit
  uses the final values	in initializing	some members of	the callback struct
  passed to the	appropriate callbacks of the initiator (the DragContext's
  XXmmNNddrrooppSSiitteeEEnntteerrCCaallllbbaacckk, XXmmNNddrrooppSSiitteeLLeeaavveeCCaallllbbaacckk, XXmmNNddrraaggMMoottiioonnCCaallllbbaacckk,
  or XXmmNNooppeerraattiioonnCChhaannggeeddCCaallllbbaacckk callbacks).

  XXmmNNddrrooppPPrroocc
	    Specifies the procedure that is invoked when a drop	(excluding a
	    cancel or interrupt	action)	occurs on a drop site regardless of
	    the	status of the drop site.  The type of the structure whose
	    address is passed to this procedure	is XXmmDDrrooppPPrrooccCCaallllbbaacckkSSttrruucctt.
	    The	reason sent to the procedure is	XXmmCCRR__DDRROOPP__MMEESSSSAAGGEE.

	    The	drop procedure may change the values of	some members of	the
	    XXmmDDrrooppPPrrooccCCaallllbbaacckkSSttrruucctt passed to it.  After the drop procedure
	    returns, the toolkit uses the final	values in initializing some
	    members of the XXmmDDrrooppSSttaarrttCCaallllbbaacckkSSttrruucctt passed to the
	    initiator's	drop start callbacks (the DragContext's	XXmmNNddrrooppSSttaarrtt--
	    CCaallllbbaacckk callbacks).

  XXmmNNddrrooppRReeccttaanngglleess
	    Specifies a	list of	rectangles that	describe the shape of a	drop
	    site.  The locations of the	rectangles are relative	to the origin
	    of the enclosing object.  When XXmmNNddrrooppRReeccttaanngglleess is	NULL, the
	    drop site is assumed to be the sensitive area of the enclosing
	    widget.  If	XXmmNNddrrooppSSiitteeTTyyppee	is XXmmDDRROOPP__SSIITTEE__CCOOMMPPOOSSIITTEE, this
	    resource cannot be specified by the	application.

  XXmmNNddrrooppSSiitteeAAccttiivviittyy
	    Indicates whether a	drop site is active or inactive.  The values
	    are	XXmmDDRROOPP__SSIITTEE__AACCTTIIVVEE and XXmmDDRROOPP__SSIITTEE__IINNAACCTTIIVVEE.  An active	drop
	    site can receive a drop, whereas an	inactive drop site is dor-
	    mant.  An inactive drop site is treated as if it was not a
	    registered drop site and any drag-under visuals associated with
	    entering or	leaving	the drop site do not occur.  However, it is
	    still used for clipping drag-under effects.

  XXmmNNddrrooppSSiitteeOOppeerraattiioonnss
	    Specifies the set of valid operations associated with a drop
	    site.  This	resource is a bit mask that is formed by combining
	    one	or more	of the following values	using a	bitwise	operation
	    such as inclusive OR (|): XXmmDDRROOPP__CCOOPPYY, XXmmDDRROOPP__LLIINNKK,	and
	    XXmmDDRROOPP__MMOOVVEE.  The value XXmmDDRROOPP__NNOOOOPP	for this resource indicates
	    that no operations are valid.

  XXmmNNddrrooppSSiitteeTTyyppee
	    Specifies the type of the drop site. The possible values are:

	    XXmmDDRROOPP__SSIITTEE__SSIIMMPPLLEE
	      The widget does not have any additional children that are
	      registered as drop sites.

	    XXmmDDRROOPP__SSIITTEE__CCOOMMPPOOSSIITTEE
	      The widget will have children that are registered	as drop
	      sites.

  XXmmNNiimmppoorrttTTaarrggeettss
	    Specifies the list of target atoms that this drop site accepts.

  XXmmNNnnuummDDrrooppRReeccttaanngglleess
	    Specifies the number of rectangles in the XXmmNNddrrooppRReeccttaanngglleess	list.
	    If the drop	site type is XXmmDDRROOPP__SSIITTEE__CCOOMMPPOOSSIITTEE, this resource can
	    not	be specified by	the application.

  XXmmNNnnuummIImmppoorrttTTaarrggeettss
	    Specifies the number of atoms in the target	atom list.

  Callback Information

  A pointer to the following structure is passed to the	XXmmNNddrraaggPPrroocc routine
  when the drop	site receives crossing,	motion,	or operation changed mes-
  sages.


  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;;
    TTiimmee	 _t_i_m_e_S_t_a_m_p;;
    WWiiddggeett	 _d_r_a_g_C_o_n_t_e_x_t
    PPoossiittiioonn	 _x;;
    PPoossiittiioonn	 _y;;
    uunnssiiggnneedd cchhaarr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;
    uunnssiiggnneedd cchhaarr_o_p_e_r_a_t_i_o_n;;
    uunnssiiggnneedd cchhaarr_o_p_e_r_a_t_i_o_n_s;;
    BBoooolleeaann	 _a_n_i_m_a_t_e;;
  }} XXmmDDrraaggPPrrooccCCaallllbbaacckkSSttrruucctt,, **XXmmDDrraaggPPrrooccCCaallllbbaacckk;;

  _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.

  _t_i_m_e_S_t_a_m_p   Specifies	the timestamp of the logical event.

  _d_r_a_g_C_o_n_t_e_x_t Specifies	the ID of the DragContext widget associated with the
	      transaction.

  _x	      Indicates	the x-coordinate of the	pointer	relative to the	drop
	      site.

  _y	      Indicates	the y-coordinate of the	pointer	relative to the	drop
	      site.

  _d_r_o_p_S_i_t_e_S_t_a_t_u_s
	      An IN/OUT	member that indicates whether or not a drop site is
	      valid.

	      When the _r_e_a_s_o_n is XXmmCCRR__DDRROOPP__SSIITTEE__EENNTTEERR__MMEESSSSAAGGEE or
	      XXmmCCRR__OOPPEERRAATTIIOONN__CCHHAANNGGEEDD__MMEESSSSAAGGEE, or when the reason is
	      XXmmCCRR__DDRRAAGG__MMOOTTIIOONN__MMEESSSSAAGGEE or XXmmCCRR__DDRROOPP__SSIITTEE__LLEEAAVVEE__MMEESSSSAAGGEE and
	      the pointer is not in the	same drop site as on the previous
	      invocation of the	drag procedure,	the toolkit initializes	_d_r_o_p_-
	      _S_i_t_e_S_t_a_t_u_s as follows: the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s
	      to XXmmDDRROOPP__SSIITTEE__VVAALLIIDD if the DragContext's	XXmmNNeexxppoorrttTTaarrggeettss and
	      the DropSite's XXmmNNiimmppoorrttTTaarrggeettss are compatible and if the	ini-
	      tial value of the	_o_p_e_r_a_t_i_o_n member is not	XXmmDDRROOPP__NNOOOOPP.  Other-
	      wise, the	toolkit	initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to
	      XXmmDDRROOPP__SSIITTEE__IINNVVAALLIIDD.

	      When the _r_e_a_s_o_n is XXmmCCRR__DDRRAAGG__MMOOTTIIOONN__MMEESSSSAAGGEE or
	      XXmmCCRR__DDRROOPP__SSIITTEE__LLEEAAVVEE__MMEESSSSAAGGEE and the pointer is within the same
	      drop site	as on the previous invocation of the drag procedure,
	      the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to	the value of _d_r_o_p_S_i_-
	      _t_e_S_t_a_t_u_s at the time the previous	invocation of the drag pro-
	      cedure returns.

	      The drag procedure may change the	value of this member.  After
	      the drag procedure returns, the toolkit uses the final value in
	      initializing the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of	the callback struct
	      passed to	the appropriate	callbacks of the initiator.

  _o_p_e_r_a_t_i_o_n   An IN/OUT	member that identifies an operation.

	      The toolkit initializes _o_p_e_r_a_t_i_o_n	by selecting an	operation
	      from the bitwise AND of the initial value	of the _o_p_e_r_a_t_i_o_n_s
	      member and the value of the DropSite's XXmmNNddrrooppSSiitteeOOppeerraattiioonnss
	      resource.	 The toolkit searches this set first for XXmmDDRROOPP__MMOOVVEE,
	      then for XXmmDDRROOPP__CCOOPPYY, then for XXmmDDRROOPP__LLIINNKK, and initializes
	      _o_p_e_r_a_t_i_o_n	to the first operation it finds	in the set.  If	the
	      toolkit finds none of these operations in	the set, it initial-
	      izes _o_p_e_r_a_t_i_o_n to	XXmmDDRROOPP__NNOOOOPP.

	      The drag procedure may change the	value of this member.  After
	      the drag procedure returns, the toolkit uses the final value in
	      initializing the _o_p_e_r_a_t_i_o_n member	of the callback	struct passed
	      to the appropriate callbacks of the initiator.

  _o_p_e_r_a_t_i_o_n_s  An IN/OUT	member that indicates the set of operations supported
	      for the source data.

	      If the user does not select an operation (by pressing a modif-
	      ier key),	the toolkit initializes	_o_p_e_r_a_t_i_o_n_s to the value	of
	      the DragContext's	XXmmNNddrraaggOOppeerraattiioonnss resource.  If	the user does
	      select an	operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the
	      bitwise AND of the corresponding operation and the value of the
	      DragContext's XXmmNNddrraaggOOppeerraattiioonnss resource.	 If the	resulting set
	      of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to
	      XXmmDDRROOPP__NNOOOOPP.

	      The drag procedure may change the	value of this member.  After
	      the drag procedure returns, the toolkit uses the final value in
	      initializing the _o_p_e_r_a_t_i_o_n_s member of the	callback struct
	      passed to	the appropriate	callbacks of the initiator.

  _a_n_i_m_a_t_e     An OUT member that indicates whether the toolkit or the
	      receiver client provides drag-under effects for a	valid drop
	      site.  If	_a_n_i_m_a_t_e	is set to True,	the toolkit provides drop
	      site animation per the XXmmNNaanniimmaattiioonnSSttyyllee resource	value; if it
	      is set to	False, the receiver generates drag-under animation
	      effects.

  A pointer to the following structure is passed to the	XXmmNNddrrooppPPrroocc routine
  when the drop	site receives a	drop message:


  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;;
    TTiimmee	 _t_i_m_e_S_t_a_m_p;;
    WWiiddggeett	 _d_r_a_g_C_o_n_t_e_x_t;;
    PPoossiittiioonn	 _x;;
    PPoossiittiioonn	 _y;;
    uunnssiiggnneedd cchhaarr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;
    uunnssiiggnneedd cchhaarr_o_p_e_r_a_t_i_o_n;;
    uunnssiiggnneedd cchhaarr_o_p_e_r_a_t_i_o_n_s;;
    uunnssiiggnneedd cchhaarr_d_r_o_p_A_c_t_i_o_n;;
  }} XXmmDDrrooppPPrrooccCCaallllbbaacckkSSttrruucctt,, **XXmmDDrrooppPPrrooccCCaallllbbaacckk;;

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

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

  _t_i_m_e_S_t_a_m_p   Specifies	the timestamp of the logical event.

  _d_r_a_g_C_o_n_t_e_x_t Specifies	the ID of the DragContext widget associated with the
	      transaction.

  _x	      Indicates	the x-coordinate of the	pointer	relative to the	drop
	      site.

  _y	      Indicates	the y-coordinate of the	pointer	relative to the	drop
	      site.

  _d_r_o_p_S_i_t_e_S_t_a_t_u_s
	      An IN/OUT	member that indicates whether or not a drop site is
	      valid.

	      The toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to	XXmmDDRROOPP__SSIITTEE__VVAALLIIDD if
	      the DragContext's	XXmmNNeexxppoorrttTTaarrggeettss and the DropSite's XXmmNNiimm--
	      ppoorrttTTaarrggeettss are compatible and if	the initial value of the
	      _o_p_e_r_a_t_i_o_n	member is not XXmmDDRROOPP__NNOOOOPP.  Otherwise, the toolkit
	      initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXmmDDRROOPP__SSIITTEE__IINNVVAALLIIDD.

	      The drop procedure may change the	value of this member.  After
	      the drop procedure returns, the toolkit uses the final value in
	      initializing the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of	the
	      XXmmDDrrooppSSttaarrttCCaallllbbaacckkSSttrruucctt	passed to the initiator's drop start
	      callbacks	(the DragContext's XXmmNNddrrooppSSttaarrttCCaallllbbaacckk	callbacks).

  _o_p_e_r_a_t_i_o_n   An IN/OUT	member that identifies an operation.

	      The toolkit initializes _o_p_e_r_a_t_i_o_n	by selecting an	operation
	      from the bitwise AND of the initial value	of the _o_p_e_r_a_t_i_o_n_s
	      member and the value of the DropSite's XXmmNNddrrooppSSiitteeOOppeerraattiioonnss
	      resource.	 The toolkit searches this set first for XXmmDDRROOPP__MMOOVVEE,
	      then for XXmmDDRROOPP__CCOOPPYY, then for XXmmDDRROOPP__LLIINNKK, and initializes
	      _o_p_e_r_a_t_i_o_n	to the first operation it finds	in the set.  If	it
	      finds none of these operations in	the set, it initializes
	      _o_p_e_r_a_t_i_o_n	to XXmmDDRROOPP__NNOOOOPP.

	      The drop procedure may change the	value of this member.  After
	      the drop procedure returns, the toolkit uses the final value in
	      initializing the _o_p_e_r_a_t_i_o_n member	of the XXmmDDrrooppSSttaarrttCCaallllbbaacckk--
	      SSttrruucctt passed to the initiator's drop start callbacks (the
	      DragContext's XXmmNNddrrooppSSttaarrttCCaallllbbaacckk callbacks).

  _o_p_e_r_a_t_i_o_n_s  An IN/OUT	member that indicates the set of operations supported
	      for the source data.

	      If the user does not select an operation (by pressing a modif-
	      ier key),	the toolkit initializes	_o_p_e_r_a_t_i_o_n_s to the value	of
	      the DragContext's	XXmmNNddrraaggOOppeerraattiioonnss resource.  If	the user does
	      select an	operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the
	      bitwise AND of the corresponding operation and the value of the
	      DragContext's XXmmNNddrraaggOOppeerraattiioonnss resource.	 If the	resulting set
	      of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to
	      XXmmDDRROOPP__NNOOOOPP.

	      The drop procedure may change the	value of this member.  After
	      the drop procedure returns, the toolkit uses the final value in
	      initializing the _o_p_e_r_a_t_i_o_n_s member of the	XXmmDDrrooppSSttaarrttCCaallllbbaacckk--
	      SSttrruucctt passed to the initiator's drop start callbacks (the
	      DragContext's XXmmNNddrrooppSSttaarrttCCaallllbbaacckk callbacks).

  _d_r_o_p_A_c_t_i_o_n  An IN/OUT	member that identifies the action associated with the
	      drop.  The possible values are:

	      XXmmDDRROOPP
		 A drop	was attempted.	If the drop site is valid, drop
		 transfer handling proceeds.

	      XXmmDDRROOPP__HHEELLPP
		 The user has requested	help on	the drop site.

  The drop procedure may change	the value of this member.  After the drop
  procedure returns, the toolkit uses the final	value in initializing the
  _d_r_o_p_A_c_t_i_o_n member of the XXmmDDrrooppSSttaarrttCCaallllbbaacckkSSttrruucctt passed to the
  initiator's drop start callbacks (the	DragContext's XXmmNNddrrooppSSttaarrttCCaallllbbaacckk
  callbacks).

RELATED	INFORMATION
  XXmmDDrraaggCCoonntteexxtt((33XX)), XXmmDDrraaggIIccoonn((33XX)), XXmmDDrrooppSSiitteeCCoonnffiigguurreeSSttaacckkiinnggOOrrddeerr((33XX)),
  XXmmDDrrooppSSiitteeEEnnddUUppddaattee((33XX)), XXmmDDrrooppSSiitteeQQuueerryySSttaacckkiinnggOOrrddeerr((33XX)),
  XXmmDDrrooppSSiitteeRReeggiisstteerr((33XX)), XXmmDDrrooppSSiitteeSSttaarrttUUppddaattee((33XX)), XXmmDDrrooppSSiitteeUUppddaattee((33XX)),
  XXmmDDrrooppSSiitteeUUnnrreeggiisstteerr((33XX)), XXmmDDrrooppTTrraannssffeerr((33XX)),	and
  XXmmTTaarrggeettssAArreeCCoommppaattiibbllee((33XX)).














