XmContainerCut(library call) XmContainerCut(library call)
NAME
XmContainerCut -- Container widget function to move items to the
clipboard
SYNOPSIS
#include <Xm/Container.h>
Boolean XmContainerCut(
Widget container,
Time timestamp);
DESCRIPTION
XmContainerCut cuts the primary selected items to the clipboard.
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 procedures for the
CLIPBOARD selection and the
DELETE target.
container Specifies the Container widget ID.
timestamp Specifies the server time at which to modify the selection
value.
For a complete definition of Container and its associated resources,
see
XmContainer(3).
RETURN
The function returns False in the following cases: if the primary
selection is NULL, if the widget does not own the primary selection,
or if the function is unable to gain ownership of the clipboard
selection. Otherwise, it returns True.
RELATED
XmContainer(3).
XmContainerCut(library call)