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
30

DESCRIPTION

32       Tk_OwnSelection arranges for tkwin to  become  the  new  owner  of  the
33       selection  specified by the atom selection.  After this call completes,
34       future requests for the selection will be directed to handlers  created
35       for  tkwin  using Tk_CreateSelHandler.  When tkwin eventually loses the
36       selection ownership, proc will be invoked so that the window can  clean
37       itself  up  (e.g.  by  unhighlighting the selection).  Proc should have
38       arguments and result that match the type Tk_LostSelProc:
39              typedef void Tk_LostSelProc(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
44

KEYWORDS

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