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
					       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 se-
       lection 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 ar-
       guments 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+14.3.quarterly>

home | help