HPUX OwnSelect[3]

 Tk_OwnSelection(3)                  Tk                   Tk_OwnSelection(3)

 Tk Library Procedures                                 Tk Library Procedures





 ___________________________________________________________________________

 NAME
      Tk_OwnSelection - make a window the owner of the primary selection

 SYNOPSIS
      #include <tk.h>

      Tk_OwnSelection(tkwin, proc, clientData)

 ARGUMENTS
      Tk_Window        tkwin        (in)      Window that is to  become  new
                                              selection owner.

      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
      primary 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.

      Once a window has become selection owner, it will remain  owner  until
      either  the  window  is  deleted  or  until  some  other window claims
      ownership.  There is no way for a window to disavow ownership  of  the
      selection once it has received it.


 KEYWORDS
      own, selection owner








                                    - 1 -        Formatted:  August 11, 1996