'\" t
.\" TxtFieAE.sgm /main/8 1996/09/08 21:12:52 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmDataFieldCut" 3
.SH "NAME"
\fBXmDataFieldCut\fP \(em A DataField function that copies the primary selection to the clipboard and deletes the selected text
"XmDataFieldCut"
"DataField functions" "XmDataFieldCut"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/DataF\&.h>
\fBBoolean \fBXmDataFieldCut\fP\fR(
\fBWidget \fBwidget\fR\fR,
\fBTime \fBtime\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmDataFieldCut\fP copies the primary selected text to the clipboard and
then deletes the primary selected text\&.
This routine calls the widget\&'s \fBXmNvalueChangedCallback\fP and
verification callbacks, either \fBXmNmodifyVerifyCallback\fP or
\fBXmNmodifyVerifyCallbackWcs\fP, or both\&. If both verification
callback lists are registered, the procedures of the
\fBXmNmodifyVerifyCallback\fP list are executed first and the resulting
data is passed to the \fBXmNmodifyVerifyCallbackWcs\fP callbacks\&.
.PP
This routine calls the \fBXmNconvertCallback\fP procedures, possibly
multiple times, with the \fIselection\fP member of the
\fBXmConvertCallbackStruct\fR set to \fBCLIPBOARD\fP and with the
\fIparm\fP member set to \fBXmMOVE\fP\&.
If the transfer is successful, this routine then calls the
\fBXmNconvertCallback\fP procedures for the \fBCLIPBOARD\fP selection
and the \fBDELETE\fP target\&.
.IP "\fIwidget\fP" 10
Specifies the DataField widget ID\&.
.IP "\fItime\fP" 10
Specifies the time at which the selection value is to be modified\&. This
should be the time of the event that triggered this request\&.
.PP
For a complete definition of DataField and its associated resources, see
\fBXmDataField\fP(3)\&.
.SH "RETURN"
.PP
This function returns False if the primary selection is NULL, if the
\fIwidget\fP 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\&.
.SH "RELATED"
.PP
\fBXmDataField\fP(3)\&.
.\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:34