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

XmTextCut


NAME

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

SYNOPSIS

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

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(3X).

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.

RELATED INFORMATION

XmText(3X).