NAME
  Button - 指示項目を増強した釦部品 Button widget with enhanced options

生成 CREATION
  Button pathName ?option value...?

標準の指示項目 STANDARD OPTIONS
Not themed

  -activebackground | -activeforeground
  -anchor | -background or -bg
  -bitmap | -borderwidth or -bd
  -cursor | -disabledforeground
  -font | -foreground or -fg
  -highlightbackground | -highlightcolor
  -highlightthickness | -image
  -justify | -padx
  -pady | -repeatdelay
  -repeatinterval | -takefocus
  -text | -textvariable
  -wraplength

Themed

  -compound | -cursor
  -image | -style
  -repeatdelay | -repeatinterval
  -takefocus | -text
  -textvariable

WIDGET-SPECIFIC OPTIONS

  -armcommand | -command
  -default | -disarmcommand
  -height | -helptext
  -helptype | -helpvar
  -name | -relief
  -state | -underline
  -width

WIDGET COMMAND
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName invoke

説明 DESCRIPTION

Tk 釦に新しい指示項目を拡張した釦部品｡DynamicHelp 指示項目と､新しい立体感様式と､呼戻しの為の arm/disarm と repeatdelay/repeatinterval 指示項目が追加された｡ Button widget extends the Tk button with new options. DynamicHelp options, a new relief style, callback for arm/disarm, and repeatdelay/repeatinterval options has been added.

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

-armcommand
  釦の上でマウス釦 1 が押された時に､釦に結合する Tcl 命令を指定する｡repeatdelay か repeatinterval 指示項目が正整数の時､この命令はマウス遊走子が釦の上にある時はマウス釦 1 が離される迄繰返し呼出される｡ Specifies a Tcl command to associate with the Button when mouse button 1 is pressed over the Button. When repeatdelay or repeatinterval option is positive integer, this command is repeatedly called if mouse pointer is over the Button and until mouse button 1 is released.

-command
  釦に結合する Tcl 命令を指定する｡この命令は典型的には､釦の窓の上でマウス釦 1 が離される時に起動される｡ Specifies a Tcl command to associate with the Button. This command is typically invoked when mouse button 1 is released over the Button window.

-default
  既定の環に関する三つの状態の一つを指示する｡: normal か activeか disabled ｡active 状態では､既定の釦に関するOS固有の外観で描かれる｡ normal 状態では､非-既定の釦に関するOS固有の外観で描かれ､既定の釦の外観を描くことから充分な隔たりを置く｡normal と active 状態では同寸法の釦の結果になる｡ disabled 状態では､釦は非-既定の釦外観で既定の外観から隔たりなしに描かれる｡ disabled 状態では､活性状態より小さい釦になるかもしれない｡ Specifies one of three states for the default ring: normal, active, or disabled. In active state, the button is drawn with the platform specific appearance for a default button. In normal state, the button is drawn with the platform specific appearance for a non-default button, leaving enough space to draw the default button appearance. The normal and active states will result in buttons of the same size. In disabled state, the button is drawn with the non-default button appearance without leaving space for the default appearance. The disabled state may result in a smaller button than the active state.

-disarmcommand
  マウス釦 1 が離された時の釦に関連する Tcl 命令を指定する｡この命令は､縦え遊走子が釦の上になくても呼出され､且つ､command 指示項目によって指定された命令に優先する｡この命令は典型的には armcommand と repeatdelay と repeatinterval と一緒に使われる｡ Specifies a Tcl command to associate with the Button when mouse button 1 is released. This command is called even if pointer is not over the Button, and always before the command specified by command option. It is typically used in conjuntion with armcommand, repeatdelay and repeatinterval.

-height
  釦についての望ましい丈をしていする｡もし釦の中に影像か点地図が展示されていると､値は画像単位である; 文書については行単位である｡もしこの指示項目がしていされないと､釦の望ましい丈は､その中に展示されている影像か点地図か文書から計算される｡部品が themed の時は指示項目は利用できない｡ Specifies a desired height for the Button. If an image or bitmap is being displayed in the Button then the value is in screen units; for text it is in lines of text. If this option isn't specified, the Button's desired height is computed from the size of the image or bitmap or text being displayed in it.
  Option not available when widget is themed.

-helptext
  動的説明の文章｡もし､空文字列ならこの部品については何の説明も利用できない｡DynamicHelpをも参照されたい｡ Text for dynamic help. If empty, no help is available for this widget. See also DynamicHelp.

-helptype
  動的説明の型｡ balloon か variable を使う｡DynamicHelpを参照されたい｡ Type of dynamic help. Use balloon or variable. See also DynamicHelp.

-helpvar
  helptype 指示項目が variable の時に使う変数｡DynamicHelpを参照されたい｡ Variable to use when helptype option is variable. See also DynamicHelp.

-name
  釦の為の標準名を指定する｡もし原資基礎データに *nameName 指示項目があるとその値から text と underline 指示項目が抽出される｡ Specifies a standard name for the button. If the option *nameName is found in the resources database, then text and underline options are extracted from its value.

-relief
  部品について望ましい三次元効果を指定する｡受容れ可能な対は､釦の立体感の為の標準的値(突出､沈降､平板､畝､枠棒､溝､raised, sunken, flat, ridge, solid, groove)､及び､連鎖､これは指示子が釦の外にあると釦の立体感が平板になり､指示子が内側にあると突出になることを指定する｡この指示項目は部品が主題化themedされている時にのみ効果がある: 値連鎖は様式Toolbuttonに使用され､それ以外の値は標準の効果に使われる｡ Specifies the 3-D effect desired for the widget. Acceptable values are standard values for button relief (raised, sunken, flat, ridge, solid, and groove) and link, which specifies that button relief is flat when pointer is outside the button and raised when pointer is inside.
  This option has only the following effect if the widget is themed: The value link used a style Toolbutton while any other value uses the standard effect.

-state
  釦に関する三つの状態の内の一つを指定する: normal か active か disabled か｡通常状態では､釦は foreground と background 指示項目を使って表示される｡活性状態は典型的には指示子が釦の上に懸かっている時に使れる｡活性状態では､釦は activeforeground と activebackground 指示項目をつかって表示される｡不能状態は釦が不感性である: 無為設定の束縛は部品を活性化することを拒否しマウス釦押下を無視することになる｡この状態で disabledforeground と background 指示項目が釦を如何に表示するかを決定する｡ Specifies one of three states for the Button: normal, active, or disabled. In normal state the Button is displayed using the foreground and background options. The active state is typically used when the pointer is over the Button. In active state the Button is displayed using the activeforeground and activebackground options. Disabled state means that the Button 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.

-underline
  釦の名札内の下線を引くべき文字の整数番号を指定する｡0 は展示される文書の最初の文字に相当する､1は次の文字､以下同じ｡ Specifies the integer index of a character to underline in the label of the button. 0 corresponds to the first character of the text displayed, 1 to the next character, and so on.
  代替文字の <Alt-char> 束縛は Button::setfocus 呼出すべき釦の頂上水準で自動的に設定される｡ The binding <Alt-char> is automatically set on the toplevel of the Button to call Button::setfocus.

-width
  もし影像か点地図が釦内に展示されていると､値は画面単位である; 文章に関しては文字単位である｡もしこの指示項目が指定されていないと､釦の望ましい巾はその中に表示される影像か点地図か文書の寸法から計算される｡ 　 If an image or bitmap is being displayed in the Button then the value is in screen units; for text it is in characters. If this option isn't specified, the Button's desired width is computed from the size of the image or bitmap or text being displayed in it.

部品命令 WIDGET COMMAND

pathName cget option
  optionによって与えられた構成設定指示項目の現在の値を返す｡ optionは創生命令によって受容れられるどの様な値をも持ち得る｡ Returns the current value of the configuration option given by option. Option may have any of the values accepted by the creation command.

pathName configure ?option? ?value option value ...?
  部品の指示項目を問合せ又は修正する｡もし option なしで指示されると pathNameについて全ての利用可能な指示項目を記述したリストを返す｡もし option が値なしで指定されると､本命令は option と名付けられたものを記述するリストを返す(このリストは option が指定されない時に返される値の仔リストに相当するものに等しい)｡もし一つ或はそれ以上の option-value 対が指定されると､本命令は与えられた部品指示項目に与えた値を持たせる; この場合､本命令は､空文字列を返す｡ option は命令創生によって受容れられるどの値をも持ち得る｡読出し専用の指示項目は修正されない｡ 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. 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 creation command. Read-only options are not be modified.

pathName invoke
  もし釦の状態が不能でなければ､これは釦の命令を起動する｡釦が活性の色で窪んだ立体感で再展示され次に armcommand が呼出される｡次に釦が通常の色と定義された立体感で再展示され disarmcommand になりcommandが呼出される｡ If Button state is not disabled, this invoke the commands of the Button. Button is redisplayed with active color and sunken relief, and armcommand is called. Then Button is redisplayed with normal color and its defined relief, and disarmcommand then command are called.

  釦が注目を有し､且つ使用者が空白鍵を押すと invoke が呼出される｡ invoke is called when Button has input focus and user press the space bar.

束縛 BINDINGS

<<Invoke>>
  invoke 部品命令を起動する｡ Invoke the invoke widget command.