## Tcl8.6.17/Tk8.6.17 Documentation > Tk C API > Clipboard

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    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)
    Tk_Window tkwin (入力in)
    Atom target (入力in)
    Atom format (入力in)
    const char *buffer (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

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 display's clipboard to manipulate.

Atom target (入力in)
  この臨時板項目の為の変換型; Tk_CreateSelHandler への target 引数としての同じ意味を有する｡　 Conversion type for this clipboard item; has same meaning as target argument to Tk_CreateSelHandler.

Atom format (入力in)
  データが取戻された時に使う表現; Tk_CreateSelHandler への書式引数としての同じ意味を有する｡　 Representation to use when data is retrieved; has same meaning as format argument to Tk_CreateSelHandler.

const char *buffer (入力in)
  臨時板に追記されるデータを含むヌル端末文字列｡　 Null terminated string containing the data to be appended to the clipboard.

### 説明 DESCRIPTION

Tk の為に二つの手続函数は臨時板を管理している｡臨時板は典型的には一度 Tk_ClipboardClear を呼ぶことにより管理され､次に Tk_ClipboardAppend を呼んで幾つの数の目標についてもデータを加える｡ 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 は CLIPBOARD の選択を宣言し､その応用譜内で以前に臨時板に保存されていたどの品目も解放する｡それは通常 TCL_OK を返すが､不都合が生じると TCL_ERROR を返し不都合伝言文を解釈実行機能 interp の結果に残す｡Tk_ClipboardClear は Tk_ClipboardAppend 呼出の並びが発信される前に呼ばれなければならない｡ Tk_ClipboardClear claims the CLIPBOARD selection and frees any data items previously stored on the clipboard in this application. It normally returns TCL_OK, but if an error occurs it returns TCL_ERROR and leaves an error message in interpreter interp's result. Tk_ClipboardClear must be called before a sequence of Tk_ClipboardAppend calls can be issued.

Tk_ClipboardAppend は臨時板に緩衝域のデータを追記する｡ target として与えられた最初の緩衝域はその target への書式を定める｡その target の為の引続くどの様な追記も同じ書式でなければならず､それ以外は不都合が返される｡Tk_ClipboardAppend は緩衝域が成功裏に臨時板上に複写されると TCL_OK を返す｡ Tk_ClipboardClear が呼ばれていないためか､最後の Tk_ClipboardClear 呼出し以降に臨時板の所有が変更されたかのために､臨時板が現在その応用譜に所有されていない場合､ Tk_ClipboardAppend は TCL_ERROR を返し不都合伝言文を解釈実行機能 interp の結果に残す｡ 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_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 interp.

自動的に補償される為に Tk_ClipboardClear とそれに続く Tk_ClipboardAppend 呼出しの間には､行事処理は生じるべきではない(さもないと､誰かが部分的に完成した臨時板を取出すことかできたり､この応用譜から所有権放棄を宣言できたりする)｡ 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 ownership away from this application).

Tk_ClipboardClear は CLIPBOARD 選択の喪失の結果として､任意の Tcl 記述譜を含む呼戻しを起動でき､故､函数呼出しは Tk_ClipboardClear が起動された時点の再起には注意が必要である｡ 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_ClipboardClear is invoked.

### KEYWORDS

append, clipboard, clear, format, type
Copyright © 1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.