---
name: "OwnSelect"
section: "3tk"
platform: "linux"
package: "tk8.3-doc"
version: "8.3.5-14"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/OwnSelect/3tk"
---

# OwnSelect(3tk)

make a window the owner of the primary selection

```

```

## NAME

Tk\_OwnSelection - make a window the owner of the primary selection

## SYNOPSIS

```
#include <tk.h>

Tk_OwnSelection(tkwin, selection, proc, clientData)
```

## ARGUMENTS

- Tk\_Window *tkwin* (in)

  Window that is to become new selection owner.

- Atom *selection* (in)

  The name of the selection to be owned, such as XA\_PRIMARY.

- Tk\_LostSelProc *\*proc* (in)

  Procedure to invoke when *tkwin* loses selection ownership later.

- ClientData *clientData* (in)

  Arbitrary one-word value to pass to *proc*.

  ```

  ```

## DESCRIPTION

**Tk\_OwnSelection** arranges for *tkwin* to become the new owner of the selection specified by the atom *selection*.  After this call completes, future requests for the selection will be directed to handlers created for *tkwin* using **Tk\_CreateSelHandler**.  When *tkwin* eventually loses the selection ownership, *proc* will be invoked so that the window can clean itself up (e.g. by unhighlighting the selection).  *Proc* should have arguments and result that match the type **Tk\_LostSelProc**:

```
typedef void Tk_LostSelProc(ClientData clientData);
```

The *clientData* parameter to *proc* is a copy of the *clientData* argument given to **Tk\_OwnSelection**, and is usually a pointer to a data structure containing application-specific information about *tkwin*.

## KEYWORDS

own, selection owner