This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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)