#  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.
#
#

=head1 NAME

Tk_OwnSelection - make a window the owner of the primary selection

=for category C Programming

=head1 SYNOPSIS

B<#include E<lt>tk.hE<gt>>

B<Tk_OwnSelection>(I<tkwin, selection, proc, clientData>)

=head1 ARGUMENTS

=over 4

=item Tk_Window tkwin (in)

Window that is to become new selection owner.

=item Atom selection (in)

The name of the selection to be owned, such as XA_PRIMARY.

=item Tk_LostSelProc *proc (in)

Procedure to invoke when I<tkwin> loses selection ownership later.

=item ClientData clientData (in)

Arbitrary one-word value to pass to I<proc>.

=back

=head1 DESCRIPTION

B<Tk_OwnSelection> arranges for I<tkwin> to become the
new owner of the selection specified by the atom
I<selection>.  After this call completes, future requests
for the selection will be directed to handlers created for
I<tkwin> using B<Tk_CreateSelHandler>.  When I<tkwin>
eventually loses the selection ownership, I<proc> will be
invoked so that the window can clean itself up (e.g. by
unhighlighting the selection).  I<Proc> should have arguments and
result that match the type B<Tk_LostSelProc>:

 typedef void Tk_LostSelProc(ClientData clientData);

The I<clientData> parameter to I<proc> is a copy of the
I<clientData> argument given to B<Tk_OwnSelection>, and is
usually a pointer to a data structure containing application-specific
information about I<tkwin>.

=head1 KEYWORDS

own, selection owner