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

### 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
    menu, tk_menuSetFocus — '指示項目聚' 部品の指示項目帯の生成と操作 Create and manipulate 'menu' widgets and menubars
  SYNOPSIS
  STANDARD OPTIONS
    -activebackground, activeBackground, Foreground
    -activeborderwidth, activeBorderWidth, BorderWidth
    -activeforeground, activeForeground, Background
    -background or -bg, background, Background
    -borderwidth or -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -disabledforeground, disabledForeground, DisabledForeground
    -font, font, Font
    -foreground or -fg, foreground, Foreground
    -relief, relief, Relief
    -takefocus, takeFocus, TakeFocus
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -postcommand, postCommand, Command
    -selectcolor, selectColor, Background
    -tearoff, tearOff, TearOff
    -tearoffcommand, tearOffCommand, TearOffCommand
    -title, title, Title
    -type, type, Type
  緒論 INTRODUCTION
  見出しの型 TYPES OF ENTRIES
  命令見出し COMMAND ENTRIES
  分割線見出し SEPARATOR ENTRIES
  確認釦 CHECKBUTTON ENTRIES
  ラジオ釦見出し RADIOBUTTON ENTRIES
  ずらし表示見出し　CASCADE ENTRIES
  引裂き見出し TEAR-OFF ENTRIES
  指示項目帯 MENUBARS
  指示項目帯内の特定の指示項目聚 SPECIAL MENUS IN MENUBARS
  CLONES
  部品命令 　WIDGET COMMAND
    active
    end
    last
    none
    @x,y
    number
    pattern
    pathName activate index
    pathName add type ?option value option value ...?
    pathName cget option
    pathName clone newPathname ?cloneType?
    pathName configure ?option? ?value option value ...?
    pathName delete index1 ?index2?
    pathName entrycget index option
    pathName entryconfigure index ?options...?
    pathName index index
    pathName insert index type ?option value option value ...?
    pathName invoke index
    pathName post x y ?index?
    pathName postcascade index
    pathName type index
    pathName unpost
    pathName xposition index
    pathName yposition index
  MENU ENTRY OPTIONS
    -activebackground value
    -activeforeground value
    -accelerator value
    -background value
    -bitmap value
    -columnbreak value
    -command value
    -compound value
    -font value
    -foreground value
    -hidemargin value
    -image value
    -indicatoron value
    -label value
    -menu value
    -offvalue value
    -onvalue value
    -selectcolor value
    -selectimage value
    -state value
    -underline value
    -value value
    -variable value
  指示項目聚の構成設定 　MENU CONFIGURATIONS
    Pulldown Menus in Menubar
    Pulldown Menus in Menu Buttons
    Popup Menus
    Option Menus
    Torn-off Menus
  省略時設定の束縛 　DEFAULT BINDINGS
  瑕疵 BUGS
  SEE ALSO
  KEYWORDS

### NAME

menu, tk_menuSetFocus — '指示項目聚' 部品の指示項目帯の生成と操作 Create and manipulate 'menu' widgets and menubars

### SYNOPSIS

menu pathName ?options?
tk_menuSetFocus pathName

### STANDARD OPTIONS

-activebackground, activeBackground, Foreground
-activeborderwidth, activeBorderWidth, BorderWidth
-activeforeground, activeForeground, Background
-background or -bg, background, Background
-borderwidth or -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-disabledforeground, disabledForeground, DisabledForeground
-font, font, Font
-foreground or -fg, foreground, Foreground
-relief, relief, Relief
-takefocus, takeFocus, TakeFocus

### 部品固有の指示項目 WIDGET-SPECIFIC OPTIONS

Command-Line Name: -postcommand
Database Name: postCommand
Database Class: Command
  もしこの指示項目が指定されると､それは指示項目聚が掲示されたそれぞれの時に実行すべき Tcl 命令を提供する｡命令は指示項目聚に掲示される前に post 部品命令によって起動される｡註意すべきは､マッキントッシュと Windows での Tk 8.0 内では､指示項目聚の全ての掲示命令は指示項目聚のどれかが掲示される前に実行される｡これは個別のOSの指示項目聚管理譜の限界による｡ 　　 If this option is specified then it provides a Tcl command to execute each time the menu is posted. The command is invoked by the post widget command before posting the menu. Note that in Tk 8.0 on Macintosh and Windows, all post-commands in a system of menus are executed before any of those menus are posted. This is due to the limitations in the individual platforms' menu managers.

Command-Line Name: -selectcolor
Database Name: selectColor
Database Class: Background
  確認釦やラジオ釦の指示項目聚の見出しの為に､この指示項目は､確認釦やラジオ釦が選択された時の表示器内に表示する色を指定する｡ For menu entries that are check buttons or radio buttons, this option specifies the color to display in the indicator when the check button or radio button is selected.

Command-Line Name: -tearoff
Database Name: tearOff
Database Class: TearOff
  この指示項目は適切な論理値を有していなければならない､それは､指示項目聚が頂上に引裂き見出しを含むべきか否かを指定する｡もし指定すると､それは指示項目聚の見出し 0 に存在し､且つ他の見出しは番号 1 から始まる｡引裂き見出しが起動された時は､省略時設定の指示項目聚束縛は引裂かれる指示項目聚に手配される｡この指示項目は Aqua/Mac OS X では無視される､そこでは指示項目聚は引裂きされない｡ This option must have a proper boolean value, which specifies whether or not the menu should include a tear-off entry at the top. If so, it will exist as entry 0 of the menu and the other entries will number starting at 1. The default menu bindings arrange for the menu to be torn off when the tear-off entry is invoked. This option is ignored under Aqua/macOS, where menus cannot be torn off.

Command-Line Name: -tearoffcommand
Database Name: tearOffCommand
Database Class: TearOffCommand
  もしこの値が非空の値を有すると､Tcl 命令に何時であれ指示項目聚の引裂きが起動することを指定する｡実際の命令はこの指示項目の値に､空白が続き､指示項目聚の窓の名前が続き､空白が続き､引裂き指示項目聚の窓の名前の名前が続いて､構成される｡譬えば､もし指示項目の値が “a b” であり､指示項目聚 .x.y が新しい指示項目聚 .x.tearoff1 を作成する為に引裂かれ､ “a b .x.y .x.tearoff1” が起動されることになる｡この指示項目は Aqua/macOS では無視される､そこでは指示項目聚は引裂きできない｡ If this option has a non-empty value, then it specifies a Tcl command to invoke whenever the menu is torn off. The actual command will consist of the value of this option, followed by a space, followed by the name of the menu window, followed by a space, followed by the name of the name of the torn off menu window. For example, if the option's value is “a b” and menu .x.y is torn off to create a new menu .x.tearoff1, then the command “a b .x.y .x.tearoff1” will be invoked. This option is ignored under Aqua/macOS, where menus cannot be torn off.

Command-Line Name: -title
Database Name: title
Database Class: Title
  文字列は､この指示項目聚が引裂かれた時作成された窓の表題に使用される｡ 表題がNULLの場合窓は指示項目釦の表題かこの指示項目聚が引裂かれたずらした文字列かを有する｡ 　 The string will be used to title the window created when this menu is torn off. If the title is NULL, then the window will have the title of the menubutton or the text of the cascade item from which this menu was invoked.

Command-Line Name: -type
Database Name: type
Database Class: Type
  この指示項目は menubar か tearoff か normal の一つになり､指示項目聚が作成される時に設定される｡構成設定の基礎データに基づいて返された文字列が変化する間にこの指示項目が変更されると､これは指示項目聚部品の挙動に反映されない｡これは複製の仕組みに使われ通常は Tk 外部函数群の外では設定されない｡ 　 This option can be one of menubar, tearoff, or normal, and is set when the menu is created. While the string returned by the configuration database will change if this option is changed, this does not affect the menu widget's behavior. This is used by the cloning mechanism and is not normally set outside of the Tk library.

### 緒論 INTRODUCTION

menu 命令は(pathName 引数を与えられ)新しい頂上水準窓を生成し､それを指示項目聚部品にする｡その指示項目聚部品は跳び出し窓として使用もでき又､ toplevel 命令( -menu 指示を追加して)を適用してその頂上水準の為の指示項目聚帯にすることもできる｡上に述べた追加的な指示項目は命令行や､その色､字形の様な釦の外観を構成設定する追加的な基礎データの中で指定される｡menu 命令はそのpathName 引数を返す｡この命令が起動された時､ pathName の名前の窓が存在してはならないが､pathName の親は実在しなければならない｡ 　　 The menu command creates a new top-level window (given by the pathName argument) and makes it into a menu widget. That menu widget can either be used as a pop-up window or applied to a toplevel (with its -menu option) to make it into the menubar for that toplevel. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the menu such as its colors and font. The menu command returns its pathName argument. At the time this command is invoked, there must not exist a window named pathName, but pathName's parent must exist.

指示項目聚は部品であって､一行の見出しの集まりを一つかそれ以上の欄に編成している｡そこには､それぞれ異なる性質を伴う幾つもの異なる型の見出しがある｡異なる型の見出しが組合わさって一つの指示項目聚になることもある｡指示項目聚の見出しは入力部品とは同じではない｡事実､指示項目聚の見出しは個別の部品ではない; 指示項目聚全体が一個の部品である｡ 　　 A menu is a widget that displays a collection of one-line entries arranged in one or more columns. There exist several different types of entries, each with different properties. Entries of different types may be combined in a single menu. Menu entries are not the same as entry widgets. In fact, menu entries are not even distinct widgets; the entire menu is one widget.

指示項目聚の見出しは三つまでの別々の欄枠で表示される｡主欄枠は文書文字列形式か､点地図か､映像の札であり､見出しの為の -label と -bitmap と -image 指示項目によって制御される｡もし､見出しの為に -accelerator 指示項目が指定される場合､第二の文書欄枠が札の右に表示される｡即効器は典型的には打鍵の並びを記述し､指示項目聚の見出しを起動したのと同じ結果を引起す為に応用譜内で使われる｡ これは表示用の選択肢であり､実際には対応する束縛は設定されない(束縛命令bindを使用して遂行されるものである)｡第三の欄枠は指示器である｡指示器は確認釦かラジオ釦の見出しの為にのみ存在する｡それは見出しが選択されているか否かを指し示し､見出しの文字列の左に表示される｡ 　 Menu entries are displayed with up to three separate fields. The main field is a label in the form of a text string, a bitmap, or an image, controlled by the -label, -bitmap, and -image options for the entry. If the -accelerator option is specified for an entry then a second textual field is displayed to the right of the label. The accelerator typically describes a keystroke sequence that may be used in the application to cause the same result as invoking the menu entry. This is a display option, it does not actually set the corresponding binding (which can be achieved using the bind command). The third field is an indicator. The indicator is present only for checkbutton or radiobutton entries. It indicates whether the entry is selected or not, and is displayed to the left of the entry's string.

通常の使い方では､何時であれマウス指示子が見出しの上に架かると､見出しが活性になる(その表示が変わる)｡もしマウス釦が見出しの上で離されるとその見出しが起動される｡起動の効果はそれぞれの見出しの型により異なる; このような効果は下の個別の見出しの節に記述されている｡　　　 In normal use, an entry becomes active (displays itself differently) whenever the mouse pointer is over the entry. If a mouse button is released over the entry then the entry is invoked. The effect of invocation is different for each type of entry; these effects are described below in the sections on individual entries.

見出しは不能にもなる､すると､その札と即効釦が薄暗い色で表示されることになる｡指示項目聚の束縛の省略時設定は不能の見出しが活性化されたり起動されたりすることを許容しない｡不能の見出しは再有効化され得る､その時点で再び活性化と起動が可能になる｡ 　　 Entries may be disabled, which causes their labels and accelerators to be displayed with dimmer colors. The default menu bindings will not allow a disabled entry to be activated or invoked. Disabled entries may be re-enabled, at which point it becomes possible to activate and invoke them again.

何時であれ指示項目聚の活性な見出しが変化する時､ <<MenuSelect>> 仮想行事が指示項目聚に送られる｡活性な品目は､指示項目聚からの問合せが可能であり､見出しの為の文脈に反応する取扱説明文書の設定の様な､行動が可能である｡ 　 Whenever a menu's active entry is changed, a <<MenuSelect>> virtual event is send to the menu. The active item can then be queried from the menu, and an action can be taken, such as setting context-sensitive help text for the entry.

### 見出しの型 TYPES OF ENTRIES

#### 命令見出し COMMAND ENTRIES

最も普通の種類の指示項目聚の見出しは命令見出しであり､その挙動は概して釦部品に似ている｡命令見出しが起動される時､ Tcl 命令が実行される｡ Tcl 命令は -command 指示項目で設定される｡ 　　 The most common kind of menu entry is a command entry, which behaves much like a button widget. When a command entry is invoked, a Tcl command is executed. The Tcl command is specified with the -command option.

#### 分割線見出し SEPARATOR ENTRIES

分割線は見出しであり水平の分割線として表示される｡分割線は活性化も起動もされない､又形状を表示する以外の振舞いを有さない｡ 　　 A separator is an entry that is displayed as a horizontal dividing line. A separator may not be activated or invoked, and it has no behavior other than its display appearance.

#### 確認釦 CHECKBUTTON ENTRIES

確認釦の指示項目聚の見出しの振舞いは概して検査釦部品と似ている｡それが起動された時､選択と非選択の状態の間を行きつ戻りつ巡回する｡見出しが選択されたとき､(見出しの為に -onvalue と -variable 指定項目により定められた通りに)特定の値が特定の大域変数に保存される; 見出しが非選択になる時､( -offvalue 指定により定められた)他の値が大域変数に保存される｡確認釦の見出しの札の左に指示箱が表示される｡もし見出しが選択されると指示器の真ん中が見出しの為に -selectcolor 指示項目によって与えられた色に表示される; そうでない場合､表示器の真ん中は指示項目聚の背景の色で表示される｡もし確認釦の見出しの為に -command 指示項目が設定されていると､見出しが起動される度毎に､その値が Tcl 命令として評価される; これは見出しの選択状態の巡回切り替えが終った後に発生する｡ A checkbutton menu entry behaves much like a checkbutton widget. When it is invoked it toggles back and forth between the selected and deselected states. When the entry is selected, a particular value is stored in a particular global variable (as determined by the -onvalue and -variable options for the entry); when the entry is deselected another value (determined by the -offvalue option) is stored in the global variable. An indicator box is displayed to the left of the label in a checkbutton entry. If the entry is selected then the indicator's center is displayed in the color given by the -selectcolor option for the entry; otherwise the indicator's center is displayed in the background color for the menu. If a -command option is specified for a checkbutton entry, then its value is evaluated as a Tcl command each time the entry is invoked; this happens after toggling the entry's selected state.

#### ラジオ釦見出し RADIOBUTTON ENTRIES

ラジオ釦指示項目聚は概してラジオ釦部品に似かよって振舞う｡ラジオ釦の見出しは同時には一つの見出しのみが選択される群の中に形成される｡何時であれ特定の見出しが選択になると､それは(見出しの為の -value と -variable 指示項目によって定められる通りに)特定の値を特定の大域変数に保存する｡この活動は同じ群内のそれ以前に選択されていたどの見出しも自身が非選択になることを引起す｡一度見出しが選択になると､見出しに結合した変数のどの変更も見出しがそれ自身非選択になることを引起す｡ラジオ釦見出しの群別化はその結合した変数によって定められる: もし二つの見出しが同じ結合した変数を有する場合､それらは同じ群になる｡選択指示の臍はそれぞれのラヂオ釦見出しないの札の左方に表示される｡もし見出しが選択されると指示器の真ん中が見出しの為の -selectcolor 指示項目によって与えられた色に表示される; さもないと､表示器の真ん中は指示項目聚の背景の色で表示される｡もしラジオ釦の見出しの為に -command 指示項目が設定されていると､見出しが起動される度に､その値が Tcl 命令として評価される; これは見出しが選択された後に発生する｡ 　　 A radiobutton menu entry behaves much like a radiobutton widget. Radiobutton entries are organized in groups of which only one entry may be selected at a time. Whenever a particular entry becomes selected it stores a particular value into a particular global variable (as determined by the -value and -variable options for the entry). This action causes any previously-selected entry in the same group to deselect itself. Once an entry has become selected, any change to the entry's associated variable will cause the entry to deselect itself. Grouping of radiobutton entries is determined by their associated variables: if two entries have the same associated variable then they are in the same group. An indicator diamond is displayed to the left of the label in each radiobutton entry. If the entry is selected then the indicator's center is displayed in the color given by the -selectcolor option for the entry; otherwise the indicator's center is displayed in the background color for the menu. If a -command option is specified for a radiobutton entry, then its value is evaluated as a Tcl command each time the entry is invoked; this happens after selecting the entry.

#### ずらし表示見出し　CASCADE ENTRIES

ずらし表示見出しは( -menu 指示項目により定められる)結合した指示項目聚を伴う｡ずらし表示見出しはずらし表示の構築を許容する｡ postcascade 部品命令は結合した指示項目聚をずらし表示見出しの直ぐ隣に掲示､非掲示に使うことができる｡結合した指示項目聚はずらし表示見出しを含む指示項目聚の子供でなくてはならない(これは指示項目聚の横断が正しく動作する為に必要である)｡ 　　 A cascade entry is one with an associated menu (determined by the -menu option). Cascade entries allow the construction of cascading menus. The postcascade widget command can be used to post and unpost the associated menu just next to of the cascade entry. The associated menu must be a child of the menu containing the cascade entry (this is needed in order for menu traversal to work correctly).

ずらし表示見出しは次式のTcl 命令の起動によりその結合した指示項目聚を掲示する　　　 A cascade entry posts its associated menu by invoking a Tcl command of the form

    menu post x y

ここで menu は結合した指示項目聚の経路名､ x と y はずらし表示見出しの右上隅の根本窓での座標である｡Unix では次の書式のTcl 命令の実行により低い水準の指示項目聚は非掲示にされる｡ where menu is the path name of the associated menu, and x and y are the root-window coordinates of the upper-right corner of the cascade entry. On Unix, the lower-level menu is unposted by executing a Tcl command with the form

    menu unpost

ここで menu は関連した指示項目聚の名前｡他のOSでは､OSの本来の命令譜が指示項目聚の非掲示に注意を払う｡　　 where menu is the name of the associated menu. On other platforms, the platform's native code takes care of unposting the menu.

もし -command 指示項目がずらし表示見出しを指定する場合､何時であれ見出しが起動された時に Tcl 命令として評価される｡ 　　 If a -command option is specified for a cascade entry then it is evaluated as a Tcl command whenever the entry is invoked. This is not supported on Windows.

#### 引裂き見出し TEAR-OFF ENTRIES

もし -tearoff 指示項目が有効である場合引裂き表示が指示項目聚の上に現れる｡その他の指示項目聚の見出しとは異なりその中に add 部品命令では作成できないし､ delete 部品命令で削除もできない｡引裂き見出しが作成される時は､指示項目聚の上に破線として出現する｡省略時設定の束縛下では引裂き表示見出しの起動は指示項目聚とその全ての仔指示項目聚からなる引裂かれた複写を引起す｡　　　 A tear-off entry appears at the top of the menu if enabled with the -tearoff option. It is not like other menu entries in that it cannot be created with the add widget command and cannot be deleted with the delete widget command. When a tear-off entry is created it appears as a dashed line at the top of the menu. Under the default bindings, invoking the tear-off entry causes a torn-off copy to be made of the menu and all of its submenus.

### 指示項目帯 MENUBARS

どの指示項目聚も指示項目帯として頂上水準の窓に設定できる(構文に就いては toplevel 命令を参照されたい)｡ Windows と Unix では指示項目聚の品目は窓の上を横切った指示項目帯内に表示される｡マッキントッシュでは何時であれ頂上水準は前面にあり､この指示項目聚のずらし表示品目は主表示装置の上を横切った指示項目帯内に現れる｡これらの指示項目聚はそのOSの対話機能の規則に従って振舞う｡指示項目帯として設定される全ての指示項目聚に対して､指示項目聚の複製が作成される｡更なる情報に就いては CLONES の項を参照されたい｡ Any menu can be set as a menubar for a toplevel window (see toplevel command for syntax). On the Macintosh, whenever the toplevel is in front, this menu's cascade items will appear in the menubar across the top of the main monitor. On Windows and Unix, this menu's items will be displayed in a menubar across the top of the window. These menus will behave according to the interface guidelines of their platforms. For every menu set as a menubar, a clone menu is made. See the CLONES section for more information.

註意した様に､指示項目帯は異なるOS毎に異なる挙動をするかもしれない｡これに関する一つの例は､指示項目聚内の確認釦とラジオ釦の処理である｡これ等の指示項目聚の要素を指示項目帯上に置くことを許容されているが､それらはあるOS上では系の制約から指示用の臍とは一緒には描かれない｡ As noted, menubars may behave differently on different platforms. One example of this concerns the handling of checkbuttons and radiobuttons within the menu. While it is permitted to put these menu elements on menubars, they may not be drawn with indicators on some platforms, due to system restrictions.

#### 指示項目帯内の特定の指示項目聚 SPECIAL MENUS IN MENUBARS

指示項目帯内の特定の指示項目聚は特別な扱いを受ける｡マック上では特別な｢アプリ｣と｢窓｣と｢ヘルプ｣指示項目聚が提供されている｡ Windows では､それぞれの窓内でWindows System 指示項目聚 への利用が提供されている｡ X 窓では Motif 指示項目聚互換が有効になっていると､特別の右揃えの｢ヘルプ｣指示項目聚が提供されている｡全ての場合に､これ等の指示項目聚は指示項目帯の指示項目聚の名前に特別な名前を連結した命令によって作成しなければならない｡そこで､.menubar の名前の指示項目帯はマック上では特別な名前は .menubar.apple と .menubar.window と .menubar.help とであるべきであり Windowsでは特別な名前は .menubar.system であるべきであり､X 窓では｢ヘルプ｣指示項目聚は .menubar.help であるべきである｡ 　　 Certain menus in a menubar will be treated specially. On the Macintosh, access to the special Application, Window and Help menus is provided. On Windows, access to the Windows System menu in each window is provided. On X Windows, a special right-justified help menu may be provided if Motif menu compatibility is enabled. In all cases, these menus must be created with the command name of the menubar menu concatenated with the special name. So for a menubar named .menubar, on the Macintosh, the special menus would be .menubar.apple, .menubar.window and .menubar.help; on Windows, the special menu would be .menubar.system; on X Windows, the help menu would be .menubar.help.

Tk がマッキントッシュ上で指示項目帯内の初めの指示項目聚として .menubar.apple 指示項目聚を見ると､何時であれ指示項目帯を含んだ窓が前面にある時は､その指示項目聚に｢アプリ｣指示項目聚の最初の品目を用意する｡指示項目聚は全ての Tk-定義の品目の後に､区切りを有し､標準の｢アプリ｣指示項目聚の品目を続ける｡このような .apple 指示項目聚は､指示項目聚が最初に頂上水準の指示項目帯として構成設定された時に存在しなければならない､さもないと､省略時設定の応用譜指示項目聚( Tkにより隠蔽された)がその時に指示項目帯に挿入され､引続く .apple 指示項目聚の追加はもはやふさわしい応用譜の指示項目聚には入らない｡ 　　　 When Tk sees a .menubar.apple menu as the first menu in a menubar on the Macintosh, that menu's contents make up the first items of the Application menu whenever the window containing the menubar is in front. After all of the Tk-defined items, the menu will have a separator, followed by all standard Application menu items. Such a .apple menu must be present in a menu when that menu is first configured as a toplevel's menubar, otherwise a default application menu (hidden from Tk) will be inserted into the menubar at that time and subsequent addition of a .apple menu will no longer result in it becoming the Application menu.

マック上で Tk が .menubar.window 指示項目聚を見ると､何時であれ窓の指示項目帯が前面にある時は､その指示項目聚の内容は使用者の指示項目帯の標準窓指示項目聚に挿入される｡指示項目聚の最初の項目はMac OS X によって提供される､又､現在の頂上水準の名前は自動的に全ての Tk-定義の品目の後の､分割線の後に追記される｡Mac 上の窓指示項目聚は窓に全画面状態への移動をトグル可能にする､又､舌付き窓対話機能(複数の窓を一つの窓にまとめる)を管理する､但し､そのOSの版がそれを運営している場合に限る｡ When Tk sees a .menubar.window menu on the Macintosh, the menu's contents are inserted into the standard Window menu of the user's menubar whenever the window's menubar is in front. The first items in the menu are provided by macOS, and the names of the current toplevels are automatically appended after all the Tk-defined items and a separator. The Window menu on the Mac also allows toggling the window into a fullscreen state, and managing a tabbed window interface (multiple windows grouped into a single window) if supported by that version of the operating system.

マック上で Tk が .menubar.help 指示項目聚を見ると､何時であれ窓の指示項目帯が前面にある時は､その指示項目聚の内容は使用者の指示項目帯の標準ヘルプ指示項目聚に挿入される｡指示項目聚の最初の項目は macOS によって与えられた項目である｡ 　　 When Tk sees a .menubar.help menu on the Macintosh, the menu's contents are appended to the standard Help menu of the user's menubar whenever the window's menubar is in front. The first items in the menu are provided by macOS.

Windows上で Tk が｢システム｣指示項目聚を見ると､その品目は指示項目帯に貼り付けられた系の指示項目聚に追記される｡この指示項目聚は応用譜のアイコンに束縛され､マウス又はAlt+空白鍵.の打鍵により起動できる｡Windows のAPI,内の制限により､文字形状､色､影像､点地図､引裂きの影像の変更は系の指示項目聚に現れない｡ 　　 When Tk sees a System menu on Windows, its items are appended to the system menu that the menubar is attached to. This menu is tied to the application icon and can be invoked with the mouse or by typing Alt+Spacebar. Due to limitations in the Windows API, any font changes, colors, images, bitmaps, or tearoff images will not appear in the system menu.

X Windows と Motif 指示項目聚上で Tk が｢ヘルプ｣指示項目聚を見ると､互換性が有効になり､指示項目聚は指示項目帯の後尾に移動され右揃えされる｡Motif 指示項目聚の互換性は Tk 指示項目の*Menu.useMotifHelp を真値にするか tk::classic::restore menu の呼出しにより有効になる｡ 　　　 When Tk sees a Help menu on X Windows and Motif menu compatibility is enabled the menu is moved to be last in the menubar and is right justified. Motif menu compatibility is enabled by setting the Tk option *Menu.useMotifHelp to true or by calling tk::classic::restore menu.

### CLONES

指示項目聚が頂上水準の窓の一員として設定される時､又は､指示項目聚が引裂かれる時､指示項目聚の複製が作られる｡この複製はそれ自体が指示項目聚部品であるが､元のものの子供である｡元のものの構成設定の変更は複製の中に反映される｡更に､指し示されるどのずらし表示も複製であるので指示項目聚の経路探索が正しく動く｡引裂きか指示項目帯がなくなるか､元の指示項目聚が破壊されると複製は破壊される｡ When a menu is set as a menubar for a toplevel window, or when a menu is torn off, a clone of the menu is made. This clone is a menu widget in its own right, but it is a child of the original. Changes in the configuration of the original are reflected in the clone. Additionally, any cascades that are pointed to are also cloned so that menu traversal will work right. Clones are destroyed when either the tearoff or menubar goes away, or when the original menu is destroyed.

### 部品命令 　WIDGET COMMAND

menu 命令は名前が pathName の新しい Tcl 命令を生成する｡この命令は部品上の種々の操作の起動に使われる｡次の一般的形式を有する: The menu command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:

    pathName option ?arg arg ...?

option と arg は命令の正確な振舞いを定める｡ Option and the args determine the exact behavior of the command.

指示項目聚の為の命令の多くは､その指示項目聚が操作すべき見出しを指示する一つの引数をとる｡その指示は索引と呼ばれ次の形式のどれかをとる: 　 Many of the widget commands for a menu take as one argument an indicator of which entry of the menu to operate on. These indicators are called indexes and may be specified in any of the following forms:

active
  現在活性な見出しを指し示す｡活性な見出しがない場合この形式は none と等価である｡この形式は短縮できない｡ 　 Indicates the entry that is currently active. If no entry is active then this form is equivalent to none. This form may not be abbreviated.

end
  指示項目聚の最も下の見出しを指し示す｡指示項目聚に見出しがない場合この形式は none と等価である｡この形式は短縮できない｡ Indicates the bottommost entry in the menu. If there are no entries in the menu then this form is equivalent to none. This form may not be abbreviated.

last
  end と同じ｡ Same as end.

none
  “見出しは全くなし” を指し示す; 通常は activate 指示項目と供に､全ての指示項目聚の見出しを不活性にする為に使われることが多い｡多くの場合､ none の指定は部品命令に何も引起さない｡この形式は短縮できない｡ Indicates “no entry at all”; this is used most commonly with the activate option to deactivate all the entries in the menu. In most cases the specification of none causes nothing to happen in the widget command. This form may not be abbreviated.

@x,y
  メニュー内の(画素座標内の) x と y によって指定される点が覆う見出しを指し示す｡もしその点が何も見出しを覆わない場合､この書式は none と等しい｡もし一つだけの数が指定されると y-座標として扱われる｡ Indicates the entry that covers the point in the menu's window specified by x and y (in pixel coordinates). If no entry covers that point, then this form is equivalent to none. If only a single number is specified, it is treated as the y-coordinate.

number
  見出しを数的に指定する､ここで 0 は指示項目聚の最も上の見出しに相当する､ 1 はその下の見出し､以下同様である｡ Specifies the entry numerically, where 0 corresponds to the top-most entry of the menu, 1 to the entry below it, and so on.

pattern
  もし索引が上の形式のどれも満足しない場合､この形式が使用される｡ pattern は指示項目聚内のそれぞれの見出しの札に対して合致する模様であり､上から下の順に合致する見出しが見付かる迄続く｡string match の規則が使われる｡ 　　 If the index does not satisfy one of the above forms then this form is used. Pattern is pattern-matched against the label of each entry in the menu, in order from the top down, until a matching entry is found. The rules of string match are used.

もし索引が上の書式の複数に合致できる場合､上のリストの前の方の書式が優先して採用される｡ If the index could match more than one of the above forms, then the form earlier in the above list takes precedence.

次の部品命令が指示項目聚部品の為に可能である: The following widget commands are possible for menu widgets:

pathName activate index
  index によって指し示される見出しの状態を active に変更し､活性な色を使って再表示する｡以前活性であったどの見出しも非活性化される｡もし index が none として指定されているか､指定した見出しが不能である場合､指示項目聚は結局活性の見出しがなくなる｡空文字列を返す｡ Change the state of the entry indicated by index to active and redisplay it using its active colors. Any previously-active entry is deactivated. If index is specified as none, or if the specified entry is disabled, then the menu ends up with no active entry. Returns an empty string.

pathName add type ?option value option value ...?
  指示項目聚の末尾に新しい見出しを追加する｡新しい見出しの型は type によって与えられ､ cascade か checkbutton か command か radiobutton か separator か混同を起こさないそれらの短縮形の一つである｡もし更なる引数が存在すると､それは後述の MENU ENTRY OPTIONS 節内に列挙した指示項目を指定する｡この add 部品命令は空文字列を返す｡ Add a new entry to the bottom of the menu. The new entry's type is given by type and must be one of cascade, checkbutton, command, radiobutton, or separator, or a unique abbreviation of one of the above. If additional arguments are present, they specify the options listed in the MENU ENTRY OPTIONS section below. The add widget command returns an empty string.

pathName cget option
  option で与えられる構成設定指示項目の現在の値を返す｡ option は menu 命令により受入れられるどの様な形式でもよい｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the menu command.

pathName clone newPathname ?cloneType?
  現在の指示項目聚の複製を newPathName と謂ふ名前をつけて作成する｡この複製は指示項目聚それ自体であるが､複製に対するどのような変更も元の指示項目聚に伝播し､逆も亦然り｡ cloneType は normal か menubar か tearoff かであってもよい｡ Tk 外部函数群の外から呼出すべきではない｡更なる情報は CLONES の節を参照されたい｡ 　 Makes a clone of the current menu named newPathName. This clone is a menu in its own right, but any changes to the clone are propagated to the original menu and vice versa. cloneType can be normal, menubar, or tearoff. Should not normally be called outside of the Tk library. See the CLONES section for more information.

pathName configure ?option? ?value option value ...?
  部品の構成設定の指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､命令はその名前の指示項目を記述したリストを返す(このリストは､ option が指定されない時に返されるリストの部分リストに相当するものと同一である)｡もし､一つ或はそれ以上の option-value 対が指定されると､命令は､与えられた部品指示項目が与えられた値を有する様に修正する; この場合､命令は空文字列を返す｡ option はmenu 命令に受入られるどのような値を有していてもよい｡ Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the menu command.

pathName delete index1 ?index2?
  指示項目聚の見出しの index1 と index2 と､その間の全ての見出しを削除する｡もし index2 が省略されると省略時設定の index1 になる｡引裂き指示項目聚の見出しの削除の試みは無視される(引裂きの見出しの除去には､代りに -tearoff 指示項目に変更するべきである)｡ 　 Delete all of the menu entries between index1 and index2 inclusive. If index2 is omitted then it defaults to index1. Attempts to delete a tear-off menu entry are ignored (instead, you should change the -tearoff option to remove the tear-off entry).

pathName entrycget index option
  index により与えられる見出しについて､現在の構成設定の値を返す｡ options は後述の MENU ENTRY OPTIONS 節に記述したどの名前でもよい｡ 　　 Returns the current value of a configuration option for the entry given by index. Option may have any of the names described in the MENU ENTRY OPTIONS section below.

pathName entryconfigure index ?options...?
  この命令は configure 命令に似ており､違いは､これが個別の見出しの為の指示項目に適用され､他方では configure は全体として指示項目聚の指示項目に適用される｡ options は下の MENU ENTRY OPTIONS 節に記述したどの値を有していてもよい｡もし options が指定されると指示項目は命令に指し示された様に修正され､命令は空文字列を返す｡もし options が指定されない場合､見出しの index の為の現在の指示項目を記述したリストを返す(このリストの書式に就いての情報は Tk_ConfigureInfo を参照されたい)｡ 　　 This command is similar to the configure command, except that it applies to the options for an individual entry, whereas configure applies to the options for the menu as a whole. Options may have any of the values described in the MENU ENTRY OPTIONS section below. If options are specified, options are modified as indicated in the command and the command returns an empty string. If no options are specified, returns a list describing the current options for entry index (see Tk_ConfigureInfo for information on the format of this list).

pathName index index
  index に対応する数字の索引を返すか､ index が none として指定されている場合 none を返す｡ Returns the numerical index corresponding to index, or none if index was specified as none.

pathName insert index type ?option value option value ...?
  add 部品命令と同じであるが､違いは新しい見出しを指示項目聚の末尾に添付ではなく index で与えられる見出しの直前に挿入することである｡ type と option と value 引数は add 部品命令と同じに解釈される｡もし指示項目聚が引裂き見出しを有している場合､新しい指示項目聚を引裂き見出しの前に挿入する事はできない｡ Same as the add widget command except that it inserts the new entry just before the entry given by index, instead of appending to the end of the menu. The type, option, and value arguments have the same interpretation as for the add widget command. It is not possible to insert new menu entries before the tear-off entry, if the menu has one.

pathName invoke index
  指示項目聚の見出しの活動を起動する｡何が起っているかは､上述の個別の見出しの節を参照されたい｡もし指示項目聚の見出しが不能の場合何も起らない｡もし見出しが関連した命令を有している場合､部品命令の起動の結果としてその命令の結果を返す｡そうでない場合､結果は空文字列である｡註意: 指示項目聚の見出しの起動は自動的には指示項目聚を非掲示にしない; 省略時設定の束縛は通常 invoke 部品命令を起動する前にこのことを注意深く扱う｡ 　　 Invoke the action of the menu entry. See the sections on the individual entries above for details on what happens. If the menu entry is disabled then nothing happens. If the entry has a command associated with it then the result of that command is returned as the result of the invoke widget command. Otherwise the result is an empty string. Note: invoking a menu entry does not automatically unpost the menu; the default bindings normally take care of this before invoking the invoke widget command.

pathName post x y ?index?
  指示項目聚が x と y によって与えられた根本の窓の座標に表示される様に手配する､この座標は指示項目聚全体が画面上に可視になることを保障する様必要に応じて調整される｡もし､index が指定されていると､指示項目聚はその index が指示位置に表示されるように配置される｡この命令は通常空文字列を返す｡もし -postcommand 指示項目が指定されている場合その値は Tcl 記述譜として指示項目聚に掲示する前に実行され､且つその記述譜の結果は post 部品命令の結果として返される｡もしその命令を実行している間に不都合が返ると指示項目聚が掲示されることなく不都合が返される｡ 　　 Arrange for the menu to be displayed on the screen at the root-window coordinates given by x and y. If an index is specified the menu will be located so that the entry with that index is displayed at the point. These coordinates are adjusted if necessary to guarantee that the entire menu is visible on the screen. This command normally returns an empty string. If the -postcommand option has been specified, then its value is executed as a Tcl script before posting the menu and the result of that script is returned as the result of the post widget command. If an error returns while executing the command, then the error is returned without posting the menu.

pathName postcascade index
  index によって与えられるずらし表示見出しに関連した副指示項目聚を掲示する､そしてそれ以前に掲示していたどの副指示項目聚をも非掲示にする｡もし index がずらし表示見出しに対応しない場合､又は pathName が掲示されていない場合､現在掲示されているどの副指示項目聚も非掲示にすることを除いて効果を有さない｡　　 Posts the submenu associated with the cascade entry given by index, and unposts any previously posted submenu. If index does not correspond to a cascade entry, or if pathName is not posted, the command has no effect except to unpost any currently posted submenu.

pathName type index
  index で与えられる指示項目聚の見出しの型を返す｡ command か separator か､引裂き見出しでは tearoff によって見出しが作成された時､これは add か insert 部品命令に渡される type 引数である｡ 　　　 Returns the type of the menu entry given by index. This is the type argument passed to the add or insert widget command when the entry was created, such as command or separator, or tearoff for a tear-off entry.

pathName unpost
  窓を取除き表示できなくする｡もし低い水準のずらし表示指示項目聚が掲示されている場合､その指示項目聚を非掲示にする｡空文字列を返す｡この副命令は Windows とマックでは動かない､これらのOSでは独自の方法で指示項目聚を非掲示にする｡ 　　 Unmap the window so that it is no longer displayed. If a lower-level cascaded menu is posted, unpost that menu. Returns an empty string. This subcommand does not work on Windows and the Macintosh, as those platforms have their own way of unposting menus.

pathName xposition index
  指示項目聚窓内の index によって指定される見出しの最も左の画素の x-座標を与える十進文字列を返す｡ Returns a decimal string giving the x-coordinate within the menu window of the leftmost pixel in the entry specified by index.

pathName yposition index
  指示項目聚窓内の index によって指定される見出しの最も上の画素の y-座標を与える十進文字列を返す｡ Returns a decimal string giving the y-coordinate within the menu window of the topmost pixel in the entry specified by index.

### MENU ENTRY OPTIONS

指示項目聚見出しに次の指示項目が許容される｡大多数の指示項目は全ての見出し型では対応されていない｡ 　 The following options are allowed on menu entries. Most options are not supported by all entry types.

-activebackground value
  この見出しが活性なことを表示する為に背景色を指定する｡もしこの指示項目に空文字列が指定されていると(省略時設定)､全体の指示項目聚の為の -activebackground 指示項目が使われる｡もし tk_strictMotif 変数が厳密な Motif 準拠を要求するよう設定されている場合､この指示項目は無視され -background 指示項目が使われる｡この指示項目は分割線や引裂き見出しには利用できない｡ Specifies a background color to use for displaying this entry when it is active. This option is ignored on Aqua/macOS. If it is specified as an empty string (the default), then the -activebackground option for the overall menu is used. If the tk_strictMotif variable has been set to request strict Motif compliance, then this option is ignored and the -background option is used in its place. This option is not available for separator or tear-off entries.

-activeforeground value
  この見出しが活性なことを表示する為に前景色を指定する｡もしこの指示項目に空文字列が指定されていると(省略時設定)､全体の指示項目聚の為の -activeforeground 指示項目が使われる｡この指示項目は分割線や引裂き見出しには利用できない｡ 　　 Specifies a foreground color to use for displaying this entry when it is active. This option is ignored on Aqua/macOS. If this option is specified as an empty string (the default), then the -activeforeground option for the overall menu is used. This option is not available for separator or tear-off entries.

-accelerator value
  指示項目聚見出しの右側に表示される文字列を指定する｡通常､見出しと同じ機能を起動する為の即効打鍵並びを記述する｡これは表示用の指示項目であり､実際には対応する束縛は設定されない(bind命令を使用して遂行されるものである)｡この指示項目は分割線や引裂き見出しには利用できない｡ 　　 Specifies a string to display at the right side of the menu entry. Normally describes an accelerator keystroke sequence that may be used to invoke the same function as the menu entry. This is a display option, it does not actually set the corresponding binding (which can be achieved using the bind command). This option is not available for separator or tear-off entries.

-background value
  この見出しが通常状態(活性でも不能でもない)である時､この見出しを表示する為に使用する背景色を指定する｡もしこの指示項目に空文字列が指定されていると(省略時設定)､全体の指示項目聚の為の -background 指示項目が使われる｡この指示項目は分割線や引裂き見出しには利用できない｡Aqua/macOS ではこの指示項目は無視される｡ Specifies a background color to use for displaying this entry when it is in the normal state (neither active nor disabled). This option is ignored on Aqua/macOS. If it is specified as an empty string (the default), then the -background option for the overall menu is used. This option is not available for separator or tear-off entries.

-bitmap value
  指示項目聚の文書札の代りに表示する為の点地図を指定する､ Tk_GetBitmap に受入れられるどの形式でもよい｡この指示項目は -label 指示項目を( -compound 指示項目により制御されているが如く)上書きするが､文書札が表示できる為に空文字列に再設定することができる｡もし -image 指示項目が指定されている場合､それは -bitmap を上書きする｡この指示項目は分割線や引裂き見出しには利用できない｡ Specifies a bitmap to display in the menu instead of a textual label, in any of the forms accepted by Tk_GetBitmap. This option overrides the -label option (as controlled by the -compound option) but may be reset to an empty string to enable a textual label to be displayed. If a -image option has been specified, it overrides -bitmap. This option is not available for separator or tear-off entries.

-columnbreak value
  この指示項目が零の時､見出しは前の見出しの下に現れる｡この指示項目が１の場合､見出しは指示項目聚の新しい列の頂に現れる｡この指示項目は Aqua/Mac OS X では無視される､そこでは指示項目聚は常に一列である｡ When this option is zero, the entry appears below the previous entry. When this option is one, the entry appears at the top of a new column in the menu. This option is ignored on Aqua/macOS, where menus are always a single column.

-command value
  指示項目聚の見出しが起動された時に実行する Tcl 命令を指定する｡分割線や引裂き見出しには利用できない｡ Specifies a Tcl command to execute when the menu entry is invoked. Not available for separator or tear-off entries.

-compound value
  指示項目聚の見出しが影像と文書の両方を表示するかを指定し､その場合､影像は文書の相対的にどちらに置くかを指定する｡この指示項目の適正な値は bottom か center か left か none か right か top である｡省略時設定は none であり､釦は -image と -bitmap 指示項目の値に従って映像か文書のどちらかを表示する｡ 　　 Specifies whether the menu entry should display both an image and text, and if so, where the image should be placed relative to the text. Valid values for this option are bottom, center, left, none, right and top. The default value is none, meaning that the button will display either an image or text, depending on the values of the -image and -bitmap options.

-font value
  この見出しの中の札や即効釦文字列の描写に使う文字形状を指定する｡もしこの指示項目として空文字列が指定されていると(省略時設定)､指示項目聚全体の為の -font 指示項目が使われる｡この指示項目は分割線や引裂き見出しには利用できない｡ 　　 Specifies the font to use when drawing the label or accelerator string in this entry. If this option is specified as an empty string (the default) then the -font option for the overall menu is used. This option is not available for separator or tear-off entries.

-foreground value
  通常状態(活性でも不能でもない)の時に､この見出しを表示する為に使用する前景色を指定する｡ Aqua/macOS ではこの指示項目は無視される｡もしこの指示項目に空文字列が指定されていると(省略時設定)､全体の指示項目聚の為の -foreground 指示項目が使われる｡この指示項目は分割線や引裂き見出しには利用できない｡ Specifies a foreground color to use for displaying this entry when it is in the normal state (neither active nor disabled). This option is ignored on Aqua/macOS. If it is specified as an empty string (the default), then the -foreground option for the overall menu is used. This option is not available for separator or tear-off entries.

-hidemargin value
  この指示項目聚の見出しに標準の余白が描かれるかを指定する｡これは､その中に影像を伴う盤の作成に便利である､即ち色パレット､紋様パレット､等｡ 1 はこの見出しの為の余白が隠蔽される; 0 は余白が使われることを意味する｡ 　　 Specifies whether the standard margins should be drawn for this menu entry. This is useful when creating palette with images in them, i.e., color palettes, pattern palettes, etc. 1 indicates that the margin for the entry is hidden; 0 means that the margin is used.

-image value
  指示項目聚に文書文字列や点地図の代りに表示する為の影像を指定する､影像は先に起動された image create によって作成されなければならない｡この指示項目は -label と -bitmap 指示項目を( -compound 指示項目により制御されているが如く)上書きするが､文書又は点地図が表示できる様に空文字に刷新することができる｡この指示項目は分割線や引裂き見出しには利用できない｡ Specifies an image to display in the menu instead of a text string or bitmap. The image must have been created by some previous invocation of image create. This option overrides the -label and -bitmap options (as controlled by the -compound option) but may be reset to an empty string to enable a textual or bitmap label to be displayed. This option is not available for separator or tear-off entries.

-indicatoron value
  検査釦かラジオ釦の見出しにのみ利用できる｡ value は指示用の臍が表示されるかを定める論理値である｡ Available only for checkbutton and radiobutton entries. Value is a boolean that determines whether or not the indicator should be displayed.

-label value
  指示項目聚の見出し内の札の識別として表示する文字列を指定する｡分割線や引裂き見出しには利用できない｡ Specifies a string to display as an identifying label in the menu entry. Not available for separator or tear-off entries.

-menu value
  ずらし表示見出しにのみ利用できる｡この見出しに結合した副指示項目聚の経路名を指定する｡副指示項目聚はこの指示項目聚の子供でなけらばならい｡ Available only for cascade entries. Specifies the path name of the submenu associated with this entry. The submenu must be a child of the menu.

-offvalue value
  検査釦の見出しにのみ利用できる｡見出しが選択解除された時に見出しに結合した変数を指定する｡ Available only for checkbutton entries. Specifies the value to store in the entry's associated variable when the entry is deselected.

-onvalue value
  検査釦の見出しにのみ利用できる｡見出しが選択された時に見出しに結合した変数を指定する｡ Available only for checkbutton entries. Specifies the value to store in the entry's associated variable when the entry is selected.

-selectcolor value
  検査釦かラジオ釦の見出しにのみ利用できる｡見出しが選択された時に指示子内に表示する色を指定する｡値が空文字列(省略時設定)の場合､指示項目聚の -selectcolor 指示項目が指示子の色を定める｡ Available only for checkbutton and radiobutton entries. Specifies the color to display in the indicator when the entry is selected. If the value is an empty string (the default) then the -selectcolor option for the menu determines the indicator color.

-selectimage value
  検査釦かラジオ釦の見出しにのみ利用できる｡見出しが選択された時に､そこに表示する影像を指定する( -image 指示項目の箇所で)｡ value は影像の名前であり､以前に起動された image create によって作成されたものでなければならない｡この指示項目は -image 指示項目が指定されていない限り無視される｡ Available only for checkbutton and radiobutton entries. Specifies an image to display in the entry (in place of the -image option) when it is selected. Value is the name of an image, which must have been created by some previous invocation of image create. This option is ignored unless the -image option has been specified.

-state value
  見出しの為の三つの状態の一つを指定する: normal か active か disabled ｡通常状態内では見出しは指示項目聚の為の -foreground 指示項目を使って､見出しか指示項目聚からは -background を使って表示される｡活性状態は典型的には指示子が見出しの上にあるときに使われる｡活性状態は見出しは､指示項目聚の為の -activeforeground 指示項目を使って､見出しからは -activebackground 指示項目に沿って表示される｡不能の状態は見出しは不感であり: 省略時設定の束縛は活性化や見出しの起動を拒絶する｡この状態では見出しは指示項目聚の -disabledforeground 指示項目に沿って､見出しからは -background 指示項目により表示される｡この指示項目は分割線には利用できない｡ Specifies one of three states for the entry: normal, active, or disabled. In normal state the entry is displayed using the -foreground option for the menu and the -background option from the entry or the menu. The active state is typically used when the pointer is over the entry. In active state the entry is displayed using the -activeforeground option for the menu along with the -activebackground option from the entry. Disabled state means that the entry should be insensitive: the default bindings will refuse to activate or invoke the entry. In this state the entry is displayed according to the -disabledforeground option for the menu and the -background option from the entry. This option is not available for separator entries.

-underline value
  見出し内の下線を引く文字の整数索引を指定する｡この指示項目は又省略時設定の束縛を問合せされ又､鍵盤横断の実装に使われる｡ 0 は見出し内の表示された文書の最初の文字に相当し､ 1 は隣の文字に､以下同様である｡もし点地図や影像が見出し内に表示されている場合､この指示項目は無視される｡この指示項目は分割線や引裂き見出しには利用できない｡ Specifies the integer index of a character to underline in the entry. This option is also queried by the default bindings and used to implement keyboard traversal. 0 corresponds to the first character of the text displayed in the entry, 1 to the next character, and so on. If a bitmap or image is displayed in the entry then this option is ignored. This option is not available for separator or tear-off entries.

-value value
  ラジオ釦の見出しにのみ利用できる｡見出しが選択された時に見出しに結合した変数を保存する為の値を指定する｡もし空文字列が指定されると､見出しの為の -label 指示項目が変数に保存される｡ Available only for radiobutton entries. Specifies the value to store in the entry's associated variable when the entry is selected. If an empty string is specified, then the -label option for the entry as the value to store in the variable.

-variable value
  検査釦かラジオ釦の見出しにのみ利用できる｡見出しが選択された時に､設定される大域変数の名前を指定する｡検査釦の見出しでは､変数は､見出しが選択解除された時にも設定される｡ラジオ釦見出しでは､変数の変化は現在選択されている見出しの選択解除を引きこす｡ 　　 Available only for checkbutton and radiobutton entries. Specifies the name of a global variable to set when the entry is selected. For checkbutton entries the variable is also set when the entry is deselected. For radiobutton entries, changing the variable causes the currently-selected entry to deselect itself.

  検査釦見出しには､この指示項目の省略時設定値が -label 指示項目から取られる､又､ラジオ釦見出しには一つの固定値が使われる｡推奨されるのは､検査釦かラジオ釦のどちらかを作成する時には常に -variable 指示項目を設定することである｡ For checkbutton entries, the default value of this option is taken from the -label option, and for radiobutton entries a single fixed value is used. It is recommended that you always set the -variable option when creating either a checkbutton or a radiobutton.

### 指示項目聚の構成設定 　MENU CONFIGURATIONS

省略時設定の束縛は４つの異なる指示項目聚の使い方を運営している: The default bindings support four different ways of using menus:

Pulldown Menus in Menubar
  之が最も普通の場合である｡先ず指示項目帯になる指示項目聚部品を作成する｡次に指示項目帯の使いたい抽斗式指示項目聚を指定してこの指示項目聚にずらし表示見出しを追加する｡次に全ての抽斗を作成する｡一度これを済ますと､頂上水準の部品命令の -menu 指示項目を使用して指示項目聚を指定する｡詳細は取扱説明書の toplevel 見出しを参照されたい｡ This is the most common case. You create a menu widget that will become the menu bar. You then add cascade entries to this menu, specifying the pull down menus you wish to use in your menu bar. You then create all of the pulldowns. Once you have done this, specify the menu using the -menu option of the toplevel's widget command. See the toplevel manual entry for details.

Pulldown Menus in Menu Buttons
  これは指示項目帯を行う方法と互換性がある｡それぞれの頂上水準の指示項目聚に一つの指示項目釦部品を作成する､次いで典型的には､指示項目帯窓内に一連の指示項目釦を一列に配置する｡更に頂上水準の指示項目聚と何かのずらし表示の副指示項目聚を作成し､ -menu 指示項目を使ってそれを指示項目釦とずらし表示見出しに結びつける｡頂上水準の指示項目聚は指示項目釦の子供でなければならず且つそれぞれの副指示項目聚はそれを参照する指示項目聚の子供でなければならない｡一度それを済ますと､省略時設定の束縛は使用者に指示項目釦経由で樹枝状の指示項目聚の捜索と起動を許容する｡詳細については取扱説明書の menubutton の見出しを参照されたい｡ 　　 This is the compatible way to do menu bars. You create one menubutton widget for each top-level menu, and typically you arrange a series of menubuttons in a row in a menubar window. You also create the top-level menus and any cascaded submenus, and tie them together with -menu options in menubuttons and cascade menu entries. The top-level menu must be a child of the menubutton, and each submenu must be a child of the menu that refers to it. Once you have done this, the default bindings will allow users to traverse and invoke the tree of menus via its menubutton; see the menubutton manual entry for details.

Popup Menus
  跳出し指示項目聚は､典型的にはマウス釦の押下か鍵盤打鍵に反応して掲示される｡跳出し指示項目聚と､何かのずらし見出し副指示項目聚を作り､次に頂上水準の指示項目聚を掲示する為に適切な時期に tk_popup 手続函数を呼ぶ｡ 　　　 Popup menus typically post in response to a mouse button press or keystroke. You create the popup menus and any cascaded submenus, then you call the tk_popup procedure at the appropriate time to post the top-level menu.

Option Menus
  選択指定の指示項目聚は幾つかの値の内の一つを選択できる様に､指示項目聚に関連した選択釦から構成される｡現在の値は選択釦内に表示されている､亦大域変数にも保存されている｡分岐の指示項目聚とその指示項目聚の作成は tk_optionMenu 手続函数を使う｡ An option menu consists of a menubutton with an associated menu that allows you to select one of several values. The current value is displayed in the menubutton and is also stored in a global variable. Use the tk_optionMenu procedure to create option menubuttons and their menus.

Torn-off Menus
  頂上水準の既存の指示項目聚での､引裂かれた指示項目聚の起動により引裂かれた指示項目聚を作成する｡省略時設定の束縛は新しい指示項目聚であって､元の指示項目聚の複写を作成し､それを離して永続的に頂上水準の窓に掲示する｡引裂き指示項目聚は元の指示項目聚と同じ振舞いをする｡ 　 You create a torn-off menu by invoking the tear-off entry at the top of an existing menu. The default bindings will create a new menu that is a copy of the original menu and leave it permanently posted as a top-level window. The torn-off menu behaves just the same as the original menu.

### 省略時設定の束縛 　DEFAULT BINDINGS

Tk は自動的に次の省略時設定の振舞を与える指示項目聚に関する級束縛を創生する: Tk automatically creates class bindings for menus that give them the following default behavior:

1. マウスが指示項目聚に入ると､マウス遊走子の下敷きになった見出しは活性化される; マウスが指示項目聚の近傍を移動すると､活性化された見出しはマウスを追跡して変化する｡ 　 When the mouse enters a menu, the entry underneath the mouse cursor activates; as the mouse moves around the menu, the active entry changes to track the mouse.

2. マウスが指示項目聚を離れると､択肢聚の全ての見出しは非活性になる､但し特別の場合として､マウスが指示項目聚からずらし表示された副指示項目聚に移動する場合を除く｡ 　　 When the mouse leaves a menu all of the entries in the menu deactivate, except in the special case where the mouse moves from a menu to a cascaded submenu.

3. マウス釦が指示項目聚の上で解除されると､活性な見出しが(もしあれば)起動される｡指示項目聚はそれが引裂かれた指示項目聚でない限り非掲示になる｡ 　　 When a button is released over a menu, the active entry (if any) is invoked. The menu also unposts unless it is a torn-off menu.

4. 空白鍵とEnt鍵は活性な見出しを起動し指示項目聚を非掲示にする｡ 　　 The Space and Return keys invoke the active entry and unpost the menu.

5. 指示項目聚のどれかの見出しの文字が -underline 指示項目を使って下線が引かれている場合､下線を引いた文字(その大文字と小文字は等価である)の一つを押すとその見出しを起動し指示項目聚を非掲示にする｡ 　　　 If any of the entries in a menu have letters underlined with the -underline option, then pressing one of the underlined letters (or its upper-case or lower-case equivalent) invokes that entry and unposts the menu.

6. Esc 鍵 はどの見出しの起動もせずに指示項目聚の選択課程を中断する｡又､引裂かれた指示項目聚でない限り指示項目聚を非掲示にする｡ 　　 The Escape key aborts a menu selection in progress without invoking any entry. It also unposts the menu unless it is a torn-off menu.

7. 上向き鍵と下向き鍵は指示項目聚内の上隣か下隣の見出しを活性化する｡指示項目聚の片方の端に到達すると､活性化見出しは他端に回り込む｡ 　 The Up and Down keys activate the next higher or lower entry in the menu. When one end of the menu is reached, the active entry wraps around to the other end.

8. 左向き鍵は次の指示項目聚を左に移す｡もし現在の指示項目聚がずらし表示された副指示項目聚の場合､その副指示項目聚は非表示にされ､且つ現在の指示項目聚見出しは親の中のずらし表示の見出しになる｡もし現在の指示項目聚が選択釦から掲示された頂上水準の指示項目聚の場合､現在の選択釦は非表示にされ且つ左の次の選択釦が掲示される｡それ以外の場合､打鍵は効果がない｡選択釦の左右の順序はその棚に積む順によって定まる: Tk は序列の低い選択釦(それは省略時設定では初めに作られたもの)が左にあると仮定する｡ 　　　 The Left key moves to the next menu to the left. If the current menu is a cascaded submenu, then the submenu is unposted and the current menu entry becomes the cascade entry in the parent. If the current menu is a top-level menu posted from a menubutton, then the current menubutton is unposted and the next menubutton to the left is posted. Otherwise the key has no effect. The left-right order of menubuttons is determined by their stacking order: Tk assumes that the lowest menubutton (which by default is the first one created) is on the left.

9. 右向き鍵は次の指示項目聚を右に移す｡もし現在の指示項目聚がずらし表示された副指示項目聚の場合､その副指示項目聚は非表示にされ､且つ現在の指示項目聚見出しは副指示項目聚の最初の見出しになる｡そうでない場合､もし現在の指示項目聚は選択釦から表示され､現在の選択釦は非表示にされ､且つ右の隣の選択釦が表示される｡ The Right key moves to the next menu to the right. If the current entry is a cascade entry, then the submenu is posted and the current menu entry becomes the first entry in the submenu. Otherwise, if the current menu was posted from a menubutton, then the current menubutton is unposted and the next menubutton to the right is posted.

不能の指示項目聚の見出しは応答しない: それは活性化されないしマウス釦の押下と解除を無視する｡ Disabled menu entries are non-responsive: they do not activate and they ignore mouse button presses and releases.

束縛の幾つかが tk_menuSetFocus 命令を利用する｡現在の注目を保存し､注目を指示項目聚の部品である pathName 引数に設定する｡ Several of the bindings make use of the command tk_menuSetFocus. It saves the current focus and sets the focus to its pathName argument, which is a menu widget.

釦の振舞いは個別の部品や級の束縛の再定義の為に新しい束縛を定義することにより変更可能である｡ The behavior of menus can be changed by defining new bindings for individual widgets or by redefining the class bindings.

### 瑕疵 BUGS

現在の処､個別の見出しに指示項目の値を指定する為に任意指定の基礎データを使う事ができない｡ At present it is not possible to use the option database to specify values for the options to individual entries.

### SEE ALSO

bind, menubutton, ttk::menubutton, toplevel

### KEYWORDS

menu, widget
Copyright © 1990-1994 The Regents of the University of California.
Copyright © 1994-1997 Sun Microsystems, Inc.