About Us Documentation

Contact Site Map
 

  

WinPak
Documentation

Tk_OwnSelection





Tk_OwnSelection(3)    Tk Library Procedures                   4.0



_________________________________________________________________

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 selec- tion 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 informa- tion about tkwin.

KEYWORDS

own, selection owner Tk 1 Prepared by Ready-to-Run Software, Inc.

 

Email addresses listed on this site may  NOT be used for unsolicited commercial email.

Ready-to-Run Software, Inc Privacy Statement

Portions (c)Copyright, 1996-2005 by Ready-to-Run Software, Inc
(All rights reserved.)
212 Cedar Cove
Lansing, NY 14882
Phone: 607 533 UNIX (8649)
Fax: 607 533 4002


To return to the Ready-to-Run Software WinPak Table of contents please presshere