NAME
XmTextFieldCut — A TextField function that copies the primary selection
to the clipboard and deletes the selected text
SYNOPSIS
#include <Xm/TextF.h>
Boolean XmTextFieldCut(
Widget widget,
Time time);
DESCRIPTION
XmTextFieldCut 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.
This routine calls the XmNconvertCallback procedures, possibly multiple
times, with the selection member of the XmConvertCallbackStruct set to
CLIPBOARD and with the parm member set to XmMOVE. If the transfer is
successful, this routine then calls the XmNconvertCallback procedures
for the CLIPBOARD selection and the DELETE target.
widget Specifies the TextField widget ID.
time Specifies the time at which the selection value is to be
modified. This should be the time of the event that triggered
this request.
For a complete definition of TextField and its associated resources,
see XmTextField(3).
RETURN
This function returns False if the primary selection is NULL, if the
widget does not own the primary selection, if the function is unable to
gain ownership of the clipboard selection, or if no data is placed on
the clipboard. Otherwise, it returns True.
RELATED
XmTextField(3).
XmTextFieldCut(library call)