Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
Tk_ClipboardClear(3)	     Tk	Library	Procedures	  Tk_ClipboardClear(3)


       Tk_ClipboardClear, Tk_ClipboardAppend - Manage the clipboard

       #include	<tk.h>

       Tk_ClipboardClear(interp, tkwin)

       Tk_ClipboardAppend(interp, tkwin, target, format, buffer)

       Tcl_Interp *interp (in)		     Interpreter  to use for reporting

       Tk_Window tkwin (in)		     Window that determines which dis-
					     play's clipboard to manipulate.

       Atom target (in)			     Conversion	 type  for  this clip-
					     board item;  has same meaning  as
					     target  argument to Tk_CreateSel-

       Atom format (in)			     Representation to use  when  data
					     is	 retrieved;   has same meaning
					     as	format argument	to  Tk_Create-

       const char *buffer (in)		     Null terminated string containing
					     the data to be  appended  to  the

       These  two  procedures  manage  the clipboard for Tk.  The clipboard is
       typically managed  by  calling  Tk_ClipboardClear  once,	 then  calling
       Tk_ClipboardAppend to add data for any number of	targets.

       Tk_ClipboardClear  claims  the  CLIPBOARD  selection and	frees any data
       items previously	stored on the clipboard	in this	application.  It  nor-
       mally  returns  TCL_OK, but if an error occurs it returns TCL_ERROR and
       leaves an error message in interpreter interp's result.	 Tk_Clipboard-
       Clear  must be called before a sequence of Tk_ClipboardAppend calls can
       be issued.

       Tk_ClipboardAppend appends a buffer of  data  to	 the  clipboard.   The
       first  buffer for a given target	determines the format for that target.
       Any successive appends for that target must have	the same format	or  an
       error  will be returned.	 Tk_ClipboardAppend returns TCL_OK if the buf-
       fer is successfully copied onto the clipboard.  If the clipboard	is not
       currently  owned	 by  the application, either because Tk_ClipboardClear
       has not been called or because ownership	of the clipboard  has  changed
       since  the  last	 call to Tk_ClipboardClear, Tk_ClipboardAppend returns
       TCL_ERROR and leaves an error message in	the result of interpreter  in-

       In order	to guarantee atomicity,	no event handling should occur between
       Tk_ClipboardClear and the following Tk_ClipboardAppend calls (otherwise
       someone	could retrieve a partially completed clipboard or claim	owner-
       ship away from this application).

       Tk_ClipboardClear  may  invoke  callbacks,  including   arbitrary   Tcl
       scripts,	 as a result of	losing the CLIPBOARD selection,	so any calling
       function	should take care to be re-entrant at the  point	 Tk_Clipboard-
       Clear is	invoked.

       append, clipboard, clear, format, type

Tk				      4.0		  Tk_ClipboardClear(3)


Want to link to this manual page? Use this URL:

home | help