## Tcl9.0.3/Tk9.0.3 Documentation > Tk Commands > systray

### 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

systray — OS固有系皿内の アイコン表示の生成 Creates an icon display in the platform-specific system tray.

### SYNOPSIS

tk systray create -image image ?-text text? ?-button1 callback? ?-button3 callback?
tk systray configure ?option? ?value option value ...?
tk systray exists
tk systray destroy

### 説明 DESCRIPTION

tk systray create命令は､OS固有の皿内に､アイコンを生成する｡ 部品は､ アイコン画面の為のTk影像と､ 任意追加としての､チューリップ内の表示の為の文字列と､ 任意追加としての､ <Button-1> と <Button-3>に束縛された呼戻しと､ を伴い､構成設定される｡ The tk systray create command creates an icon in the platform-specific tray. The widget is configured with a Tk image for the icon display, an optional string for display in a tooltip, and optional callbacks that are bound to <Button-1> and <Button-3>.

tk systray configure命令は､系皿アイコンの一つ或はそれ以上の指示項目を設定する｡ 構成設定可能な指示項目はcreate副命令と同じである｡ 単一の指示項目の名前が与えられると､命令はこの指示項目の現在の値を返す｡ 指示項目が何も与えられないと､この命令は全ての指示項目とそれらの現在の値の リストを返す｡ The tk systray configure command sets one or more options of the systray icon. Configurable options are the same as for the create subcommand. When a single option name is given, the command returns the current value of this option. When no option is given this command returns the list of all options and their current value.

tk systray exists命令は､OSアイコンが生成されているか否かを確認する｡ 論理値を返す｡ The tk systray exists command checks whether a systray icon was created. It returns a boolean.

tk systray destroy命令は､画面からアイコンを除去する､且つ､割当て除去する｡ The tk systray destroy command removes the icon from display and deallocates it.

使用者-対話機能の立場から､解釈実行機能に一つだけのアイコンに対応する; 追加の眼魂生成の試みは不都合を返す｡ 既存の皿アイコンは､ 応用譜の状態を指し示す文字列と､異なる影像で修正できる｡ 追加の解釈実行機能を実行中のWishの現在値内への積込は､ 表示される追加のアイコンを許可する｡ From a user-interface standpoint, only one icon per interpreter is supported; attempts to create additional icons will return an error. The existing tray icon can be modified with different images and strings to indicate app state. Loading additional interpreters into a running instance of Wish will allow additional icons to be displayed.

### 用例 EXAMPLE

これはtk systray符号化の実例である｡ Here is an example of the tk systray code:

    image create photo book -data \
            R0lGODlhDwAPAKIAAP//////AP8AAMDAwICAgAAAAAAAAAAAACwAAAAADwAPAAADSQhA2u5ksPeKABKSCaya29d4WKgERFF0l1IMQCAKatvBJ0OTdzzXI1xMB3TBZAvATtB6NSLKleXi3OBoLqrVgc0yv+DVSEUuFxIAOw==
    tk systray create -image book -text "tk systray sample" \
            -button1 {puts "Here is the tk systray output"} \
            -button3 {puts "here is alternate output"}

これはtk systrayアイコンを修正する実例である｡ Here is an example of modifying the tk systray icon:

    image create photo book_page -data \
            R0lGODlhCwAPAKIAAP//////AMDAwICAgAAA/wAAAAAAAAAAACwAAAAACwAPAAADMzi6CzAugiAgDGE68aB0RXgRJBFVX0SNpQlUWfahQOvSsgrX7eZJMlQMWBEYj8iQchlKAAA7
    tk systray configure -image book_page -text "Updated sample" \
            -button1 {puts "Different output from the tk systray"} \
            -button3 {puts "and more different output from the tk systray"}

### 機種別の註意事項 PLATFORM NOTES

X11実装は､"最大努力"に基づいて支援されている､理由は､ 窓管理譜に依存しているから｡"文書"旗徴は､チューリップとして実装され､ 窓管理譜がその様な特性を支援してなければ､常には表示されない; 系の皿のアイコン自身は､幾つかの窓管理譜では表示されない｡ The X11 implementation is supported on a "best efforts" basis because it is dependent on the window manager. The "text" flag, which is implemented as a tooltip, does not always display if the WM does not support such features; the systray icon itself may not even display with some window managers.

Windows上では､ -image指示項目内に提供されるTk影像は､映写映像でなければならない｡ 他のos上では､点地図影像又は､映写映像が提供され得る｡ On Windows, the Tk image provided in the -image option must be a photo image. On other platforms either a bitmap image or a photo image may be provided.

### KEYWORDS

image, callback
Copyright © 2020 Kevin Walzer/WordTech Communications LLC.