NAME
  MessageDlg - 伝言文対話箱 Message dialog box

生成 CREATION
  MessageDlg pathName ?option value...?

標準の指示項目 STANDARD OPTIONS

  -anchor | -font
  -foreground or -fg | -padx
  -pady

対話箱由来の指示項目 OPTIONS from Dialog

  -background or -bg | -cancel
  -default | -parent

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

  -aspect | -buttons
  -buttonwidth | -icon
  -justify | -message
  -title | -type
  -width

説明 DESCRIPTION

伝言文対話箱は伝言文の対話箱を簡単に表示する方法を提供する｡MessageDlg::create は伝言文の対話箱を生成し､表示し､押された釦の番号を返すか､破壊された時は -1 を返す｡帰る時に最早対話箱は実在しない｡ MessageDlg provides a simple way to display a message dialog. MessageDlg::create creates the message dialog, displays it and return the index of the pressed button, or -1 if it is destroyed. When returning, the dialog no longer exists.

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

-aspect
  非負の整数値の指定は文書についての望ましい縦横比を示す｡縦横比は 100×巾/丈 として指定される｡100は文書が高さと同じ巾になることを意味し､200は文書が丈の二倍の巾であることを意味し､50は文書は巾の二倍の丈であることを意味し､以下同様である｡巾 指示項目が指定されていない場合文書の行長さを選択する為に使われる｡既定は150である｡ 指示項目 -width と -aspect は Tk 伝言文 部品からの直接に相続している｡ Specifies a non-negative integer value indicating desired aspect ratio for the text. The aspect ratio is specified as 100*width/height. 100 means the text should be as wide as it is tall, 200 means the text should be twice as wide as it is tall, 50 means the text should be twice as tall as it is wide, and so on. Used to choose line length for text if width option isn't specified. Defaults to 150. The options -width and -aspect are directly heritated from the Tk message widget.

-buttons
  type 指示項目が 使用者 の場合に展示すべき釦のリストを指定する｡もし釦が象徴的名称を有している場合それは展示される文書に結合されている｡ Specifies a list of buttons to display when type option is user. If a button has a symbolic name, its associated text will be displayed.

-buttonwidth
  対話箱内の釦の標準的巾を指定する｡ Specifies the standard width of the buttons in the dialog.

-icon
  展示すべきアイコンを指定する｡次の内の一つでなければならない､不都合､情報､質問､警告｡ Specifies an icon to display. Must be one of the following: error, info, question or warning.

-justify
  文書を如何に整列するかを指定する｡左か中央か､右かの内の一つでなければならない｡既定は左｡この指示項目は窓の内部の文書の多様な整列法を提供する為に､､錨､縦横比､横の充填物､縦の充填物､巾 の指示項目と共に働く｡縦横比と､巾､の指示項目は文書を展示する為に必要な画像空間の量を定める｡錨､横の充填物､縦の充填物 の指示項目は､部品の窓の内部の何処にこの矩形の領域が展示されるかを決定し､整列指示項目は､その矩形の領域内部に各行が如何に展示されるかを指定する｡譬えば､錨が右で整列が左､且つ伝言窓が文書に必要な量より十分多いことを仮定する｡全ての行の左端は並び揃い､且つ最長行の右端は窓の右側から水平充填される様に文書は展示される; 全体の文書の区域は窓の垂直の拡がりの中央になる｡(譯註:the the->the) Specifies how to justify lines of text. Must be one of left, center, or right. Defaults to left. This option works together with the anchor, aspect, padx, pady, and width options to provide a variety of arrangements of the text within the window. The aspect and width options determine the amount of screen space needed to display the text. The anchor, padx, and pady options determine where this rectangular area is displayed within the widget's window, and the justify option determines how each line is displayed within that rectangular region. For example, suppose anchor is e and justify is left, and that the message window is much larger than needed for the text. The the text will displayed so that the left edges of all the lines line up and the right edge of the longest line is padx from the right side of the window; the entire text block will be centered in the vertical span of the window.

-message
  この伝言箱に展示すべき伝言を指定する｡ Specifies the message to display in this message box.

-title
  伝言箱の表題として表示すべき文字列を指定する｡もし値が空の場合(既定)､アイコン指示項目に対応して既定の表題が設定される｡既定の結合した表題は英語であり､原資の指定により他の言語に修正可能である: Specifies a string to display as the title of the message box. If the value is empty (the default), a default title will be set corresponding to the icon option. The default associated title is in english, and can be modified to set it in another language by specifying the resource:

          *MessageDlg.nameTitle:   value

  若しくは等価な tcl 命令は: or the equivalent tcl command:

          option add *MessageDlg.nameTitle value

  ここで name はicon 指示項目内で定義されたアイコンの名前である｡ 譬えば､仏語について警告対話箱を指定できる: where name is the name of an icon as defined in the icon option.
  For example, for french language, you can specify for a warning dialog:

          option add *MessageDlg.warningTitle  "Attention"

-type
  展示さるべき釦の組を指定する｡次の値が可能である: Specifies a set of buttons to be displayed. The following values are possible:

  abortretryignore
    象徴名が､中断､再試行､無視､の三つの釦を展示する｡ Displays three buttons whose symbolic names are abort, retry and ignore.

  ok
    象徴名が､良､の一つの釦を展示する｡ Displays one button whose symbolic name is ok.

  okcancel
    象徴名が､良､解消､の二つの釦を展示する｡ Displays two buttons whose symbolic names are ok and cancel.

  retrycancel
    象徴名が､再試行､解消､の二つの釦を展示する｡ Displays two buttons whose symbolic names are retry and cancel.

  yesno
    象徴名が､是､否､の二つの釦を展示する｡ Displays two buttons whose symbolic names are yes and no.

  yesnocancel
    象徴名が､是､否､解消､の三つの釦を展示する｡ Displays three buttons whose symbolic names are yes, no and cancel.

  user
    釦指示項目の釦を展示する｡ Displays buttons of -buttons option.

  使用者指示項目以外のどの-typeも､生の Tk 部品 tk_messageBox が使われる｡この場合､次の指示項目だけが考慮される: -default, -icon, -message, -title -type ｡ For any -type but user, the native Tk widget tk_messageBox is used. In this case, only the following options are considered: -default, -icon, -message, -title and -type.

  -width
    窓内の行の長さを指定する｡もしこの指示項目が零より大きい値を有すると縦横比指示項目は無視され巾指示項目が行の長さを決定する｡ もしこの指示項目が零かそれより小さい値を有すると､縦横比指示項目が行の長さを決定する｡ Specifies the length of lines in the window. If this option has a value greater than zero then the aspect option is ignored and the width option determines the line length. If this option has a value less than or equal to zero, then the aspect option determines the line length.