Tk_OwnSelection(3) Tk Library Procedures Tk_OwnSelection(3)

____________________________________________________________________________

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

Tk 4.0 Tk_OwnSelection(3)