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

# XmClipboardUnlock(3)

A clipboard function that unlocks the clipboard

## NAME

**XmClipboardUnlock** — A clipboard function that unlocks the clipboard

## SYNOPSIS

```
#include <Xm/CutPaste.h>
int XmClipboardUnlock (display, window, remove_all_locks)
        Display * display;
        Window  window;
        Boolean remove_all_locks;
(void)
```

## DESCRIPTION

**XmClipboardUnlock** unlocks the clipboard, enabling it to be accessed by other applications.

If multiple calls to **XmClipboardLock** have occurred, the same number of calls to **XmClipboardUnlock** is necessary to unlock the clipboard, unless *remove\_all\_locks* is set to True.

- *display*

  Specifies a pointer to the **Display** structure that was returned in a previous call to **XOpenDisplay** or **XtDisplay**.

- *window*

  Specifies the window ID of a widget that relates the application window to the clipboard. The widget's window ID can be obtained through **XtWindow**. The same application instance should pass the same window ID to each of the clipboard functions that it calls.

- *remove\_all\_locks*

  When True, indicates that all nested locks should be removed. When False, indicates that only one level of lock should be removed.

## RETURN

- **XmClipboardSuccess**

  The function was successful.

- **XmClipboardFail**

  The function failed because the clipboard was not locked or was locked by another application.

## RELATED

[**XmClipboardCancelCopy**(3)](/XmClipboardCancelCopy/3.md), [**XmClipboardCopy**(3)](/XmClipboardCopy/3.md), [**XmClipboardEndCopy**(3)](/XmClipboardEndCopy/3.md), [**XmClipboardEndRetrieve**(3)](/XmClipboardEndRetrieve/3.md), [**XmClipboardInquireCount**(3)](/XmClipboardInquireCount/3.md), [**XmClipboardInquireFormat**(3)](/XmClipboardInquireFormat/3.md), [**XmClipboardInquireLength**(3)](/XmClipboardInquireLength/3.md), [**XmClipboardInquirePendingItems**(3)](/XmClipboardInquirePendingItems/3.md), [**XmClipboardLock**(3)](/XmClipboardLock/3.md), [**XmClipboardRegisterFormat**(3)](/XmClipboardRegisterFormat/3.md), [**XmClipboardRetrieve**(3)](/XmClipboardRetrieve/3.md), [**XmClipboardStartCopy**(3)](/XmClipboardStartCopy/3.md), [**XmClipboardStartRetrieve**(3)](/XmClipboardStartRetrieve/3.md), [**XmClipboardUndoCopy**(3)](/XmClipboardUndoCopy/3.md), and [**XmClipboardWithdrawFormat**(3)](/XmClipboardWithdrawFormat/3.md).