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

### 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
    ttk::checkbutton — 是/非 部品　On/off widget
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -compound, compound, Compound
    -cursor, cursor, Cursor
    -image, image, Image
    -state, state, State
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -textvariable, textVariable, Variable
    -underline, underline, Underline
    -width, width, Width
  部品固有の指定項目 WIDGET-SPECIFIC OPTIONS
    -command, command, Command
    -offvalue, offValue, OffValue
    -onvalue, onValue, OnValue
    -variable, variable, Variable
  部品命令 WIDGET COMMAND
    pathname invoke
  部品の状態 WIDGET STATES
  標準様式 STANDARD STYLES
  様式指示項目 STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::checkbutton — 是/非 部品　On/off widget

### 構文 SYNOPSIS

ttk::checkbutton pathName ?options?

### 説明 DESCRIPTION

ttk::checkbutton 部品は設定の表示と変更に使われる｡選択と非選択の二つの状態を有する｡点検釦の状態は Tcl 変数と連結されることもある｡　　　　　　　　 A ttk::checkbutton widget is used to show or change a setting. It has two states, selected and deselected. The state of the checkbutton may be linked to a Tcl variable.

### STANDARD OPTIONS

-class, undefined, undefined
-compound, compound, Compound
-cursor, cursor, Cursor
-image, image, Image
-state, state, State
-style, style, Style
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-width, width, Width

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

Command-Line Name: -command
Database Name: command
Database Class: Command
  部品が起動された時に評価する為の記述譜｡　　　　　　　 A Tcl script to execute whenever the widget is invoked.

Command-Line Name: -offvalue
Database Name: offValue
Database Class: OffValue
  部品が非選択になった時に -variable に結合した中に保存する為の値｡省略時設定は 0 ｡　　　　　 The value to store in the associated -variable when the widget is deselected. Defaults to 0.

Command-Line Name: -onvalue
Database Name: onValue
Database Class: OnValue
  部品が選択になった時に -variable に結合した中に保存する為の値｡省略時設定は 1 ｡　　　　　　 The value to store in the associated -variable when the widget is selected. Defaults to 1.

Command-Line Name: -variable
Database Name: variable
Database Class: Variable
  値が部品に結合されている大域変数の名前｡もし指定されない場合､省略時設定は部品の経路名｡ 　　　　 The name of a global variable whose value is linked to the widget. Defaults to the widget pathname if not specified.

### 部品命令 WIDGET COMMAND

標準の cget と configure と identify と instate と state に加えて､点検釦は次の追加的部品命令を運営している:　　　　　　 In addition to the standard cget, configure, identify, instate, and state commands, checkbuttons support the following additional widget commands:

pathname invoke
  選択状態と非選択状態の間を巡回し､結合した -command を評価する｡もし部品が現在選択されていると､ -variable を -offvalue に設定し､部品を非設定にする; そうでない場合､ -variable を -onvalue に設定し､-command の結果を返す｡　　　 Toggles between the selected and deselected states and evaluates the associated -command. If the widget is currently selected, sets the -variable to the -offvalue and deselects the widget; otherwise, sets the -variable to the -onvalue Returns the result of the -command.

### 部品の状態 WIDGET STATES

もし disabled 状態が設定されていると部品は使用者の入力に反応しない｡何時であれ連結した -variable が部品の -onvalue に設定されると部品は selected 状態を設定する､それ以外なら解消する｡何時であれ連結した -variable が消去されると部品は alternate を設定する｡( alternate 状態は“三叉状態” 又は “中間の状態”の選択を指し示す為も使用される｡)　　　　　　　 The widget does not respond to user input if the disabled state is set. The widget sets the selected state whenever the linked -variable is set to the widget's -onvalue, and clears it otherwise. The widget sets the alternate state whenever the linked -variable is unset. (The alternate state may be used to indicate a “tri-state” or “indeterminate” selection.)

### 標準様式 STANDARD STYLES

Ttk::checkbutton 部品は､標準的主題の Toolbutton 方式を運営している､それは道具帯の部品生成に便利である｡ Ttk::checkbutton widgets support the Toolbutton style in all standard themes, which is useful for creating widgets for toolbars.

### 様式指示項目 STYLING OPTIONS

ttk::checkbutton の級の名前は TCheckbutton である｡　　　　　　 The class name for a ttk::checkbutton is TCheckbutton.

Dynamic states: active, alternate, disabled, pressed, selected, readonly.

ttk::style を使って構成設定可能な TCheckbutton 様式指示項目は以下の通り： TCheckbutton styling options configurable with ttk::style are:

-background color
-compound compound
-foreground color
-indicatorbackground color
-indicatorcolor color
-indicatormargin padding
-indicatorrelief relief
-padding padding

幾つかの指示項目は特別の主題の為にのみ利用できる｡　　　　 Some options are only available for specific themes.

ttk 様式を如何に構成設定するかの情報は ttk::style の取扱い説明書頁を参照されたい｡　　　　　 See the ttk::style manual page for information on how to configure ttk styles.

### SEE ALSO

ttk::widget, ttk::radiobutton, checkbutton

### KEYWORDS

widget, button, toggle, check, option
Copyright © 2004 Joe English