1XmTextCut(library call) XmTextCut(library call)
2
3
4
6 XmTextCut — A Text function that copies the primary selection to the
7 clipboard and deletes the selected text
8
10 #include <Xm/Text.h>
11 Boolean XmTextCut(
12 Widget widget,
13 Time time);
14
16 XmTextCut copies the primary selected text to the clipboard and then
17 deletes the primary selected text. This routine calls the widget's
18 XmNvalueChangedCallback and verification callbacks, either XmNmodi‐
19 fyVerifyCallback or XmNmodifyVerifyCallbackWcs, or both. If both veri‐
20 fication callback lists are registered, the procedures of the XmNmodi‐
21 fyVerifyCallback 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 Text widget ID.
31
32 time Specifies the server time at which the selection value is to
33 be modified. This should be the time of the event that trig‐
34 gered this request. One source of a valid time stamp is the
35 function XtLastTimestampProcessed().
36
37 For a complete definition of Text and its associated resources, see
38 XmText(3).
39
41 This function returns False if the primary selection is NULL, if the
42 widget does not own the primary selection, if the function is unable to
43 gain ownership of the clipboard selection, or if no data is placed on
44 the clipboard. Otherwise, it returns True.
45
47 XmText(3).
48
49
50
51 XmTextCut(library call)