[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmContainerCopyLink

Container widget function to copy links to the clipboard

Format

#include <Xm/Container.h>
Boolean XmContainerCopyLink
Widget
containerTime 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).


[ Previous | Next | Contents | Glossary | Home | Search ]