'\" 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" "library call"

.SH "NAME"

\fBXmDataFieldCut\fP \(em A DataField function that copies the primary selection to the clipboard and deletes the selected text

.iX "XmDataFieldCut"

.iX "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