Copyright (c) 1990-1994 The Regents of the University of California.
Copyright (c) 1994-1996 Sun Microsystems, Inc.
See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.
RCS: @(#) $Id$
.so man.macros
Tk_OwnSelection 3 4.0 Tk "Tk Library Procedures"
S NAME
Tk_OwnSelection - make a window the owner of the primary selection
SYNOPSIS
#include <tk.h> Tk_OwnSelection(tkwin, selection, proc, clientData)ARGUMENTS.AS Tk_LostSelProc clientData .AP Tk_Window tkwin in Window that is to become new selection owner. .AP Atom selection in The name of the selection to be owned, such as XA_PRIMARY. .AP Tk_LostSelProc *proc in Procedure to invoke when tkwin loses selection ownership later. .AP ClientData clientData in Arbitrary one-word value to pass to proc. EDESCRIPTIONTk_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: .CS typedef void Tk_LostSelProc(ClientData clientData); .CE 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.
KEYWORDSown, selection owner