redhat man page for xmcontainercopylink

XmContainerCopyLink(library call)										 XmContainerCopyLink(library call)

NAME
       XmContainerCopyLink -- 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.

RELATED
       XmContainer(3).

														 XmContainerCopyLink(library call)