名称 NAME
  Entry - state指示項目､動的説明文､引き摺り落し便益を持つ入力部品 Entry widget with state option, dynamic help and drag and drop facilities

創生 CREATION
  Entry pathName ?option value...?

標準の指示項目 STANDARD OPTIONS
Not themed

  -background or -bg | -borderwidth or -bd
  -disabledbackground | -disabledforeground
  -exportselection | -font
  -foreground or -fg | -highlightbackground
  -highlightcolor | -highlightthickness
  -insertbackground | -insertborderwidth
  -insertofftime | -insertontime
  -insertwidth | -justify
  -relief | -selectbackground
  -selectborderwidth | -selectforeground
  -takefocus | -text
  -textvariable | -xscrollcommand

Themed

  -exportselection | -font
  -insertofftime | -insertontime
  -insertwidth | -justify
  -takefocus | -text
  -textvariable | -xscrollcommand

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

  -command | -dragenabled
  -dragendcmd | -dragevent
  -draginitcmd | -dragtype
  -dropcmd | -dropenabled
  -dropovercmd | -droptypes
  -editable | -helptext
  -helptype | -helpvar
  -show | -state
  -width

部品命令 WIDGET COMMAND
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName invoke

説明 DESCRIPTION

既定の Tk 入力部品を拡張した入力部品｡入力部品とDynamicHelp の指示項目とDrag と Dropの状態に従った視覚効果を提供する為に指示項目が追加されている｡入力部品はその内容を設定する為の文書指示項目を伴う札部品の如く振舞う｡入力部品上でTk 入力部品も同じく使用できる｡ The Entry widget extends the default Tk entry. Options have been added to provide visual effect depending on the state of the Entry, DynamicHelp options, and Drag and Drop. Entry behaves much like a Label, with text option to set its contents.
Tk entry command can also be used on Entry widget.

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

-command
  使用者が入力部品内で <Return> を押した時に命令が指定される｡ Specifies a command when user press <Return> in the Entry.

-dragenabled
  引き摺りが可能かを指定する論理値｡ A boolean specifying if drag is enabled.

-dragendcmd
  引き摺りが終わる時に呼出される命令を指定する｡dragendcmd は DragSite::register の指示項目dragendcmd の記述に適合しなければならない｡ もしdragendcmd が空であると､内部の dragend 命令は操作(move か copy)と引き摺りデータ()に従って入力を更新する(入力の全体又は選択された部分)｡ Specifies a command to be called when drag ended. dragendcmd must be a command conforming to the description of the option dragendcmd of DragSite::register.
  If dragendcmd is empty, the internal dragend command updates the entry following the operation (move or copy) and the dragged data (whole or selected part of the entry).

-dragevent
  引摺りに結合されたマウス釦の番号を指定する｡1 か 2 か 3 でなければならない｡ Specifies the number of the mouse button associated to the drag. Must be 1, 2 or 3.

-draginitcmd
  部品上で dragevent が生じる時､呼出される命令を指定する｡draginitcmd は DragSite::register の指示項目 draginitcmd の記述に適合する命令でなければならない｡ draginitcmd が空の場合､入力が空か文書の一部が選択され且つ行事は上記選択上で生じてない時は命令は引き摺りを拒否する｡それ以外の場合命令は次を返す: Specifies a command to be called when dragevent occurs on widget. draginitcmd must be a command conforming to the description of the option draginitcmd of DragSite::register.
  if draginitcmd is empty, the command refuse the drag if entry is empty or if portion of text is selected and event doesn't occur above the selection. In all other cases, the command returns:
  - データ型として､dragtype 指示項目の値か､それが空なら TEXT ､ as the data type, the value of option dragtype or TEXT if empty,
  - 操作として､state が通常で且つeditableが真値の場合は{copy move} ､他の場合は {copy} のみ､ as the operations, {copy move} if state is normal and editable is true, or {copy} only in other cases,
  - データとして､内容全体か入力の選択された部分｡ as the data, the whole content or the selected portion of the entry.

-dragtype
  引き摺られた対象の代りの型を指定する｡ Specifies an alternate type of dragged object.

-dropcmd
  入力箱は落下行事の命令梱包を有する｡この命令は自動摺動及び､品目と位置の抽出を停止する｡ もし､dropcmd が空でない場合､次の引数と共に呼出される: Entry has a command wrapper for drop events. This command stops auto scrolling and extract current position.
  If dropcmd is not empty, it is called with the following arguments:
  - 入力箱の経路名､ the pathname of the Entry,
  - 引き摺り原資の経路名､ the pathname of the drag source,
  - 遊走子によって明示された入力箱内の数値番号｡ the numeric index in the entry designated by the cursor,
  - 現在の操作､ the current operation,
  - データの型､ the data type,
  - データ｡ the data.
  更に､DropSite::register 内に記述されたdropcmd指示項目に適合する値を返さねばならない｡もしdropcmd が空であると､梱包は次のデータの型に従った入力箱を更新する: and must return a value conforming to dropcmd option described in DropSite::register. If dropcmd is empty, the wrapper updates the entry following the type of data:

    COLOR or FGCOLOR | 入力箱の前景を再構成設定する｡ reconfigure the foreground of the Entry
    BGCOLOR | 入力箱の背景を再構成設定する｡ reconfigure the background of the Entry
    TEXT, or any other tag | 結合した文字列を展示する為に入力箱を再構成設定する｡ reconfigure the Entry to display the associated string.

  及び1を返す｡ and returns 1.

-dropenabled
  落下が可能なら論理値を指定する｡ A boolean specifying if drop is enabled.

-dropovercmd
  入力箱は drag-over 行事に関する命令梱包を有する｡この命令は､自動摺動と､ drag-over の間の位置の抽出を可能にする｡ dropovercmd が空なら､梱包はeditable指示項目が真値且つstate指示項目が通常の場合落下を受容れる｡ もし､dropovercmd が空でない場合､次の引数と共に呼出される: Entry has a command wrapper for drag-over events. This command enables auto scrolling and position extraction during the drag-over.
  If dropovercmd is empty, the wrapper accepts the drop if editable option is true and state option is normal.
  If dropovercmd is not empty, it is called with the following arguments:
  - 入力箱の経路名､ the pathname of the Entry,
  - 引き摺り原資の経路名､ the pathname of the drag source,
  - 行事､ the event,
  - 遊走子によって明示された入力箱内の数値番号｡ the numeric index in the entry designated by the cursor,
  - 現在の操作､ the current operation,
  - データの型､ the data type,
  - データ｡ the data.
  且つ､DropSite::register 内に記述されたdropovercmd指示項目に適合する値を返さねばならない｡ and must return a value conforming to dropovercmd option described in DropSite::register.

-droptypes
  受容れられ落下される 対象/操作 のリストを指定する｡更なる情報はDropSite::register を参照されたい｡ 既定で FGCOLORと COLORとBGCOLOR と TEXT の全てをcopy と move 操作と共に受容れる｡ Specifies a list of accepted dropped object/operation. See option droptypes of DropSite::register. for more infromation. Default accepts FGCOLOR, COLOR, BGCOLOR and TEXT, all with copy and move operations.

-editable
  入力箱が使用者に校正可能か否かを指定する｡ Tk 入力箱部品のstate 指示項目と等価である｡ Specifies whether the Entry is editable by the user. Equivalent to the state option of the Tk entry widget.

-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 指示項目が変数の時に使う変数｡DynamicHelp参照｡ Variable to use when helptype option is variable. See also DynamicHelp.

-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 ``*''. 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.

-state
  入力部品に関する二つの状態の内の一つを指定する: 通常 か 不能 ｡通常 状態では入力部品の文書は 前景 指示項目を使って展示される｡不能状態では入力部品の文書は 不能前景 指示項目を使って展示される｡ もし入力部品が不能であると､縦え入力の注目が部品に有っても､使用者入力によっては値は変更されず､挿入遊走子も展示されない｡不能状態は可視の効果を伴った校正不能と同じである｡ Specifies one of two states for the Entry: normal or disabled. In normal state the text of the Entry is displayed using the foreground option. In disabled state the text of the Entry is displayed using the disabledforeground option. If the entry is disabled then the value may not be changed by user input and no insertion cursor will be displayed, even if the input focus is in the widget. Disabled state is the same as not editable with visual effect.

-width
  入口窓の望ましい巾を表す整数値を部品の字母の平均寸法の文字を単位として指定する｡もし値が零かそれより小さいと部品はその現在の文書を保有するに丁度足りる寸法を拾い上げる｡ Specifies an integer value indicating the desired width of the entry window, in average-size characters of the widget's font. If the value is less than or equal to zero, the widget picks a size just large enough to hold its current text.

部品命令 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 が value無しに指定されると､本命令は 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
  指示項目-command によって指定される命令を呼出す｡ Calls the command specified by the option -command.