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

### 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_Grab, Tk_Ungrab — 応用譜内の局所把持状態を操作する manipulate grab state in an application
  SYNOPSIS
    #include <tk.h>
    int
    Tk_Grab(interp, tkwin, grabGlobal)
    void
    Tk_Ungrab(tkwin)
  引数 ARGUMENTS
    Tcl_Interp *interp (入力in)
    Tk_Window tkwin (入力in)
    int grabGlobal (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_Grab, Tk_Ungrab — 応用譜内の局所把持状態を操作する manipulate grab state in an application

### SYNOPSIS

#include <tk.h>
int
Tk_Grab(interp, tkwin, grabGlobal)
void
Tk_Ungrab(tkwin)

### 引数 ARGUMENTS

Tcl_Interp *interp (入力in)
  不都合を報告する為の解釈実行機能｡　 Interpreter to use for error reporting

Tk_Window tkwin (入力in)
  その窓の振舞いにより､指示子が局所把持されるか解放される｡　 Window on whose behalf the pointer is to be grabbed or released

int grabGlobal (入力in)
  局所把持が大局的か応用譜局所的かを指し示す論理値｡　　 Boolean indicating whether the grab is global or application local

### 説明 DESCRIPTION

これ等の函数は大域的または応用譜の局所把持の設定と解除に使われる｡把持が Tk 応用譜の特定の窓に設定された時､マウスと鍵盤の行事はその窓とその子孫からのみ受取り可能になる｡根本からの樹枝のtkwin 箇所以外の窓に就いてのマウスと鍵盤の行事は tkwin に方向変更される｡もし把持が大域的であると､全ての根本からの樹枝のtkwin 箇所以外の窓に就いてのマウスと鍵盤行事(縦え他の応用譜内の窓を企図していても)は tkwin に方向変更される｡もし把持が応用譜局所であると同じ応用譜の内部の(しかし根本からの樹枝のtkwin 箇所以外)窓を意図したマウスと鍵盤の行事だけが方向変更される｡ These functions are used to set or release a global or application local grab. When a grab is set on a particular window in a Tk application, mouse and keyboard events can only be received by that window and its descendants. Mouse and keyboard events for windows outside the tree rooted at tkwin will be redirected to tkwin. If the grab is global, then all mouse and keyboard events for windows outside the tree rooted at tkwin (even those intended for windows in other applications) will be redirected to tkwin. If the grab is application local, only mouse and keyboard events intended for a windows within the same application (but outside the tree rooted at tkwin) will be redirected.

Tk_Grab は特定の窓に把持を設定する｡ tkwin はその為に指示子が把持された窓を指定する｡ GrabGlobal は把持が大域か応用譜局所かを指し示す; それが非零の場合把持は大域であることを意味する｡通常､ Tk_Grab は TCL_OK を返す; もし不都合が生じ､把持が設定できないと TCL_ERROR が返され､不都合伝言文が解釈実行機能 interp の結果に残される｡一たびこれが成功裏に完結すると､根本からの樹枝のtkwin 箇所以外の窓は次の Tk_Ungrab 迄指示子関連又は鍵盤関連の行事を受取らない｡もし以前の把持が応用譜内で有効の場合､新しいものに置換えられる｡ Tk_Grab sets a grab on a particular window. Tkwin specifies the window on whose behalf the pointer is to be grabbed. GrabGlobal indicates whether the grab should be global or application local; if it is non-zero, it means the grab should be global. Normally, Tk_Grab returns TCL_OK; if an error occurs and the grab cannot be set, TCL_ERROR is returned and an error message is left if interp's result. Once this call completes successfully, no window outside the tree rooted at tkwin will receive pointer- or keyboard-related events until the next call to Tk_Ungrab. If a previous grab was in effect within the application, then it is replaced with a new one.

Tk_Ungrab はマウス指示子と鍵盤の把持が tkwin によって与えられる窓に設定されている場合は､解除する｡一たび把持が解除されると指示子と鍵盤行事は再び他の窓に引渡される｡ Tk_Ungrab releases a grab on the mouse pointer and keyboard, if there is one set on the window given by tkwin. Once a grab is released, pointer and keyboard events will start being delivered to other windows again.

### KEYWORDS

grab, window
Copyright © 1998-2000 by Scriptics Corporation.