XmGetDestination(3X)

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

SYNOPSIS
     #include <Xm/Xm.h>

     Widget XmGetDestination (display)
          Display   *display;


VERSION
     This page documents version 1.2 of the Motif library.

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  des-
     tination is NULL if the application makes this call before any of the spec-
     ified operations have been performed on an editable widget.


     displaySpecifies 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.

                                                            XmGetDestination(3X)