Tk_OwnSelection - make a window the owner of the primary selection
#include <tk.h> Tk_OwnSelection(tkwin, selection, proc, clientData)
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
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk 4.0 Tk_OwnSelection(3tk)