XmContainerCut

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)