


XmGetDestination(3X)					 XmGetDestination(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmGGeettDDeessttiinnaattiioonn - A function	that returns the widget	ID of the widget to
  be used as the current destination for quick paste and certain clipboard
  operations

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  WWiiddggeett XXmmGGeettDDeessttiinnaattiioonn ((_d_i_s_p_l_a_y))
       DDiissppllaayy	 *_d_i_s_p_l_a_y;;

DESCRIPTION
  XXmmGGeettDDeessttiinnaattiioonn returns the widget that is the current destination on the
  specified display.  The destination is generally the last editable widget
  on which a select, edit, insert, or paste operation was performed and	is
  the destination for quick paste and certain clipboard	functions.  The	des-
  tination is NULL if the application makes this call before any of the
  specified operations have been performed on an editable widget.

  _d_i_s_p_l_a_ySpecifies the display whose destination widget	is to be queried

RETURN VALUE
  Returns the widget ID	for the	current	destination or NULL if there is	no
  current destination.

































