XmContainerCopyLink - Man Page

Container widget function to copy links to the clipboard

Synopsis

#include <Xm/Container​.h>
Boolean XmContainerCopyLink(
Widget container,
Time timestamp);

Description

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

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