hpux man page for xmtextfieldcut

XmTextFieldCut(library call)											      XmTextFieldCut(library call)

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 wid-
       get'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 proce-
       dures 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)