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)