Museum

 XmTextCut(Xm)                  6 January 1993                  XmTextCut(Xm)


 Name

    XmTextCut - a Text function that copies the primary selection to the
    clipboard and deletes the selected text

 Syntax


    #include <Xm/Text.h>

    Boolean XmTextCut (widget, time)
    Widget widget;
    Time time;


 Description

    XmTextCut copies the primary selected text to the clipboard and then
    deletes the primary selected text. This routine calls the widget's
    XmNvalueChangedCallback and verification callbacks, either XmNmodifyVeri-
    fyCallback or XmNmodifyVerifyCallbackWcs, or both. If both verification
    callback lists are registered, the procedures of the XmNmodifyVerifyCall-
    back list are executed first and the resulting data is passed to the
    XmNmodifyVerifyCallbackWcs callbacks.

    widget  Specifies the Text widget ID.

    time    Specifies the server time at which the selection value is to be
            modified. This should be the time of the event which triggered
            this request.  One source of a valid time stamp is the function
            XtLastTimestampProcessed().

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

 Return value

    This function returns False if the primary selection is NULL, if the
    widget doesn't own the primary selection, or if the function is unable to
    gain ownership of the clipboard selection. Otherwise, it returns True.

 See also

    XmText(Xm)