XmTextCut(3X) UNIX System V XmTextCut(3X)
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;
VERSION
This page documents version 1.2 of the Motif library.
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).
Page 1 (printed 4/30/98)