---
name: "OwnSelect"
section: "3"
platform: "macos"
package: "tcl"
version: "152"
release: "macOS 26.5"
platforms: ["macos"]
url: "https://new.carta.tech/OwnSelect/3"
---

# OwnSelect(3)

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

Window that is to become new selection owner. The name of the selection to be owned, such as XA\_PRIMARY. Procedure to invoke when *tkwin* loses selection ownership later. 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