XmContainerCopyLink — Container widget function to copy links to
the clipboard
#include <Xm/Container.h>
Boolean XmContainerCopyLink(
Widget container,
Time timestamp);
XmContainerCopyLink copies links to 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 XmLINK. The Container widget itself does not
copy any links; XmNconvertCallback procedures are responsible for
copying the link to the clipboard and for taking any related actions.
- 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).
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.