XmContainerCopyLink(3X)



     XmContainerCopyLink(3X)   UNIX System V   XmContainerCopyLink(3X)



     NAME
          XmContainerCopyLink - Container widget function to copy
          links to the clipboard

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

     VERSION
          This page documents Motif 2.1.

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














     Page 1                                          (printed 1/22/99)
Museum
