XmContainerCopyLink






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.



     XmContainer(3).