tk_clearselection(3tk) [opensolaris man page]

Tk_ClearSelection(3TK)					       Tk Library Procedures					    Tk_ClearSelection(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_ClearSelection - Deselect a selection

SYNOPSIS

       #include <tk.h>

       Tk_ClearSelection(tkwin, selection)

ARGUMENTS

       Tk_Window   tkwin   (in)      The selection will be cleared from the display containing this window.

       Atom	   selection(in)     The name of selection to be cleared.
_________________________________________________________________

DESCRIPTION

       Tk_ClearSelection  cancels  the	selection  specified by the atom selection for the display containing tkwin.  The selection need not be in
       tkwin itself or even in tkwin's application.  If there is a window anywhere on tkwin's display that owns  selection,  the  window  will	be
       notified and the selection will be cleared.  If there is no owner for selection on the display, then the procedure has no effect.

KEYWORDS

       clear, selection

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk									4.0						    Tk_ClearSelection(3TK)

Tk_OwnSelection(3)					       Tk Library Procedures						Tk_OwnSelection(3)

__________________________________________________________________________________________________________________________________________________

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  struc-
       ture containing application-specific information about tkwin.

KEYWORDS

       own, selection owner

Tk									4.0							Tk_OwnSelection(3)