NAME

       XmTextPaste  —  A  Text  function that inserts the clipboard selection "XmTextPaste" "Text
       functions" "XmTextPaste"

SYNOPSIS

       #include <Xm/Text.h>
       Boolean XmTextPaste(
       Widget widget);

DESCRIPTION

       XmTextPaste inserts the clipboard selection at the insertion  cursor  of  the  destination
       widget.   If  XmNpendingDelete  is  True  and  the  insertion cursor is inside the current
       selection, the clipboard selection replaces the selected text.

       This routine calls the widget's XmNvalueChangedCallback and verification callbacks, either
       XmNmodifyVerifyCallback  or  XmNmodifyVerifyCallbackWcs,  or  both.  If  both verification
       callback lists are registered, the procedures  of  the  XmNmodifyVerifyCallback  list  are
       executed  first  and  the  resulting  data  is  passed  to  the XmNmodifyVerifyCallbackWcs
       callbacks.  If the XmNcursorPosition resource is greater than or is the same value as  the
       position where the selection is to be inserted, the XmNmotionVerifyCallback is called.

       This  routine  calls  the  widget's  XmNdestinationCallback  procedures with the selection
       member of the XmDestinationCallbackStruct set to CLIPBOARD and with the  operation  member
       set to XmCOPY.

       widget    Specifies the Text widget ID.

       For a complete definition of Text and its associated resources, see XmText(3).

RETURN

       This function returns False if no transfers take place.  Otherwise, it returns True.

RELATED

       XmText(3).

                                                                                   XmTextPaste(3)