Tk_OwnSelection(3)

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 selec-
     tion  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 informa-
     tion about tkwin.

KEYWORDS

     own, selection owner

Tk                      Last change: 4.0                        1