[Contents] [Index] [Next] [Previous]

XmGetDestination


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;

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 if the application makes this call before any of the specified operations have been performed on an editable widget.

display
Specifies 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.