XmContainerCut - Man Page

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​.