OwnSelect.3
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:2k
- '"
- '" 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: OwnSelect.3,v 1.2 1998/09/14 18:22:53 stanton Exp $
- '"
- .so man.macros
- .TH Tk_OwnSelection 3 4.0 Tk "Tk Library Procedures"
- .BS
- .SH NAME
- Tk_OwnSelection - make a window the owner of the primary selection
- .SH SYNOPSIS
- .nf
- fB#include <tk.h>fR
- .sp
- fBTk_OwnSelectionfR(fItkwin, selection, proc, clientDatafR)
- .SH 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 fItkwinfR loses selection ownership later.
- .AP ClientData clientData in
- Arbitrary one-word value to pass to fIprocfR.
- .BE
- .SH DESCRIPTION
- .PP
- fBTk_OwnSelectionfR arranges for fItkwinfR to become the
- new owner of the selection specified by the atom
- fIselectionfR. After this call completes, future requests
- for the selection will be directed to handlers created for
- fItkwinfR using fBTk_CreateSelHandlerfR. When fItkwinfR
- eventually loses the selection ownership, fIprocfR will be
- invoked so that the window can clean itself up (e.g. by
- unhighlighting the selection). fIProcfR should have arguments and
- result that match the type fBTk_LostSelProcfR:
- .CS
- typedef void Tk_LostSelProc(ClientData fIclientDatafR);
- .CE
- The fIclientDatafR parameter to fIprocfR is a copy of the
- fIclientDatafR argument given to fBTk_OwnSelectionfR, and is
- usually a pointer to a data structure containing application-specific
- information about fItkwinfR.
- .SH KEYWORDS
- own, selection owner