DIALOG リソース
ダイアログ ボックスを定義します。 ステートメントは、画面上のダイアログ ボックスの位置と寸法、およびダイアログ ボックスのスタイルを定義します。
注意
DIALOG は古いリソース ID です。 新しいアプリケーションでは DIALOGEX を使用する必要があります。
nameID DIALOG x, y, width, height [optional-statements] {control-statement . . . }
パラメーター
-
Nameid
-
ダイアログ ボックスを識別する一意の名前または一意の 16 ビット符号なし整数値。
-
optional-statements
-
ダイアログ ボックスのオプション。 次のステートメントの 0 個以上を指定できます。
ステートメント 説明 キャプション "text" タイトル バーがある場合のダイアログ ボックスのキャプション。 詳細については、「 CAPTION」を参照してください。 CHARACTERISTICSdword リソース ツールで使用するユーザー定義 DWORD 値。 この値は、システムでは使用されません。 詳細については、「 特性」を参照してください。 CLASSクラス ダイアログ ボックスのクラスを識別する 16 ビット符号なし整数または二重引用符 (") で囲まれた文字列。 詳細については、「 CLASS」を参照してください。 EXSTYLE=extended-styles ダイアログ ボックスの拡張ウィンドウ スタイル。 詳細については、「 EXSTYLE」を参照してください。 FONTポイントサイズ、 書体 フォントのポイント サイズと書体。 詳細については、「 FONT」を参照してください。 言語、サブ言語 ダイアログ ボックスの言語。 詳細については、「 LANGUAGE」を参照してください。 MENU menuname 使用するメニュー。 この値は、メニューの名前またはその整数識別子です。 STYLE スタイル ダイアログ ボックスのスタイル。 詳細については、「 STYLE」を参照してください。 VERSIONdword ユーザー定義 DWORD 値。 このステートメントは、追加のリソース ツールで使用することを目的としており、システムでは使用されません。 詳細については、「 VERSION」を参照してください。
下位互換性のために、特定の属性もサポートされています。 詳細については、「 共通リソース属性」を参照してください。
解説
GetDialogBaseUnits 関数は、ダイアログの基本単位をピクセル単位で返します。 座標の正確な意味は、 STYLE オプション ステートメントで定義されたスタイルによって異なります。 子スタイルのダイアログ ボックスの場合、ダイアログ ボックスのスタイルが DS_ABSALIGNでない限り、座標は親ウィンドウの原点を基準とします。その場合、座標は表示画面の原点を基準とします。
モーダル ダイアログ ボックスで WS_CHILD スタイルを使用しないでください。 DialogBox 関数は、新しく作成されたダイアログ ボックスの親/所有者を常に無効にします。 親ウィンドウが無効になっている場合、その子ウィンドウは暗黙的に無効になります。 子スタイルダイアログ ボックスの親ウィンドウは無効になっているため、子スタイルのダイアログ ボックスも無効になります。
ダイアログ ボックスに DS_ABSALIGN スタイルが設定されている場合、その左上隅のダイアログ座標は、親ウィンドウの左上隅ではなく画面の原点を基準とします。 通常、このスタイルは、親ウィンドウが画面上のどこにあっても、表示の特定の部分でダイアログ ボックスを開始する場合に使用します。
DIALOG という名前を CreateWindow 関数のクラス名パラメーターとして使用して、ダイアログ ボックス属性を含むウィンドウを作成することもできます。
例
DIALOG ステートメントの使用方法を次に示します。
#include <windows.h>
ErrorDialog DIALOG 10, 10, 300, 110
STYLE WS_POPUP | WS_BORDER
CAPTION "Error!"
{
CTEXT "Select One:", 1, 10, 10, 280, 12
PUSHBUTTON "&Retry", 2, 75, 30, 60, 12
PUSHBUTTON "&Abort", 3, 75, 50, 60, 12
PUSHBUTTON "&Ignore", 4, 75, 80, 60, 12
}
関連項目