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 selec
tion 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 win
dow can clean itself up (e.g. by unhighlighting the selec
tion). 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 client_
Data argument given to Tk_OwnSelection, and is usually a
pointer to a data structure containing application-spe
cific information about tkwin.
KEYWORDS
- own, selection owner