NAME
  Dialog - 誂え釦による対話の本質 Dialog abstraction with custom buttons

CREATION
  Dialog pathName ?option value...?

OPTIONS from ButtonBox

  -background or -bg | -homogeneous
  -padx | -pady
  -spacing

WIDGET-SPECIFIC OPTIONS

  -anchor
  | -bitmap -cancel
  -default
  | -geometry -image
  | -modal -parent
  | -place -separator
  | -side -title
  | -transient

部品命令 WIDGET COMMAND
  pathName add ?arg...?
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName draw ?focus?
  pathName enddialog result
  pathName getframe
  pathName invoke index
  pathName itemcget index option
  pathName itemconfigure index ?option? ?value option value ...?
  pathName setfocus index
  pathName withdraw

DESCRIPTION

対話箱部品は使用者に対話箱の生成を可能にする｡幾つかの命令は､そこで釦が稼働する事を指し示す引数として index を採る｡この位置参照は釦箱命令と同等として指定される｡ Dialog widget enables the user to create a dialog box. Some commands take an index as argument indicating on which Button it work. This index is the same specified for equivalent ButtonBox command:

number
  釦を数値で指定する､茲で0は最初に追加された釦であり､1はその次であり､更に続く｡ Specifies the Button numerically, where 0 corresponds to the first added Button, 1 to the next, and so on.
end or last
  追加された最後の品目を指し示す｡ Indicates the last item added.
default
  既定の釦を指し示す｡ Indicates the default Button.

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

-anchor (read-only)
  釦箱の錨位置を指定する｡w か e か n か s か c の内の一つでなければならない｡もし､side 指示項目が top か bottom に設定されていると､錨の値のnとs と c は同じ効果を有する｡もし､side 指示項目が left か right に設定されていると､錨の値のwとe と c は同じ効果を有する｡ Specifies the anchor point of the ButtonBox. Must be one of w, e, n, s or c. If side option is set to top or bottom, anchor values n, s and c have the same effect. If side option is set to left or right, anchor values w, e and c have the same effect.

-bitmap (read-only)
  使用者枠の左に点地図の展示を指定する｡image 指示項目はbitmapを上書きする｡ Specifies a bitmap to display at the left of the user frame. image option override bitmap.

-cancel
  対話箱の解消釦の数を指定する｡使用者がEsc か窓が閉じる釦を押すと､この釦が起動される｡もし-1に設定されるとEsc は何も起動しない｡窓を閉じる釦はこの場合対話箱を壊し-1を返す｡ Specifies the number of the cancel button of the Dialog. When user presses Esc or the windows close button, this button is invoked.
  If set to -1, Esc does not invoke anything. The window close button destroys the dialog in this case and returns -1.

-default
  対話箱の既定の釦の番号を指定する｡使用者が対話箱内でReturnを押す時この釦が起動される｡ Specifies the number of the default button of the Dialog. When user press Return in the Dialog, this button is invoked.

-geometry
  手段 draw が呼ばれる時に使われる幾何を設定する｡假引数記述についてはwm geometry を参照されたい｡ Set the geometry used when method draw is called. See wm geometry for a parameter description.

-image (read-only)
  使用者枠の左に展示される影像を指定する｡image 指示項目はbitmapを上書きする｡ Specifies an image to display at the left of the user frame. image option override bitmap.

-modal
  この指示項目はnone か local か global の内の一つでなければならない｡この指示項目の値は対話箱の把持様式とDialog::drawが如何に働くかを定める｡ This option must be none, local or global. The value of this option specifies the grab mode of the dialog and how works Dialog::draw.

-parent
  対話箱の親｡対話箱はその親のどちらかに置かれる｡もし空文字列であると､根本窓の側に置かれる｡place 指示項目を参照されたい｡ Parent of the Dialog. Dialog is placed relative to its parent. If empty, it is placed relative to the root window. Also see place option.

-place
  対話箱の親のどちらに対話箱の頂上水準を描くかを指定する｡none か center か left か right か above か below の内の一つでなければならない｡place の既定値はcenter である｡ Specifies where to draw the Dialog toplevel relative to the dialog's parent. Must be one of none, center, left, right, above, below. Default value of place is center.

-separator (read-only)
  使用者枠と釦箱の間に分離線を描くか否かを指定する｡ Specifies wether or not to draw a separator between the user frame and the ButtonBox.

-side (read-only)
  釦箱を使用者枠のどちらに描くかを指定する｡top か left か bottom か right の内の一つでなければならない｡ Specifies where to draw the ButtonBox relative to the user frame. Must be one of top, left, bottom or right.

-title
  対話箱の頂上水準の表題｡　　　　　　　　　　　　　　　　　　　　　　　　　　　 Title of the Dialog toplevel.

-transient (read-only)
  対話箱の頂上水準が一時的窓か否かを指定する｡transient の既定値は真値である｡ Specifies if the Dialog Toplevel should be a transient window or not. Default value of transient is true.

部品命令 WIDGET COMMAND

pathName add ?arg...?
  対話箱の釦箱に釦を追加する｡既定の -command 指示項目はDialog::enddialog $path index であり､ここで index は追加された釦の番号である｡ Add a button to the button box of the dialog box. Default -command option is Dialog::enddialog $path index where index is number of button added.

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 draw ?focus?
  この命令は対話箱を描き､且つ modal 指示項目に従って把持を設定する｡もしmodal 指示項目が none に設定されていると､命令は直ぐに空文字列を返す｡他の全ての場合､本命令はDialog::enddialogが呼ばれるか対話箱が破壊された時に帰る｡返す値は Dialog::enddialog の引数の結果であるが､破壊されると-1を返す｡ This command draw the Dialog, and set grab to it following modal option. If modal option is set to none, the command returns immediatly an empty string. In all other case, the command returns when Dialog::enddialog is called or when Dialog is destroyed. The return value is the result argument of Dialog::enddialog or -1 if it is destroyed.

  既定では､注目はdefault指示項目によって参照される既定釦に設定されるが､既定釦が設定されていない時は対話箱の頂上水準に設定される｡もし focus があると､それは経路名か､釦の参照番号かでなければならない｡初期の注目は経路名か対応する釦に設定される｡ By default, the focus is set to the default button referenced by default option, or to the toplevel of Dialog if no default button has been set. If focus is present, it must be a pathname, or an index to a button. Initial focus is set on this pathname or corresponding button.

pathName enddialog result
  この命令は典型的には Dialog::drawreturn 釦を作成する命令の中で呼ばれる｡ This command is typically called within a command of a button to make Dialog::draw return.

pathName getframe
  使用者窓の経路名を返す｡ Returns the pathname of the user window.

pathName invoke index
  index によって与えられる釦を起動する｡ Invoke the Button given by index.

pathName itemcget index option
  品目に関する構成設定指示項目の値を返す｡option はその品目生成命令によって受容れられるどのような値も採り得る｡ Returns the current value of a configuration option for the item. Option may have any of the values accepted by the item creation command.

pathName itemconfigure index ?option? ?value option value ...?
  本命令は configure 命令に似ている､configure は部品全体に適用するが､これは個別の品目に関する指示項目に適用することが異なる｡option は品目生成命令によって受容れられるどの様な値も採り得る｡もし指示項目が指定されると､指示項目は命令内の表示に従って修正され､且つ本命令は空文字列を返す｡もし指示項目が指定されないと､品目に関する現在の指示項目を記述するリストを返す｡読出し専用指示項目は修正されない｡ This command is similar to the configure command, except that it applies to the options for an individual item, whereas configure applies to the options for the widget as a whole. Options may have any of the values accepted by the item creation widget command. If options are specified, options are modified as indicated in the command and the command returns an empty string. If no options are specified, returns a list describing the current options for the item. Read-only options are not be modified.

pathName setfocus index
  index によって与えられる釦に注目を設定する｡ Set the focus to the Button given by index.

pathName withdraw
  対話箱を隠蔽する為にこの命令を呼ばれたい｡ Call this command to hide the dialog box.