バージョン 6.3.3
 —  ダイアログコンポーネントリファレンス  —

標準ウィンドウ

このドキュメントでは、次のトピックについて説明します。


説明

標準ウィンドウは最も一般的なダイアログタイプです。 最上位のダイアログであり、どのような子ダイアログも含むことができません。 このことから、これを SDI(シングルドキュメントインターフェイス)ウィンドウと呼んで、MDI(マルチドキュメントインターフェイス)フレームウィンドウと区別することがあります。MDI フレームウィンドウでは、複数の MDI 子ウィンドウを同時に開き、それぞれに別個の "ドキュメント" を表示することができます。

注意:
"ドキュメント" という用語は、関連データのセットを指して使用され、ファイルシステム内に個別に存在しているファイルのこととは限りません。

標準ウィンドウには、モードレス、モーダル、またはダイアログボックスの 3 つの形式があります。 これらはタイプの違いではなく、STYLE 属性の値として実装されています。 このうちダイアログボックスは他の 2 つの形式とは異なり、ダイアログボックスが処理されて閉じられた後のみ、OPEN DIALOG ステートメントから制御が戻ります。 このため、ダイアログボックスの実行は "同期" であると言います。 一方、モードレスダイアログとモーダルダイアログは、OPEN イベントや AFTER-OPEN イベントが処理された直後に、呼び出し元に制御を返しますが、ダイアログは開いたままであり、閉じられるまでイベントを受け取ることができます。 このような実行は "非同期" と言われます。これは、ダイアログが閉じられる前に OPEN DIALOG ステートメントに続くコードが実行されるためです。 モードレスダイアログとモーダルダイアログの違いは、モーダルダイアログがアクティブになると他のすべてのダイアログは暗黙的に無効にされ、ユーザーからは一時的にアクセス不可能になりますが、モードレスダイアログでは、ユーザーは別のダイアログに切り替えて操作することができます。 ダイアログボックス形式のダイアログも暗黙的にモーダルです。 3 つの形式のダイアログのうち、モーダルダイアログが使用されるケースは最もまれです。 大部分のダイアログは、カテゴリとしては "モードレスと非同期"(モードレス)または "モーダルと同期"(ダイアログボックス)に分類されます。

標準ウィンドウの PARENT(存在する場合)は "オーナー" ウィンドウを指しており、特殊な包含関係は意味していません。 これは、2 つのダイアログが同じグループに "属している" ことを Windows に通知するものです。 Windows はこの情報をもとに、例えば、所有されている方のウィンドウがウィンドウの深さ("Z オーダー")シーケンス内でオーナーウィンドウとともに(オーナーウィンドウより前面に)まとめて保持されること、およびオーナーウィンドウが最小化されたときに所有されている方のウィンドウも自動的に非表示になることを保証します。

Top of page

標準ウィンドウの属性

属性名 照会 設定/変更 属性 ウィンドウ
AUTO-ADJUST X -/X X
BACKGROUND-COLOUR-NAME X X/X X
BACKGROUND-COLOUR-VALUE X X/X X
BITMAP-FILE-NAME X X/X X
CLIENT-DATA X X/-  
CLIENT-HANDLE X X/X  
CLIENT-KEY X X/X  
COMPATIBILITY X X/- X
CONTEXT-MENU X X/X X
CLIENT-VALUE X X/X  
DEFAULT-BUTTON X X/X X
DOCKING X X/X X
DPI X X/-  
DROP-MODE X X/X X
ENABLED X X/X X
EVENT-QUEUEING X X/X X
FIRST-CHILD X -/-  
FOLLOWS X -/-  
FONT-HANDLE X -/-  
FONT-STRING X X/- X
HAS-DIL X X/X X
HAS-HELP-BUTTON X X/- X
HAS-MENU-BAR X X/-  
HAS-STATUS-BAR X X/X X
HAS-SYSTEM-BUTTON X X/- X
HAS-TOOLBAR X X/X X
HAS-TOOLTIP X X/X  
HELP-FILENAME X X/X X
HELP-ID X X/X X
HORIZ-SCROLLABLE X X/X X
LAST-CHILD X -/-  
MAXIMIZABLE X X/- X
MAXIMIZED X X/X X
MENU-HANDLE X X/X  
MINIMIZABLE X X/- X
MINIMIZED X X/X X
MODIFIED X X/X  
MODIFIED-SUCCESSOR X -/-  
NAME X -/-  
PARENT X X/-  
POPUP-HELP X X/X X
PREDECESSOR X -/-  
RECTANGLE-H X X/X X
RECTANGLE-W X X/X X
RECTANGLE-X X X/X X
RECTANGLE-Y X X/X X
RTL X -/- X
SCROLLRANGE-X X X/X  
SCROLLRANGE-Y X X/X  
SIZE-MODIFIABLE X -/- X
STATUS-HANDLE X X/X  
STATUS-TEXT   -/X  
STRING X X/X X
STYLE X X/- X
SUCCESSOR X -/-  
SUPPRESS-CLIENT-SIZE-EVENT X X/X  
SUPPRESS-COMMAND-STATUS-EVENT X X/X  
SUPPRESS-DRAG-DROP-EVENT X X/X  
SUPPRESS-DRAG-ENTER-EVENT X X/X  
SUPPRESS-DRAG-LEAVE-EVENT X X/X  
SUPPRESS-DRAG-OVER-EVENT X X/X  
SUPPRESS-ENTER-EVENT X X/X  
SUPPRESS-IDLE-EVENT X X/X  
SUPPRESS-LEAVE-EVENT X X/X  
SUPPRESS-SIZE-EVENT X X/X  
TOOLBAR-HANDLE X X/-  
TOOLBAR-POS X X/- X
TOOLTIP X X/X  
TYPE X X/- X
VERSION X -/-  
VERT-SCROLLABLE X X/X X
VISIBLE X X/X X
WALLPAPER X X/X X

Top of page

イベント

After-Any イベントAfter-Open イベントBefore-Any イベントBefore Open イベントBefore-Open イベントClient-Size イベント(抑制される場合があります)、Close イベントCommand-Status イベント(抑制される場合があります)、Drag-Drop イベント(抑制される場合があります)、Drag-Enter イベント(抑制される場合があります)、Drag-Leave イベント(抑制される場合があります)、Drag-Over イベント(抑制される場合があります)、Enter イベント(抑制される場合があります)、Error イベントIdle イベント(抑制される場合があります)、Leave イベント(抑制される場合があります)、Size イベント(抑制される場合があります)。

Top of page