1Tk_OwnSelection(3)           Tk Library Procedures          Tk_OwnSelection(3)
2
3
4
5______________________________________________________________________________
6

NAME

8       Tk_OwnSelection - make a window the owner of the primary selection
9

SYNOPSIS

11       #include <tk.h>
12
13       Tk_OwnSelection(tkwin, selection, proc, clientData)
14

ARGUMENTS

16       Tk_Window tkwin (in)                    Window  that  is  to become new
17                                               selection owner.
18
19       Atom selection (in)                     The name of the selection to be
20                                               owned, such as XA_PRIMARY.
21
22       Tk_LostSelProc *proc (in)               Procedure  to invoke when tkwin
23                                               loses    selection    ownership
24                                               later.
25
26       ClientData clientData (in)              Arbitrary   one-word  value  to
27                                               pass to proc.
28______________________________________________________________________________
29

DESCRIPTION

31       Tk_OwnSelection arranges for tkwin to  become  the  new  owner  of  the
32       selection  specified by the atom selection.  After this call completes,
33       future requests for the selection will be directed to handlers  created
34       for  tkwin  using Tk_CreateSelHandler.  When tkwin eventually loses the
35       selection ownership, proc will be invoked so that the window can  clean
36       itself  up  (e.g.  by  unhighlighting the selection).  Proc should have
37       arguments and result that match the type Tk_LostSelProc:
38              typedef void Tk_LostSelProc(
39                      ClientData clientData);
40       The clientData parameter to proc is a copy of the  clientData  argument
41       given  to Tk_OwnSelection, and is usually a pointer to a data structure
42       containing application-specific information about tkwin.
43

KEYWORDS

45       own, selection owner
46
47
48
49Tk                                    4.0                   Tk_OwnSelection(3)
Impressum