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

### 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
    menubutton — 跳び出し選択釦部品 '選択釦' の作成と操作 Create and manipulate 'menubutton' pop-up menu indicator widgets
  構文 SYNOPSIS
  STANDARD OPTIONS
    -activebackground, activeBackground, Foreground
    -activeforeground, activeForeground, Background
    -anchor, anchor, Anchor
    -background or -bg, background, Background
    -bitmap, bitmap, Bitmap
    -borderwidth or -bd, borderWidth, BorderWidth
    -compound, compound, Compound
    -cursor, cursor, Cursor
    -disabledforeground, disabledForeground, DisabledForeground
    -font, font, Font
    -foreground or -fg, foreground, Foreground
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -image, image, Image
    -justify, justify, Justify
    -padx, padX, Pad
    -pady, padY, Pad
    -relief, relief, Relief
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -textvariable, textVariable, Variable
    -underline, underline, Underline
    -wraplength, wrapLength, WrapLength
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -direction, direction, Direction
    -height, height, Height
    -indicatoron, indicatorOn, IndicatorOn
    -menu, menu, MenuName
    -state, state, State
    -width, width, Width
  緒論 INTRODUCTION
  部品命令 WIDGET COMMAND
    pathName cget option
    pathName configure ?option? ?value option value ...?
  DEFAULT BINDINGS
  SEE ALSO
  KEYWORDS

### NAME

menubutton — 跳び出し選択釦部品 '選択釦' の作成と操作 Create and manipulate 'menubutton' pop-up menu indicator widgets

### 構文 SYNOPSIS

menubutton pathName ?options?

### STANDARD OPTIONS

-activebackground, activeBackground, Foreground
-activeforeground, activeForeground, Background
-anchor, anchor, Anchor
-background or -bg, background, Background
-bitmap, bitmap, Bitmap
-borderwidth or -bd, borderWidth, BorderWidth
-compound, compound, Compound
-cursor, cursor, Cursor
-disabledforeground, disabledForeground, DisabledForeground
-font, font, Font
-foreground or -fg, foreground, Foreground
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-image, image, Image
-justify, justify, Justify
-padx, padX, Pad
-pady, padY, Pad
-relief, relief, Relief
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-wraplength, wrapLength, WrapLength

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

Command-Line Name: -direction
Database Name: direction
Database Class: Direction
  指示項目聚が何処に現れようとするかを指定する｡ above は指示項目釦の上に指示項目聚を表そうと試みる｡ below は指示項目釦の下に指示項目聚を表そうと試みる｡ left は指示項目釦の左に指示項目聚を表そうと試みる｡ right は指示項目釦の右に指示項目聚を表そうと試みる｡ flush は指示項目釦の上に指示項目聚を直接表す｡ above や below の場合､指示項目聚を画面外に示す場合は逆の方向になる｡ Specifies where the menu is going to be popup up. above tries to pop the menu above the menubutton. below tries to pop the menu below the menubutton. left tries to pop the menu to the left of the menubutton. right tries to pop the menu to the right of the menu button. flush pops the menu directly over the menubutton. In the case of above or below, the direction will be reversed if the menu would show offscreen.

Command-Line Name: -height
Database Name: height
Database Class: Height
  指示項目釦の為の望ましい高さを指定する｡もし影像か点地図が指示項目釦の中に展示されている場合､値は画面単位である(即ち､ Tk_GetPixels に受入れられるどの形式でもよい); 文章では文章の行数を単位にする｡もしこの指示項目が指定されないと､指示項目釦の望ましい高さは其処に展示されている画像か点地図か文章の寸法から計算される｡ Specifies a desired height for the menubutton. If an image or bitmap is being displayed in the menubutton then the value is in screen units (i.e. any of the forms acceptable to Tk_GetPixels); for text it is in lines of text. If this option is not specified, the menubutton's desired height is computed from the size of the image or bitmap or text being displayed in it.

Command-Line Name: -indicatoron
Database Name: indicatorOn
Database Class: IndicatorOn
  この値は適切な論理値でなければならない｡もし真値の場合､小さな表示器矩形が指示項目釦の右側に表示され､省略時設定の指示項目聚の結合が追加の指示項目釦として扱うことになる｡もし偽値の場合表示器は表示されない｡ The value must be a proper boolean value. If it is true then a small indicator rectangle will be displayed on the right side of the menubutton and the default menu bindings will treat this as an option menubutton. If false then no indicator will be displayed.

Command-Line Name: -menu
Database Name: menu
Database Class: MenuName
  この選択釦に結合した指示項目聚の経路名を指定する｡指示項目聚は選択釦の子供でなくてはならない｡ Specifies the path name of the menu associated with this menubutton. The menu must be a child of the menubutton.

Command-Line Name: -state
Database Name: state
Database Class: State
  指示項目釦に関する三つの内の一つの状態を指定する: normal か active か disabled.｡通常状態では､指示項目釦は foreground と background 指示項目を使用して展示される｡活性状態は典型的には指示子が指示項目釦に重なった時に使用する｡活性状態では､指示項目釦は activeForeground と activeBackground 指示項目を使用して展示される｡不能状態は検査釦が無反応であろう: 省略時設定の束縛では､部品を活性化することを拒否し､マウス釦の押下を無視する｡この状態では disabledForeground と background 指示項目が指示項目釦を如何に展示するかを決定する｡ Specifies one of three states for the menubutton: normal, active, or disabled. In normal state the menubutton is displayed using the foreground and background options. The active state is typically used when the pointer is over the menubutton. In active state the menubutton is displayed using the -activeforeground and -activebackground options. Disabled state means that the menubutton should be insensitive: the default bindings will refuse to activate the widget and will ignore mouse button presses. In this state the -disabledforeground and -background options determine how the button is displayed.

Command-Line Name: -width
Database Name: width
Database Class: Width
  指示項目釦に対して望ましい幅を指定する｡もし影像か点地図が指示項目釦の中に展示されている場合､値は画面単位である(即ち､ Tk_GetPixels に受入れられるどの形式でもよい); 文章では文章の行数を単位にする｡もしこの指示項目が指定されないと､指示項目釦の望ましい幅は其処に展示されている画像か点地図か文章の寸法から計算される｡ Specifies a desired width for the menubutton. If an image or bitmap is being displayed in the menubutton then the value is in screen units (i.e. any of the forms acceptable to Tk_GetPixels); for text it is in characters. If this option is not specified, the menubutton's desired width is computed from the size of the image or bitmap or text being displayed in it.

### 緒論 INTRODUCTION

この menubutton 命令は( pathName 引数を与えられて)新しい窓を生成し､それを選択釦部品にする｡上に記述した追加的な指示項目は､命令行あるいは指示項目基本データとして選択釦の概観を構成設定する､譬えば､色､文字形状､文書､初期立体感｡この menubutton 命令はその pathName 引数を返す｡この命令が起動される時､ pathName の名前の窓が存在してはならないが､ pathName の親が存在していなければならない｡ The menubutton command creates a new window (given by the pathName argument) and makes it into a menubutton widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the menubutton such as its colors, font, text, and initial relief. The menubutton 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.

釦は文章の文字列や､点地図や､図形を展示している部品である｡もし文書が展示されていると､それは単一の字形のはずである､ただ､画面上の複数行を占めるかもしれない(それに改行印が含まれるか､ wraplength 指示項目による折畳みが生じた時)又､文字のどれか一つが underline 指示項目を使って下線が引かれているかもしれない｡通常の使い方では､指示項目釦の上でマウス釦 1 を押すと指示項目釦の下に結合した指示項目聚が貼り出される｡もしマウスが､マウス釦を押す前に指示項目聚から離れると､下の指示項目聚見出しのマウス離脱が起動される｡釦が解除されると､指示項目聚は矧ぎ取られる｡ A menubutton is a widget that displays a textual string, bitmap, or image and is associated with a menu widget. If text is displayed, it must all be in a single font, but it can occupy multiple lines on the screen (if it contains newlines or if wrapping occurs because of the -wraplength option) and one of the characters may optionally be underlined using the -underline option. In normal usage, pressing mouse button 1 over the menubutton causes the associated menu to be posted just underneath the menubutton. If the mouse is moved over the menu before releasing the mouse button, the button release causes the underlying menu entry to be invoked. When the button is released, the menu is unposted.

マックの macOS 上のリストから一つの品目を使用者が選択することを許容する為に好まれる機構の tk_optionMenu を構築する為に選択釦帯が使われる｡ Menubuttons are used to construct a tk_optionMenu, which is the preferred mechanism for allowing a user to select one item from a list on macOS.

選択釦は又典型的に指示項目聚帯と呼ばれる群の中に組込まれ､走査を可能にする: もしマウス釦が一つの指示項目釦上で押され(それにより指示項目聚に知らせる)且つマウスが同じ指示項目聚帯内の別の指示項目釦にマウス釦の解除なしに移動されると､初めの指示項目釦は通知が剥され､且つ､新しい指示項目釦の指示項目聚が代りに通知される｡この方法は､指示項目聚帯の様に指示項目聚menuを直接設定する好みからは忌避される; その手順については toplevel の -menu 指示項目を参照されたい｡ Menubuttons were also typically organized into groups called menu bars that allow scanning: if the mouse button is pressed over one menubutton (causing it to post its menu) and the mouse is moved over another menubutton in the same menu bar without releasing the mouse button, then the menu of the first menubutton is unposted and the menu of the new menubutton is posted instead. This use is deprecated in favor of setting a menu directly as a menubar; see the toplevel's -menu option for how to do that.

指示項目釦と指示項目聚の間には幾つかの対話機能がある; 種々の指示項目聚の構成設定､譬えば引出し指示項目聚や追加的指示項目の情報については取扱説明書の menu の項を参照されたい｡ There are several interactions between menubuttons and menus; see the menu manual entry for information on various menu configurations, such as pulldown menus and option menus.

### 部品命令 WIDGET COMMAND

menubutton 命令は pathName と言う名前の新しい Tcl 命令を生成する｡この命令は部品上の種々の指示項目を起動する為に使うことができる｡それは次の一般式を有する: The menubutton 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 ...?

option と arg は命令の正確な振舞いを定める｡次の命令が釦部品について可能である: Option and the args determine the exact behavior of the command. The following commands are possible for menubutton widgets:

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

pathName configure ?option? ?value option value ...?
  部品の構成設定できる指示項目の値を問合せ又は修正する｡もし option が指定されないと､ pathName について利用できる全ての指示項目を記述したリストを返す(このリストの書式の情報については Tk_ConfigureInfo を参照されたい)｡もし value なしで option が指定されると､その名前の指示項目を記述したリストが返る(このリストは､ option を指定しない時に返るリストの部分リストになっている)｡もし､一つ或はそれ以上のoption-value 対が指定されると､命令は､与えられた指示項目を与えられた値に修正する; この場合､命令は空文字列を返す｡ option はmenubutton 命令が受入れるどの値を有していてもよい｡ 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 menubutton command.

### DEFAULT BINDINGS

指示項目釦についてTk は級束縛を自動的に生成する､それが省略時の振舞いを与える: Tk automatically creates class bindings for menubuttons that give them the following default behavior:

1. マウスがその上を過る時は何時でも指示項目釦は活性になり､マウスが釦から離れると何時でも非活性になる｡ A menubutton activates whenever the mouse passes over it and deactivates whenever the mouse leaves it.

2. 指示項目釦の上でマウス釦 1 を押すと指示項目釦が張り付く: その立体感が突出に変化し且つ結合している指示項目聚が指示項目釦の下に張り付く｡もしマウスが釦を依然として下したまま指示項目聚内に曳き摺る場合､且つもしマウス釦が指示項目聚の入り口内の上で解除された場合､指示項目釦は剥され､指示項目聚の入り口が起動される｡ Pressing mouse button 1 over a menubutton posts the menubutton: its relief changes to raised and its associated menu is posted under the menubutton. If the mouse is dragged down into the menu with the button still down, and if the mouse button is then released over an entry in the menu, the menubutton is unposted and the menu entry is invoked.

3. もし釦 1 が指示項目釦の上で押され且つ､その指示項目釦の上で解放された場合､その指示項目釦は表示され続ける: 更に指示項目聚内を移動し見出しの上で釦 1 を軽叩して起動することもできる｡見出しがひとたび起動されると指示項目釦は表示されなくなる｡ If button 1 is pressed over a menubutton and then released over that menubutton, the menubutton stays posted: you can still move the mouse over the menu and click button 1 on an entry to invoke it. Once a menu entry has been invoked, the menubutton unposts itself.

4. もし釦 1 が指示項目釦の上で押され且つ､別の指示項目釦の上に引張られると､初めの指示項目釦は自身を剥しとり新しい指示項目釦が貼られる｡ If button 1 is pressed over a menubutton and then dragged over some other menubutton, the original menubutton unposts itself and the new menubutton posts.

5. もし釦 1 が指示項目釦の上で押され且つ､どの指示項目釦や指示項目聚の外で解除された場合､どの指示項目聚の見出しも起動せずに指示項目釦は表示されなくなる｡ If button 1 is pressed over a menubutton and released outside any menubutton or menu, the menubutton unposts without invoking any menu entry.

6. 指示項目釦が貼られた時､その結合した指示項目聚は入力の注目に指示項目聚とその副指示項目聚の鍵盤横断を許容することを宣言する｡この束縛の詳細については取り扱い説明書の menu の見出しを参照されたい｡ When a menubutton is posted, its associated menu claims the input focus to allow keyboard traversal of the menu and its submenus. See the menu manual entry for details on these bindings.

7. 指示項目釦の為に underline 指示項目が設定されている場合､鍵盤横断は指示項目釦の貼り付けの為に使われるかもしれない: Alt+x, ここで x は下線を引かれた文字(又は小文字又は大文字が等価)はどの指示項目釦の頂上水準の基の窓ないでも指示項目釦を貼る為に打鍵されてよい｡ If the -underline option has been specified for a menubutton then keyboard traversal may be used to post the menubutton: Alt+x, where x is the underlined character (or its lower-case or upper-case equivalent), may be typed in any window under the menubutton's toplevel to post the menubutton.

8. F10 鍵は最初の指示項目釦を不能ではない頂上水準の窓に張付ける為にどの窓内で打鍵されてもよい｡ The F10 key may be typed in any window to post the first menubutton under its toplevel window that is not disabled.

9. もし指示項目釦が入力の注目を有している場合､スペース鍵とEnter鍵は指示項目釦を張付ける｡ If a menubutton has the input focus, the space and return keys post the menubutton.

指示項目釦の状態が､不能 の場合上のどの活動も起こらない： 指示項目釦は完全に不感応になる｡ If the menubutton's state is disabled then none of the above actions occur: the menubutton is completely non-responsive.

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

### SEE ALSO

ttk::menubutton, menu

### KEYWORDS

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