Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 selec-
					     tion 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 re-
     quests for the selection will be directed to handlers created for tkwin us-
     ing Tk_CreateSelHandler.  When tkwin eventually loses the selection  owner-
     ship,  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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_OwnSelection.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help