Scroll to navigation

Tk_OwnSelection(3tk) Tk Library Procedures Tk_OwnSelection(3tk) 


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



  

    4.0
    Tk