---
name: "XmContainerCopy"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmContainerCopy"
---

# XmContainerCopy(3)

Container widget function to copy primary selection to the clipboard

## NAME

**XmContainerCopy** — Container widget function to copy primary selection to the clipboard

## SYNOPSIS

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

## DESCRIPTION

**XmContainerCopy** copies the primary selected container 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 **XmCOPY**.

- *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)](/XmContainer/3.md).

## 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)](/XmContainer/3.md).