XmTextPaste(3X)

     NAME
          XmTextPaste - A Text function that inserts the clipboard
          selection

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

     VERSION
          This page documents Motif 2.1.

     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
          XmNmodifyVerifyCallbackWcscallbacks.  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
          XmDestinationCallbackStructset 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).