DIALOG リソース

[アーティクル]
06/13/2023

ダイアログボックスを定義します。ステートメントは、画面上のダイアログボックスの位置と寸法、およびダイアログボックスのスタイルを定義します。

注意

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
}

Share via

DIALOG リソース

パラメーター

解説

例

関連項目

フィードバック

フィードバック

その他のリソース