XmContainerCut(3X) UNIX System V XmContainerCut(3X)
NAME
XmContainerCut - Container widget function to move items to
the clipboard
SYNOPSIS
#include <Xm/Container.h>
Boolean XmContainerCut(
Widget container,
Time timestamp);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 1/22/99)