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

### 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::entry — 編集可能な文書欄枠部品 Editable text field widget
  構文 SYNOPSIS
  説明 DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -font, font, Font
    -foreground, textColor, TextColor
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -xscrollcommand, xScrollCommand, ScrollCommand
  部品固有の指示項目 WIDGET-SPECIFIC OPTIONS
    -exportselection, exportSelection, ExportSelection
    -invalidcommand, invalidCommand, InvalidCommand
    -justify, justify, Justify
    -show, show, Show
    -state, state, State
    -textvariable, textVariable, Variable
    -validate, validate, Validate
    -validatecommand, validateCommand, ValidateCommand
    -width, width, Width
  註意NOTES
  位置　INDICES
    number
    @number
    end
    insert
    sel.first
    sel.last
  部品命令WIDGET COMMAND
    pathName bbox index
    pathName delete first ?last?
    pathName get
    pathName icursor index
    pathName index index
    pathName insert index string
    pathName selection option arg
      pathName selection clear
      pathName selection present
      pathName selection range start end
    pathName validate
  VALIDATION
  妥当性確認様式VALIDATION MODES
    none
    key
    focus
    focusin
    focusout
    all
  妥当性確認 記述譜の置換 VALIDATION SCRIPT SUBSTITUTIONS
    %d
    %i
    %P
    %s
    %S
    %v
    %V
    %W
  DIFFERENCES FROM TK ENTRY WIDGET VALIDATION
  省略時設定の束縛 DEFAULT BINDINGS
  WIDGET STATES
  様式の指示項目 STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::entry — 編集可能な文書欄枠部品 Editable text field widget

### 構文 SYNOPSIS

ttk::entry pathName ?options?

### 説明 DESCRIPTION

ttk::entry 部品は一行の文書文字列を表示し､その文字列を使用者により編集されることを許容する｡文字列の値は -textvariable 指示項目を使用して Tcl 変数と連結することができる｡入り口部品は標準の -xscrollcommand 指示項目を使った水平摺動と xview 部品命令を運営する｡ An ttk::entry widget displays a one-line text string and allows that string to be edited by the user. The value of the string may be linked to a Tcl variable with the -textvariable option. Entry widgets support horizontal scrolling with the standard -xscrollcommand option and xview widget command.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-font, font, Font
-foreground, textColor, TextColor
-style, style, Style
-takefocus, takeFocus, TakeFocus
-xscrollcommand, xScrollCommand, ScrollCommand

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

Command-Line Name: -exportselection
Database Name: exportSelection
Database Class: ExportSelection
  部品内の選択が X 選択と連結すべきか否かを指定する論理値｡もし選択が移出されると､部品内の選択が現在の X 選択を非選択にし､部品の外の選択はどの部品の選択も非選択にし､且つ部品はそれが選択を有する時に選択の取り返し要求に反応する｡ A boolean value specifying whether or not a selection in the widget should be linked to the X selection. If the selection is exported, then selecting in the widget deselects the current X selection, selecting outside the widget deselects any widget selection, and the widget will respond to selection retrieval requests when it has a selection.

Command-Line Name: -invalidcommand
Database Name: invalidCommand
Database Class: InvalidCommand
  何時であれ､ validateCommand が 0 を返す時､評価すべき記述譜の基本｡更なる情報は下の VALIDATION を参照されたい｡ A script template to evaluate whenever the -validatecommand returns 0. See VALIDATION below for more information.

Command-Line Name: -justify
Database Name: justify
Database Class: Justify
  入り口部品内で文書が整列される方法を指定する｡ left か center か right のどれか｡ Specifies how the text is aligned within the entry widget. One of left, center, or right.

Command-Line Name: -show
Database Name: show
Database Class: Show
  もしこの指示項目が設定されると､入り口の真の内容は窓内に表示されない｡代りに､入り口の値のそれぞれの文字はこの指示項目の最初の文字で譬えば “*” の如く表示される｡これは､譬えば入り口が暗証番号入力に使われる場合に便利である｡もし入り口の文字が選択され､どこかに複写されると､表示されて複写された情報は真の入り口の内容ではない｡ If this option is specified, then the true contents of the entry are not displayed in the window. Instead, each character in the entry's value will be displayed as the first character in the value of this option, such as “*” or a bullet. This is useful, for example, if the entry is to be used to enter a password. If characters in the entry are selected and copied elsewhere, the information copied will be what is displayed, not the true contents of the entry.

Command-Line Name: -state
Database Name: state
Database Class: State
  互換性の指示項目; 詳細は ttk::widget(n) を参照されたい｡入り口に関して三つの内の一つを指定する: normal か disabled か readonly ｡下の WIDGET STATES を参照されたい｡ Compatibility option; see ttk::widget(n) for details. Specifies one of three states for the entry, normal, disabled, or readonly. See WIDGET STATES, below.

Command-Line Name: -textvariable
Database Name: textVariable
Database Class: Variable
  入り口部品の内容と連結した値の大域変数の名前を指定する｡何時であれ値が変わると､部品の内容が更新される､逆もまた起こる｡ Specifies the name of a global variable whose value is linked to the entry widget's contents. Whenever the variable changes value, the widget's contents are updated, and vice versa.

Command-Line Name: -validate
Database Name: validate
Database Class: Validate
  妥当性確認を操作する方法を指定する: none か focus か focusin か focusout か key か all ｡省略時設定は none であり､妥当性確認は運休を意味する｡下の VALIDATION を参照されたい｡ Specifies the mode in which validation should operate: none, focus, focusin, focusout, key, or all. Default is none, meaning that validation is disabled. See VALIDATION below.

Command-Line Name: -validatecommand
Database Name: validateCommand
Database Class: ValidateCommand
  何時であれ妥当性確認が発動されると評価される標準記述譜｡もし空文字列が指定されると(省略時設定)､妥当性確認は運休する｡記述譜は論理値を返さねばならない｡下の VALIDATION を参照されたい｡ A script template to evaluate whenever validation is triggered. If set to the empty string (the default), validation is disabled. The script must return a boolean value. See VALIDATION below.

Command-Line Name: -width
Database Name: width
Database Class: Width
  望ましい入り口窓の幅を指し示す整数を､部品の文字形状の平均文字寸法を単位として指定する｡ Specifies an integer value indicating the desired width of the entry window, in average-size characters of the widget's font.

### 註意NOTES

入り口の一部分が下に記述するように選択されるかもしれない｡もし入り口が選択を移入していると( -exportSelection 指示項目を参照されたい)､選択を処理する標準 X11 通信規約を遵守する; 入り口選択は STRING 型として利用できる｡入り口はまた入力の注目に関する標準 Tk 規則を遵守する｡入り口が入力の注目を有していると挿入する文字の位置を指し示す挿入遊走子を表示する｡ A portion of the entry may be selected as described below. If an entry is exporting its selection (see the -exportselection option), then it will observe the standard X11 protocols for handling the selection; entry selections are available as type STRING. Entries also observe the standard Tk rules for dealing with the input focus. When an entry has the input focus it displays an insert cursor to indicate where new characters will be inserted.

入り口は部品窓内に完全に収容するには長すぎる文字列を表示する能力を有する｡この場合､文書の一部だけが表示されることになる; 下に記述された命令は窓内の視野の変更に使用できる｡入り口は摺動盤の相互作用機能の為に標準的な xScrollCommand 仕組みを使う(詳細は xScrollCommand 指示項目の記述を参照されたい)｡ 　　　 Entries are capable of displaying strings that are too long to fit entirely within the widget's window. In this case, only a portion of the string will be displayed; commands described below may be used to change the view in the window. Entries use the standard -xscrollcommand mechanism for interacting with scrollbars (see the description of the -xscrollcommand option for details).

### 位置　INDICES

多くの入り口部品命令entryは一つ或はそれ以上の位置を引数としてとる｡位置は入り口の文字列内の特定の文字を次のどれかの方法で指定する: Many of the entry widget commands take one or more indices as arguments. An index specifies a particular character in the entry's string, in any of the following ways:

number
  文字を数字の位置で指定する､ここで 0 は文字列の最初の文字に対応する｡ Specifies the character as a numerical index, where 0 corresponds to the first character in the string.

@number
  この形式内では number は入り口窓内のx-座標として扱われる; x-座標に架かっている文字が使われる｡譬えば “@0” は窓内の最も左の文字を指し示す｡ 　　　 In this form, number is treated as an x-coordinate in the entry's window; the character spanning that x-coordinate is used. For example, “@0” indicates the left-most character in the window.

end
  入り口の文字列の最後の文字の直後の文字を指定する｡これは､入り口の文字列の長さに等しい数字の位置を指定することと等価である｡　　　　　　 Indicates the character just after the last one in the entry's string. This is equivalent to specifying a numerical index equal to the length of the entry's string.

insert
  挿入遊走子に隣接して直ぐ後ろの文字を指し示す｡ Indicates the character adjacent to and immediately following the insert cursor.

sel.first
  選択内の最初の文字を指し示す｡もし選択が入り口窓内にない場合にこの形式を使用することは不都合である｡ Indicates the first character in the selection. It is an error to use this form if the selection is not in the entry window.

sel.last
  選択内の最後の文字のすぐ後の文字を指し示す｡もし選択が入り口窓内にない場合にこの形式を使用することは不都合である｡ Indicates the character just after the last one in the selection. It is an error to use this form if the selection is not in the entry window.

上述のどれにでも短縮形が使用できる､譬えば “e” や “sel.l” ｡一般に､範囲外を指し示すと自動的に最も近くの適切な値に丸められる｡ Abbreviations may be used for any of the forms above, e.g. “e” or “sel.l”. In general, out-of-range indices are automatically rounded to the nearest legal value.

### 部品命令WIDGET COMMAND

次の命令が入り口部品に可能である: The following subcommands are possible for entry widgets:

pathName bbox index
  index で与えられる文字の囲み箱を記述する４つの数のリストを返す｡初めの二つの要素は文字に覆われた画面領域の左上隅の x と y 座標(部品に相対的な画素単位)で最後の二つは文字の幅と高さで､画素単位である｡この囲み箱は窓の可視領域の外側の領域を参照することもある｡ Returns a list of four numbers describing the bounding box of the character given by index. The first two elements of the list give the x and y coordinates of the upper-left corner of the screen area covered by the character (in pixels relative to the widget) and the last two elements give the width and height of the character, in pixels. The bounding box may refer to a region outside the visible area of the window.

pathName delete first ?last?
  一つ或はそれ以上の入り口の要素を削除する｡ first は削除する最初の文字の位置､そして､ last は削除する最後の文字の丁度次の文字の位置である｡もし last が指定されないと､省略時設定は first+1 即ち一つの文字が削除される｡この命令は空文字列を返す｡ Delete one or more elements of the entry. First is the index of the first character to delete, and last is the index of the character just after the last one to delete. If last is not specified it defaults to first+1, i.e. a single character is deleted. This command returns the empty string.

pathName get
  入り口の文字列を返す｡ Returns the entry's string.

pathName icursor index
  挿入遊走子を index で与えられる文字の丁度前の展示される位置に手配する｡空文字列を返す｡ Arrange for the insert cursor to be displayed just before the character given by index. Returns the empty string.

pathName index index
  index に対応する数字の位置を返す｡ Returns the numerical index corresponding to index.

pathName insert index string
  index で指し示す文字の丁度前に string の文字をを挿入する｡空文字列を返す｡ Insert string just before the character indicated by index. Returns the empty string.

pathName selection option arg
  この命令は入り口内部の選択の調整に使われる｡ option によって幾つかの形式がある: This command is used to adjust the selection within an entry. It has several forms, depending on option:

  pathName selection clear
    選択がその部品内に現在あると消去する｡もし選択がこの部品にないと､この命令は効果を及ぼさない｡空文字列を返す｡ Clear the selection if it is currently in this widget. If the selection is not in this widget then the command has no effect. Returns the empty string.

  pathName selection present
    入り口内に選択された文字があると1 選択されてないと 0 ｡ Returns 1 if there is are characters selected in the entry, 0 if nothing is selected.

  pathName selection range start end
    start によって指定される文字と end の丁度前で終る間の文字を含む選択を設定する｡もし､ end が start の文字と同じかそれより前の文字を参照すると入り口の参照は解消される｡ Sets the selection to include the characters starting with the one indexed by start and ending with the one just before end. If end refers to the same character as start or an earlier one, then the entry's selection is cleared.

pathName validate
  -validate 指示項目によって指定された条件に関係なく再度の妥当性確認を強制する｡妥当性確認に失敗すると 0 成功すると 1 を返す｡更なる詳細は下の VALIDATION を参照されたい｡ Force revalidation, independent of the conditions specified by the -validate option. Returns 0 if validation fails, 1 if it succeeds. Sets or clears the invalid state accordingly. See VALIDATION below for more details.

入り口部品は次の ttk::widget 部品共通命令も運営している(詳細は ttk::widget(n) を参照されたい): The entry widget also supports the following generic ttk::widget widget subcommands (see ttk::widget(n) for details):

  cget | configure | identify
  instate | state | xview

### VALIDATION

入り口部品が妥当性確認できるように -validate と -validatecommand と -invalidcommand との指示項目が使える｡ The -validate, -validatecommand, and -invalidcommand options are used to enable entry widget validation.

#### 妥当性確認様式VALIDATION MODES

二つの主なる妥当性確認方法がある: prevalidation そこでは､ -validatecommand がそれぞれの編集に先立って評価され､返って来る値は変化を受入れるか拒絶するかの決定につかわれる; 又､ revalidation では､ -validatecommand は現在の値が妥当であるかの決定を評価する｡ There are two main validation modes: prevalidation, in which the -validatecommand is evaluated prior to each edit and the return value is used to determine whether to accept or reject the change; and revalidation, in which the -validatecommand is evaluated to determine whether the current value is valid.

-validate 指示項目は妥当性確認を生じる時を定める; 次の値のどれかに設定される: The -validate option determines when validation occurs; it may be set to any of the following values:

none
  省略時設定｡この意味は validate 部品命令に特別に要求された時にのみ妥当性確認が生じる｡ Default. This means validation will only occur when specifically requested by the validate widget command.

key
  入り口はそれぞれの編集に先立って予備的に妥当性確認される(特に､ insert か delete 部品命令が呼ばれた時には何時でも)｡予備の妥当性確認に失敗すると､編集は拒絶される｡ The entry will be prevalidated prior to each edit (specifically, whenever the insert or delete widget commands are called). If prevalidation fails, the edit is rejected.

focus
  入り口が注目を受取るか失うと入り口は再度妥当性確認を生じる｡ The entry is revalidated when the entry receives or loses focus.

focusin
  入り口が注目を受取ると妥当性確認を生じる｡ The entry is revalidated when the entry receives focus.

focusout
  入り口が注目を失うと妥当性確認を生じる｡ The entry is revalidated when the entry loses focus.

all
  上記の全ての条件で妥当性確認を生じる｡ Validation is performed for all above conditions.

-validatecommand が偽値を返すときは何時でも -invalidcommand が評価される｡ The -invalidcommand is evaluated whenever the -validatecommand returns a false value.

-validatecommand と -invalidcommand は部品の insert か delete 命令を経由したか､連結した -textvariable の設定による値の入り口部品値を修正するかもしれない｡もし､予備的妥当性確認の間､にどちらかが起ると､ -validatecommand によって返される値を考慮することなく編集は拒絶される｡ The -validatecommand and -invalidcommand may modify the entry widget's value via the widget insert or delete commands, or by setting the linked -textvariable. If either does so during prevalidation, then the edit is rejected regardless of the value returned by the -validatecommand.

もし -validatecommand が空(省略時設定)であると､妥当性確認は常に成功する｡ If -validatecommand is empty (the default), validation always succeeds.

#### 妥当性確認 記述譜の置換 VALIDATION SCRIPT SUBSTITUTIONS

-validatecommand と -invalidcommand 上で bind 記述譜のような､百分率置換の実行が可能である｡次の置換が認識される: It is possible to perform percent substitutions on the -validatecommand and -invalidcommand, just as in a bind script. The following substitutions are recognized:

%d
  動作の型: 1 は insert 予備妥当性確認 0 はdelete 予備妥当性確認､ -1 は再妥当性確認｡ Type of action: 1 for insert prevalidation, 0 for delete prevalidation, or -1 for revalidation.

%i
  挿入/削除 される文字列の位置､但し､何もなければ -1｡ Index of character string to be inserted/deleted, if any, otherwise -1.

%P
  予備妥当性確認では､もし､編集が受入れられると､新しい入り口値｡再妥当性確認では､現在の入り口値｡ In prevalidation, the new value of the entry if the edit is accepted. In revalidation, the current value of the entry.

%s
  編集する前の入り口の現在の値｡ The current value of entry prior to editing.

%S
  挿入/削除 される文書文字列､但し､何もなければ {} ｡ The text string being inserted/deleted, if any, {} otherwise.

%v
  現在の -validate 指示項目の現在の値｡ The current value of the -validate option.

%V
  呼戻しが起動された妥当性確認の型(鍵が押された､注目を受取る､注目が離れる､強制された)｡ The validation condition that triggered the callback (key, focusin, focusout, or forced).

%W
  入り口部品の名前｡ The name of the entry widget.

#### DIFFERENCES FROM TK ENTRY WIDGET VALIDATION

もし-validatecommand か -invalidcommand が入り口の値を修正すると､標準 Tk 入り口部品は自動的に妥当性確認を不能にする( -validate を none に設定して)｡ Tk の入り口を目的とした部品は､もし妥当性確認記述譜の一つが不都合を生じた場合か､ -validatecommand が適切な論理値を返さない時にのみ妥当性確認を不能にする｡(そこで､妥当性確認記述譜内の入り口値の修正後に再度妥当性確認を再度可能にする必要がない)｡ The standard Tk entry widget automatically disables validation (by setting -validate to none) if the -validatecommand or -invalidcommand modifies the entry's value. The Tk themed entry widget only disables validation if one of the validation scripts raises an error, or if -validatecommand does not return a valid boolean value. (Thus, it is not necessary to re-enable validation after modifying the entry value in a validation script).

更に標準入力部品は何時であっても連結した -textvariable が修正されたときに､妥当性確認を起動する; Tk 主題の入り口部品は､そうではない｡ In addition, the standard entry widget invokes validation whenever the linked -textvariable is modified; the Tk themed entry widget does not.

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

入り口部品の省略時設定の束縛は次の挙動を可能にする｡下の記述内で “語” は文字か数字か “_” 文字かそれ以外の一文字の塊である｡ The entry widget's default bindings enable the following behavior. In the descriptions below, “word” refers to a contiguous group of letters, digits, or “_” characters, or any single character other than these.

- マウス釦 1 の軽叩は挿入遊走子をマウス遊走子の下になっている文字の丁度前に位置決めし､入力注目を設定し､そして､入力のどの選択も解消する｡マウス釦 1 の引っ張りにより､挿入遊走子とマウス遊走子の下の文字の間の選択は追い出される｡ Clicking mouse button 1 positions the insert cursor just before the character underneath the mouse cursor, sets the input focus to this widget, and clears any selection in the widget. Dragging with mouse button 1 down strokes out a selection between the insert cursor and the character under the mouse.

- マウス釦 1 の二重軽叩は､マウスの下の語を選択し､挿入遊走子を語の末尾に位置取りする｡二重軽叩の後の引張りは語全体から構成される選択を追出すことになる｡ Double-clicking with mouse button 1 selects the word under the mouse and positions the insert cursor at the end of the word. Dragging after a double click strokes out a selection consisting of whole words.

- マウス釦 1 の三重軽叩は､入り口内の全ての文書を選択し､挿入遊走子を行末に位置取りする｡ Triple-clicking with mouse button 1 selects all of the text in the entry and positions the insert cursor at the end of the line.

- 選択の末尾はシフト鍵を押下しながらマウス釦 1 の引張りにより調整することができる; 選択の末尾を修正する､マウス釦 1 が押された時にマウス遊走子に最も近い位置に調節する｡もしマウスが引張られる前に二重軽叩されると､選択は語全体の単位で調整される｡ The ends of the selection can be adjusted by dragging with mouse button 1 while the Shift key is down. If the button is double-clicked before dragging then the selection will be adjusted in units of whole words.

- コントロール鍵を押下しながらマウス釦 1 を軽叩すると､選択に影響を与えずに､挿入遊走子を入り口内に位置取りする｡ Clicking mouse button 1 with the Control key down will position the insert cursor in the entry without affecting the selection.

- もし普通の印刷文字が入り口に打鍵されると､挿入遊走子の位置に挿入される｡ If any normal printing characters are typed in an entry, they are inserted at the point of the insert cursor.

- マウス釦 2 (マウス中央釦)の引張りにより入り口の視野を調整できる｡マウスを動かさずにマウス釦 2 を軽叩すると､選択がマウス遊走子の位置の入り口に複写される｡ The view in the entry can be adjusted by dragging with the middle mouse button (button 2, or button 3 in TkAqua). If the middle mouse button is clicked without moving the mouse, the selection is copied into the entry at the position of the mouse cursor.

- もしマウス釦 1 を押しながらマウスが入り口の右か左の側の外に引張り出されると､入り口は自動的に摺動され､さらなる文書が可視になる(もし更なる画面外の文書がマウスが残された窓側にあるなら)｡ If the mouse is dragged out of the entry on the left or right sides while button 1 is pressed, the entry will automatically scroll to make more text visible (if there is more text off-screen on the side where the mouse left the window).

- 左向き鍵と右向き鍵は挿入遊走子を左か右に一文字動かす; それは入り口内のどの選択も解消し､選択錨を設定する｡もし左向き鍵か右向き鍵がシフト鍵を押下しながら打鍵されると､挿入遊走子が移動し､選択は新しい文字を含むよう拡げられる｡コントロール鍵-左向き鍵とコントロール鍵-右向き鍵は挿入遊走子を語単位に移動する｡コントロール-シフト-左向き鍵とコントロール-シフト-右向き鍵は挿入遊走子を語単位に移動し､選択を拡張する｡コントロール-b 鍵とコントロール-f 鍵はそれぞれ左向き鍵と右向き鍵と同じに振舞う｡メタ-b 鍵とメタ-f 鍵はそれぞれコントロール鍵-左向き鍵とコントロール鍵-右向き鍵と同じに振舞う｡(訳註 メタ鍵はUnix特有の鍵でWinにはない) The Left and Right keys move the insert cursor one character to the left or right; they also clear any selection in the entry. If Left or Right is typed with the Shift key down, then the insertion cursor moves and the selection is extended to include the new character. Control-Left and Control-Right move the insert cursor by words, and Control-Shift-Left and Control-Shift-Right move the insert cursor by words and also extend the selection. Control-b and Control-f behave the same as Left and Right, respectively.

- 我家鍵､又はコントロール-a 鍵は挿入遊走子を入り口の先頭に移動し､入り口のどの選択も解消する｡シフト鍵-我家鍵 は挿入遊走子を入り口の先頭に移動し､選択をその位置まで拡張する｡ The Home key and Control-a move the insert cursor to the beginning of the entry and clear any selection in the entry. Shift-Home moves the insert cursor to the beginning of the entry and extends the selection to that point.

- End 鍵､又はコントロール-e 鍵は挿入遊走子を入り口の末尾に移動し､入り口のどの選択も解消する｡シフト鍵-End鍵 は挿入遊走子を入り口の末尾に移動し､選択をその位置まで拡張する｡ The End key and Control-e move the insert cursor to the end of the entry and clear any selection in the entry. Shift-End moves the cursor to the end and extends the selection to that point.

- コントロール-/ 鍵は入り口内の全文書を選択する｡ Control-/ selects all the text in the entry.

- コントロール-\ 鍵は入り口内の選択を解消する｡ Control-\ clears any selection in the entry.

- 標準 Tk の <<Cut>>, <<Copy>>, <<Paste>>, and <<Clear>> 仮想行事は予想される方法で選択上を操作する｡ The standard Tk <<Cut>>, <<Copy>>, <<Paste>>, and <<Clear>> virtual events operate on the selection in the expected manner.

- 削除鍵は入り口に選択があれば削除する｡もし選択がないと､挿入遊走子の右の文字を削除する｡ The Delete key deletes the selection, if there is one in the entry. If there is no selection, it deletes the character to the right of the insert cursor.

- バックスペース鍵とコントロール-h 鍵は入り口に選択があれば削除する｡もし選択がないと､挿入遊走子の左の文字を削除する｡ The BackSpace key and Control-h delete the selection, if there is one in the entry. If there is no selection, it deletes the character to the left of the insert cursor.

- コントロール-d 鍵は挿入遊走子の右の文字を削除する｡ Control-d deletes the character to the right of the insert cursor.

- コントロール-k 鍵は挿入遊走子の右の文字全てを削除する｡ Control-k deletes all the characters to the right of the insertion cursor.

### WIDGET STATES

disabled の状態内で､入り口は文書を編集できないし､文書は選択されない｡ readonly の状態で､挿入遊走子は表示されないし､入力も編集されない(特に: insert と delete は効果を有さない　)｡ disabled 状態は readonly と同じであり､更に文書は選択できない｡ In the disabled state, the entry cannot be edited and the text cannot be selected. In the readonly state, no insert cursor is displayed and the entry cannot be edited (specifically: the insert and delete commands have no effect). The disabled state is the same as readonly, and in addition text cannot be selected.

註意すべきは連結した -textvariable への変化はたとえ不能や読込み専用でも､依然入り口に反映される｡ Note that changes to the linked -textvariable will still be reflected in the entry, even if it is disabled or readonly.

典型的にはこの文書は disabled 状態内では “対象除外の灰色” であり､ readonly 状態内では､異なる背景が使われる｡ Typically, the text is “grayed-out” in the disabled state, and a different background is used in the readonly state.

入り口部品はもし再妥当性確認が失敗すると invalid 状態を設定する､そして､妥当性確認が成功するといつであっても解除する｡ The entry widget sets the invalid state if revalidation fails, and clears it whenever validation succeeds.

### 様式の指示項目 STYLING OPTIONS

ttk::entry の為の級の名前は TEntry である｡ The class name for a ttk::entry is TEntry.

Dynamic states: disabled, focus, readonly.

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

-background color

  旧版との互換性のためのもの､(macOS用の) aqua 主題を使う時､ -fieldbackground に値が指定されていない場合に限り､この指示項目は -fieldbackground への連結であるかの如く振舞う｡それ以外は無視される｡ For backwards compatibility, when using the aqua theme (for macOS), this option behaves as an alias for the -fieldbackground provided that no value is specified for -fieldbackground. Otherwise it is ignored.

-bordercolor color
-darkcolor color
-fieldbackground color

  画的背景と領域の背景色を使う幾つかの主題では変更できない｡ Some themes use a graphical background and their field background colors cannot be changed.

-foreground color
-insertcolor color
-insertwidth amount
-lightcolor color
-padding padding
-relief relief
-selectbackground color
-selectborderwidth amount
-selectforeground color

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

### SEE ALSO

ttk::widget, entry

### KEYWORDS

entry, widget, text field
Copyright © 1994-1996 Sun Microsystems, Inc.
Copyright © 1998-2000 Scriptics Corporation.
Copyright © 2004 Joe English