Tk_ClipboardClear, Tk_ClipboardAppend - Manage the clipboard

SYNOPSIS

       #include <tk.h>

       int
       Tk_ClipboardClear(interp, tkwin)

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

ARGUMENTS

       Tcl_Interp          *interp (in)      Interpreter  to use for reporting
                                             errors.

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

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

       char                *buffer (in)      Null terminated string containing
                                             the data to be  appended  to  the
                                             clipboard.
_________________________________________________________________

DESCRIPTION

       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 interp->result.  Tk_ClipboardClear  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
       buffer  is successfully copied onto the clipboard.  If the clipboard is
       not currently owned by the application,  either  because  Tk_Clipboard-
       Clear  has  not  been  called or because ownership of the clipboard has

KEYWORDS

       append, clipboard, clear, format, type



Tk                                    4.0                 Tk_ClipboardClear(3)