1XmDataFieldCut(library call)                      XmDataFieldCut(library call)
2
3
4

NAME

6       XmDataFieldCut — A DataField function that copies the primary selection
7       to the clipboard and deletes the selected text
8

SYNOPSIS

10       #include <Xm/DataF.h>
11       Boolean XmDataFieldCut(
12       Widget widget,
13       Time time);
14

DESCRIPTION

16       XmDataFieldCut copies the primary selected text to  the  clipboard  and
17       then  deletes  the  primary selected text.  This routine calls the wid‐
18       get's XmNvalueChangedCallback and verification callbacks,  either  XmN‐
19       modifyVerifyCallback  or  XmNmodifyVerifyCallbackWcs,  or both. If both
20       verification callback lists are registered, the procedures of the  XmN‐
21       modifyVerifyCallback  list are executed first and the resulting data is
22       passed to the XmNmodifyVerifyCallbackWcs callbacks.
23
24       This routine calls the XmNconvertCallback procedures, possibly multiple
25       times,  with the selection member of the XmConvertCallbackStruct set to
26       CLIPBOARD and with the parm member set to XmMOVE.  If the  transfer  is
27       successful,  this  routine then calls the XmNconvertCallback procedures
28       for the CLIPBOARD selection and the DELETE target.
29
30       widget    Specifies the DataField widget ID.
31
32       time      Specifies the time at which the selection value is to be mod‐
33                 ified.  This  should  be the time of the event that triggered
34                 this request.
35
36       For a complete definition of DataField and  its  associated  resources,
37       see XmDataField(3).
38

RETURN

40       This  function  returns  False if the primary selection is NULL, if the
41       widget does not own the primary selection, if the function is unable to
42       gain  ownership  of the clipboard selection, or if no data is placed on
43       the clipboard.  Otherwise, it returns True.
44
46       XmDataField(3).
47
48
49
50                                                  XmDataFieldCut(library call)
Impressum