Ubuntu Manpage: Tk_OwnSelection - make a window the owner of the primary selection

name
synopsis
arguments
description
keywords

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