## Tcl8.6.17/Tk8.6.17 Documentation > Tk Commands > tk

### 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 — 内部状態の操作　Manipulate Tk internal state
  構文 SYNOPSIS
  説明 DESCRIPTION
    tk appname ?newName?
    tk busy subcommand ...
    tk caret window ?-x x? ?-y y? ?-height height?
    tk inactive ?-displayof window? ?reset?
    tk fontchooser subcommand ...
    tk scaling ?-displayof window? ?number?
    tk useinputmethods ?-displayof window? ?boolean?
    tk windowingsystem
  SEE ALSO
  KEYWORDS

### NAME

tk — 内部状態の操作　Manipulate Tk internal state

### 構文 SYNOPSIS

tk option ?arg ...?

### 説明 DESCRIPTION

tk 命令は様々な Tk の 内部状態の要素の利用を提供する｡この命令により操作される大部分の情報は個別の窓よりも､応用譜全体に関するか画面や表示装置に関する｡この命令は option 引数に依存して幾つでも異なる形式をとる｡適正な形式は次の通り: The tk command provides access to miscellaneous elements of Tk's internal state. Most of the information manipulated by this command pertains to the application as a whole, or to a screen or display, rather than to a particular window. The command can take any of a number of different forms depending on the option argument. The legal forms are:

tk appname ?newName?
  もし newName が指定されないとこの命令は応用譜の名前を返す(応用譜と通信する為に send 命令中で使用できる名前)｡もし newName が指定されると応用譜の名前が newName に変化する｡もし与えられた名前が既に使用されていると重複を避ける為に “ #2” や “ #3” の接尾辞が追加される｡命令の結果は実際に選択した名前である｡ newName は大文字で始まるべきではない｡大文字で始まる名前は級であると仮定され､指示項目の処理に干渉する; 結果として Tk は応用譜のためのなにかの指示項目を見付けられないかもしれない｡もし send 命令の削除によって sends が不可能になっている場合､この命令はそれを再可能にし､ send 命令を再生成する｡ If newName is not specified, this command returns the name of the application (the name that may be used in send commands to communicate with the application). If newName is specified, then the name of the application is changed to newName. If the given name is already in use, then a suffix of the form “ #2” or “ #3” is appended in order to make the name unique. The command's result is the name actually chosen. newName should not start with a capital letter. This will interfere with option processing, since names starting with capitals are assumed to be classes; as a result, Tk may not be able to find some options for the application. If sends have been disabled by deleting the send command, this command will reenable them and recreate the send command.

tk busy subcommand ...
  この命令は窓の階層構造の印を “作業中” として制御する､何か他の操作の処理中に非対話式に演出する｡更なる詳細は取扱説明書の busy の頁を参照されたい｡ This command controls the marking of window hierarchies as “busy”, rendering them non-interactive while some other operation is proceeding. For more details see the busy manual page.

tk caret window ?-x x? ?-y y? ?-height height?
  指定された Tk 窓 window の表示の為に挿入印の位置を設定､問合せする｡挿入印は大域の注目を指し示す為に使われる表示による遊走子位置である(譬えばマイクロソフト社の利用可能規則に遵じて)､丁度､入力箇所に窓が開く XIM (Unxの入力用機能のX Input Methods)やマイクロソフト社の漢字入力機能と同じようである｡もし指示項目が指定されないと､挿入印に使用された最後の値が 指示項目-値対形式で返される｡ -x と -y は窓に対する相対値を表し､ -height は現在の遊走子の位置の高さか何も与えられないと指定された窓の高さである｡(訳註 IME Input Method Editorマイクロソフト社漢字入力機能) Sets and queries the caret location for the display of the specified Tk window window. The caret is the per-display cursor location used for indicating global focus (e.g. to comply with Microsoft Accessibility guidelines), as well as for location of the over-the-spot XIM (X Input Methods) or Windows IME windows. If no options are specified, the last values used for setting the caret are return in option-value pair format. -x and -y represent window-relative coordinates, and -height is the height of the current cursor location, or the height of the specified window if none is given.

tk inactive ?-displayof window? ?reset?
  使用者が最後に系と相互疎通をしてからの千分の１秒単位の時間を正の整数として返す｡もし -displayof 指示項目が与えられると､返る値は window の表示を参照する; それ以外は､応用譜の主要な窓を参照する｡ Returns a positive integer, the number of milliseconds since the last time the user interacted with the system. If the -displayof option is given then the return value refers to the display of window; otherwise it refers to the display of the application's main window.

  もし使用者の対話不活動時刻の問合せが系によって運営されてなく､且つ､安全な解釈実行機能の場合､ tk inactive は -1 を返す｡ tk inactive will return -1, if querying the user inactive time is not supported by the system, and in safe interpreters.

  もし文字列 reset が追加引数として与えられると､時計計測は解消され､空文字列が返される｡安全な解釈実行機能内では不活動時刻の解消は忘れられ､実行しようとすると不都合が発信される｡ If the literal string reset is given as an additional argument, the timer is reset and an empty string is returned. Resetting the inactivity time is forbidden in safe interpreters and will throw an error if tried.

tk fontchooser subcommand ...
  Tk 文字形状選択対話箱を制御する｡更なる詳細は取扱説明書の fontchooser の頁を参照されたい｡ Controls the Tk font selection dialog. For more details see the fontchooser manual page.

tk scaling ?-displayof window? ?number?
  物理的単位(譬えば､ポイント､吋､粍)と画素との間の変換に Tk によって使用される､現在の尺度因子を設定或は問合せする｡ number 引数は浮動小数であって window の表示上のポイント当りの画素数を指定する｡もし window 引数が省略されると､省略時設定は主要窓になる｡もし number 引数が省略されると､現在の尺度因子が返される｡ 　　　　 Sets and queries the current scaling factor used by Tk to convert between physical units (for example, points, inches, or millimeters) and pixels. The number argument is a floating point number that specifies the number of pixels per point on window's display. If the window argument is omitted, it defaults to the main window. If the number argument is omitted, the current value of the scaling factor is returned.

  “ポイント” は 1/72 吋に等しい長さの単位である｡尺度因子の 1.0 はポイント当り1 画素であり､標準の 72 dpi 画面と等価である｡尺度因子の 1.25 はポイント当り1.25 画素であり､標準の 90 dpi 画面と等価である; 72 dpi 画面上での尺度因子 1.25 は応用譜内の全てのものが通常より 1.25 倍大きく表示される｡尺度因子の初期値は､応用譜が開始する時に実装された表示装置の性質に基いて設定されるが､それは何時でも変更し得る｡尺度因子が変更された後､測定は新しい尺度因子を使うようにさせるが､既存の部品が新しい尺度因子に合わせて自身を動的に寸法変更するか否かは定義されてない｡ 　　　 A “point” is a unit of measurement equal to 1/72 inch. A scaling factor of 1.0 corresponds to 1 pixel per point, which is equivalent to a standard 72 dpi monitor. A scaling factor of 1.25 would mean 1.25 pixels per point, which is the setting for a 90 dpi monitor; setting the scaling factor to 1.25 on a 72 dpi monitor would cause everything in the application to be displayed 1.25 times as large as normal. The initial value for the scaling factor is set when the application starts, based on properties of the installed monitor, but it can be changed at any time. Measurements made after the scaling factor is changed will use the new scaling factor, but it is undefined whether existing widgets will resize themselves dynamically to accommodate the new scaling factor.

tk useinputmethods ?-displayof window? ?boolean?
  行事の篩として Tk がXIM (X Input Methods) を使用べきか否かを設定するか､又は問合せする｡結果の状態が返される｡ XIM は特定の入力装置の処理のために幾つかの地域化情報内で使用されている(即ち､日本､韓国)｡この性質は X 上でのみ意味がある｡もしXIM の運営が利用できない時は常に0 を返す｡もし window 引数が省略されると､省略時設定は主要窓になる｡もし､ boolean 引数が省略されると､現在の状態が返される｡主表示に対して省略時設定は是にされている｡ Sets and queries the state of whether Tk should use XIM (X Input Methods) for filtering events. The resulting state is returned. XIM is used in some locales (i.e., Japanese, Korean), to handle special input devices. This feature is only significant on X. If XIM support is not available, this will always return 0. If the window argument is omitted, it defaults to the main window. If the boolean argument is omitted, the current state is returned. This is turned on by default for the main display.

tk windowingsystem
  現在の Tk の窓系譜､即ち x11 (X11-based) か win32 (MS Windows) か aqua (Mac OS X Aqua) の内の一つを返す｡ Returns the current Tk windowing system, one of x11 (X11-based), win32 (MS Windows), or aqua (macOS Aqua).

### SEE ALSO

busy, fontchooser, send, winfo

### KEYWORDS

application name, send
Copyright © 1992 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.