NAME

       XmGetDestination  —  A function that returns the widget ID of the widget to be used as the
       current destination for quick paste and certain clipboard operations "XmGetDestination"

SYNOPSIS

       #include <Xm/Xm.h>
       Widget XmGetDestination(
       Display *display);

DESCRIPTION

       XmGetDestination 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 destination is NULL until a keyboard or mouse operation
       has been done on an  editable  widget.  Refer  to  the  Motif  Programmer's  Guide  for  a
       description of keyboard focus.

       display   Specifies the display whose destination widget is to be queried

RETURN

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

                                                                              XmGetDestination(3)