


XmDropSiteRegister(3X)				       XmDropSiteRegister(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmDDrrooppSSiitteeRReeggiisstteerr - A Drag and Drop function	that identifies	a drop site
  and assigns resources	that specify its behavior

SYNOPSIS


  ##iinncclluuddee <<XXmm//DDrraaggDDrroopp..hh>>
  vvooiidd XXmmDDrrooppSSiitteeRReeggiisstteerr ((_w_i_d_g_e_t, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
       WWiiddggeett	   _w_i_d_g_e_t;;
       AArrggLLiisstt	   _a_r_g_l_i_s_t;;
       CCaarrddiinnaall	   _a_r_g_c_o_u_n_t;;

DESCRIPTION
  XXmmDDrrooppSSiitteeRReeggiisstteerr identifies	the specified widget or	gadget as a drop site
  and sets resource values that	define the drop	site's behavior.  The routine
  assigns default values to any	resources that are not specified in the	argu-
  ment list.  The toolkit generates a warning message if a drop	site is
  registered with XXmmNNddrrooppSSiitteeAAccttiivviittyy set to XXmmDDRROOPP__SSIITTEE__AACCTTIIVVEE	and the
  XXmmNNddrrooppPPrroocc resource is NULL.

  If the drop site is a	descendant of a	widget that is registered as a drop
  site,	the XXmmNNddrrooppSSiitteeTTyyppee resource of	the ancestor drop site must be speci-
  fied as XXmmDDRROOPP__SSIITTEE__CCOOMMPPOOSSIITTEE.  The ancestor must be registered before the
  descendant.  The drop	site is	stacked	above all other	sibling	drop sites
  already registered.

  _w_i_d_g_e_t Specifies the ID of the widget	to be registered.

  _a_r_g_l_i_s_tSpecifies the argument	list.

  _a_r_g_c_o_u_n_t
	 Specifies the number of attribute/value pairs in the argument list
	 (_a_r_g_l_i_s_t).

  For a	complete definition of DropSite	and its	associated resources, see
  XXmmDDrrooppSSiittee((33XX)).

RELATED	INFORMATION
  XXmmDDiissppllaayy((33XX)), XXmmDDrrooppSSiittee((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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)),
  and XXmmSSccrreeeenn((33XX)).
















