NAME
  MainFrame - 目録､道具箱､状態帯を伴う頂上水準を管理する Manage toplevel with menu, toolbar and statusbar

CREATION
  MainFrame pathName ?option value...?

OPTIONS from ProgressBar

  -background or -bg | -progressfg (see -foreground)
  -progressmax (see -maximum) | -progresstype (see -type)
  -progressvar (see -variable)

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

  -height
  -menu
  -separator
  -textvariable
  -width
  | -sizegrip

部品命令 WIDGET COMMAND
  pathName addindicator ?arg...?
  pathName addtoolbar
  pathName cget option
  pathName configure ?option? ?value option value ...?
  pathName getframe
  pathName getindicator index
  pathName getmenu menuid
  pathName gettoolbar index
  pathName setmenustate tag state
  pathName showstatusbar name
  pathName showtoolbar index bool

説明 DESCRIPTION

主枠は頂上水準に以下のことを為す様に管理する: MainFrame manage toplevel to have:

- 自動促進器の束縛と動的説明文DynamicHelp の結合を伴った単純目録の生成｡ simple menu creation, with automatic accelerator bindings and DynamicHelp association,
- 使用者が隠蔽可能な､一つ或は複数の道具帯､ one or more toolbars that user can hide,
- 使用者伝言文を表示したり目録を記述する状態帯と､追加的な進捗表示帯ProgressBar｡ a status bar, displaying a user message or a menu description, and optionally a ProgressBar.

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

-height
  使用者枠に関して望ましい丈を､Tk_GetPixels に受容れられるどの様な形式かで指定する｡この指示項目が零と等しいかより小さい場合(既定)､窓は如何なる寸法も要求しなくなる｡ Specifies the desired height for the user frame in any of the forms acceptable to Tk_GetPixels. If this option is less than or equal to zero (the default) then the window will not request any size at all.

-menu (read-only)
  この指示項目は目録を記述する｡これはそのそれぞれの五つの要素が一つの分離目録を記述するリストである｡それは､次の形式を有する: {menuname tags menuId tearoff menuentries...} ここで､menuentries はリストであってそれぞれの要素が一つの目録見出しを記述する､それは次の通り： This option describes the menu. This is a list whose each five elements describe one cascade menu. It has the following form: {menuname tags menuId tearoff menuentries...} where menuentries is a list where each element describe one menu entry, which can be:
  - 区切り線については for a separator:
    {separator}
  - 命令については for a command:
    {command menuname ?tags? ?description? ?accelerator? ?option value? ...}
  - 確認釦については for a check button:
    {checkbutton menuname ?tags? ?description? ?accelerator? ?option value? ...}
  - ラジオ釦については for a radio button:
    {radiobutton menuname ?tags? ?description? ?accelerator ?option value? ...}
  - 分離目録については for a cascade menu:
    {cascade menuname tags menuId tearoff menuentries}
  ここで: where:
  - menuname は目録の名前である｡それが & を含む場合､続く文字は menu add 命令の対応する -underline 指示項目に自動的に変換される｡ menuname is the name of the menu. If it contains a &, the following character is automatically converted to the corresponding -underline option of menu add command.
  - tags は入力の貼札リストであり､MainFrame::setmenustate による目録入力の､利用可能可と不能化に使われる｡ tags is the tags list for the entry, used for enabling or disabling menu entries with MainFrame::setmenustate.
  - menuId は目録に関する識別番号であり､使用者は MainFrame::getmenu を使ってそこから目録の経路名を得ることができる｡ menuId is an id for the menu, from which you can get menu pathname with MainFrame::getmenu.
  - tearoff は目録が剥ぎ取り入力を有するか否かの示す｡ tearoff specifies if menu has tearoff entry.
  - description は DynamicHelp に関する文字列を指定する｡ description specifies a string for DynamicHelp.
  - 促進器は鍵の並びである｡それは二つの要素のリストであり､茲で最初の要素は､Shift か Ctrl か Alt か CtrlAlt か Cmd か ShiftCmd の内の一つであり､第二の要素は文字列 (解釈実行機能の-casesensitive 指示項目を参照されたい)か､数字か､特別の鍵である｡促進器は文字列は機械語翻訳され対応する束縛は目録入力を起動する為の頂上水準に設定される｡ accelerator specifies a key sequence. It is a list of two elements, where the first is one of Shift, Ctrl, Alt, CtrlAlt, Cmd, or ShiftCmd, and the second as letter (see -casesensitive option for interpretation), digit or a special key name. An accelerator string is build and corresponding binding set on the toplevel to invoke the menu entry.
  - option value は入力について追加の指示項目を指定する(menu add 命令を参照されたい)｡ option value specifies additionnal options for the entry (see menu add command).
  ? によって括られたそれぞれの値は､任意追加であり既定で空文字列であるが､一つあるいはそれ以上の空でない指示項目が引続く場合は提供せねばならない｡ Each value enclosed by ? are optional and defaulted to empty string, but must be provided if one or more following options is not empty.
  用例: Example:

      set descmenu {
          "&File" {} {} 0 {
              {command "&New"     {} "Create a new document"     {Ctrl n} -command Menu::new}
              {command "&Open..." {} "Open an existing document" {Ctrl o} -command Menu::open}
              {command "&Save"    open "Save the document" {Ctrl s} -command Menu::save}
              {cascade  "&Export"  {} export 0 {
                  {command "Format &1" open "Export document to format 1" {} -command {Menu::export 1}}
                  {command "Format &2" open "Export document to format 2" {} -command {Menu::export 2}}
              }}
              {separator}
              {cascade "&Recent files" {} recent 0 {}}
              {separator}
              {command "E&xit" {} "Exit the application" {} -command Menu::exit}
          }
          "&Options" {} {} 0 {
              {checkbutton "Toolbar" {} "Show/hide toolbar" {}
                  -variable Menu::_drawtoolbar
                  -command  {$Menu::_mainframe showtoolbar toolbar $Menu::_drawtoolbar}
              }
          }
      }

-separator (read-only)
  使用者窓の 頂上/底 に区切り線が描かれるべきか否かを指定する｡none か top か bottom か both かでなければならない｡使用者窓の小窓の立体感に依存する｡ Specifies if separator should be drawn at the top and/or at the bottom of the user window. Must be one of the values none, top, bottom or both. It depends on the relief of subwidgets of user window.

-textvariable
  状態帯の札に関する文書変数指示項目を指定する｡目録入力のDynamicHelp 記述は主窓の生成時にこの変数に対応付けされる｡もしこの変数が MainFrame::configure によって変更されると目録の記述は利用できなくなる｡使用者は札の文書を変数の値を修正で行う｡ Specifies the textvariable option for the label of the status bar. DynamicHelp description of menu entries are mapped to this variable at the creation of the MainFrame. If this variable is changed by MainFrame::configure, menu description will not be available.
  You change the text of the label by modifying the value of the variable.

-width
  使用者枠について望ましい巾を指定する､単位はTk_GetPixels に受容れられる如何なる形式でも可｡もし指示項目が零(既定)かそれより小さいと､窓はどの様な寸法も全く要求しなくなる｡ Specifies the desired width for the user frame in any of the forms acceptable to Tk_GetPixels. If this option is less than or equal to zero (the default) then the window will not request any size at all.

-sizegrip (themed, read-only)
  もし論理値引数が真値で､且つ､主題様式であると､右下隅に ttk の 把持取っ手 を表示する｡ If bool argument is true and themed mode, show a ttk sizegrip widget in the lower-right corner.

部品命令 WIDGET COMMAND

pathName addindicator ?arg...?
  状態帯の右に表示器を追加する｡それぞれの表示器は左から右に追加される｡表示器は ?arg...? によって与えられる 指示項目-値 対で構成設定された Tk 札部品である｡-relief と -borderwidth 指示項目はそれぞれ既定で 窪み と 1 にされる｡生成された札の経路名を返す｡ Add an indicator box at the right of the status bar. Each indicator are added from left to right. An indicator is a Tk label widget configured with option-value pair given by ?arg...?. -relief and -borderwidth options are respetively defaulted to sunken and 1. Returns the pathname of the created label.

pathName addtoolbar
  道具帯を主枠に追加する｡道具箱帯を置くべき新しい窓の経路名を返す｡ Add a toolbar to the MainFrame. Returns the pathname of the new window where to place toolbar items.

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 getframe
  使用者窓の経路名を返す｡ Returns the pathname of the user window.

pathName getindicator index
  第index番が追加された表示器の経路名を返す｡ Returns the pathname of the indexth added indicator.

pathName getmenu menuid
  識別番号が menuid の目録の経路名を返す｡ Returns the pathname of the menu whose id is menuid.

pathName getmenustate tag state
  与えられた目録 tag の状態を返す｡ Returns the state of the given menu tag.

pathName gettoolbar index
  第index番が追加された道具帯の経路名を返す｡ Returns the pathname of the indexth added toolbar.

pathName setmenustate tag state
  stateへの貼札 tag を有する目録の見出しの全ての-state 指示項目の値を設定する｡それに結合した貼札の一つが状態disabled を有する場合は目録の見出しは不可である｡ Set the -state option value of all the menu entries that have the tag tag to state. A menu entry is disabled, if one of its associated tags have state disabled.

pathName showstatusbar name
  name は none か status か progression の内の一つでなければならない｡状態帯の隠蔽は none を使い､札のみの表示には status を使い､札とProgressBarの表示には progression を使う｡ name is one of none, status or progression. Use none to hide the status bar, status to display the label only, or progression to display the label and the ProgressBar.

pathName showtoolbar index bool
  bool が1なら第index番を追加された道具帯を表示し､ bool が0 なら隠す｡ 隠蔽/表示 の間の使用者の道具帯の寸法変更を防ぐには管理されている間に [wm geometry $top [wm geometry $top]] を実行されたい｡ Hide if bool is 0, or show if bool is 1 the indexth added toolbar. To prevent your toplevel from resizing while hiding/showing toolbar, do [wm geometry $top [wm geometry $top]] when it is managed.