DIALOGEX 資源

發行項
01/10/2024

定義對話框。語句會定義螢幕上對話框的位置和維度，以及對話框樣式。它也會定義下列專案：

對話框本身以及對話框內控件的說明標識碼。
針對對話框本身以及對話框內的控件使用 EXSTYLE 語句。
對話框中要使用的字型粗細和斜體設定。
對話框中控制件的控制項特定數據。
使用 BEDIT、IEDIT 和 HEDIT 預先定義的系統類別名稱。

nameID DIALOGEX x, y, width, height [ , helpID] [optional-statements]  {control-statements}

參數

nameID

唯一名稱或識別對話框的唯一 16 位不帶正負號整數值。

x

對話框左側畫面上的位置，以對話框單位表示。

y

對話框頂端畫面上的位置，以對話框單位表示。

寬度

對話框的寬度，以對話框單位表示。

height (高度)

對話框的高度，以對話框單位表示。

helpID

數值表達式，指出在WM_HELP處理期間用來識別對話框的標識碼。

optional-statements

對話框的選項。這可以是下列語句的零或多個。

陳述式	描述
標題 “text”	如果對話框具有標題列，則為對話框的標題。如需詳細資訊，請參閱 CAPTION 語句。
特性dword	可供資源工具使用的使用者定義 DWORD 值。系統不會使用這個值。如需詳細資訊，請參閱 CHARACTERISTICS 語句。
CLASS 類別	以雙引弧括住的16位無符號整數或字串，可識別對話框的類別。如需詳細資訊，請參閱 CLASS 語句。
EXSTYLE= 擴充樣式	對話框的延伸視窗樣式。如需詳細資訊，請參閱 EXSTYLE 語句。
FONTpointsize， “typeface”， weight， italic， charset	字型的點號和字樣。針對權數，請使用 WinGDI.h 中定義的 FW_* 值。如果是斜體，請指定TRUE以使用斜體字型 FALSE，否則為 FALSE。針對 charset，請使用 LOGFONT 結構的 lfCharSet 成員中定義的值。若要取得對話框的明確字型，應用程式應該指定字元集以及其他字型屬性。如需詳細資訊，請參閱FONT語句。
LANGUAGELanguage， sublanguage	對話框的語言。如需詳細資訊，請參閱 LANGUAGE 語句。
MENUmenuname	要使用的功能表。這個值是功能表的名稱或其整數標識碼。如需詳細資訊，請參閱 MENU 語句。
樣式樣式	對話框的樣式。如需詳細資訊，請參閱 STYLE 語句。
VERSIONdword	用戶定義的 DWORD 值。此語句僅供其他資源工具使用，且系統不會使用。如需詳細資訊，請參閱 VERSION 語句。

control-statements

DIALOGEX 資源的主體是由任意數目的控制語句所組成。控件語句有四個系列：泛型、靜態、按鈕和編輯。如需詳細資訊，請參閱＜備註＞。

某些屬性也支援回溯相容性。如需詳細資訊，請參閱通用資源屬性。

備註

DIALOGEX 語句中任何數值表示式中可能包含的有效作業如下：

新增（'+'）
減去（'-'）
一元減號（'-'）
一元 NOT （'~'）
AND （'&'）
OR （'|'）

資源的主體是由泛型、靜態、按鈕和編輯控件語句所組成。雖然這些語句系列都使用不同的語法來定義其控件的特定功能，但它們都會共用通用語法來定義位置、大小、擴充樣式、協助標識符，以及控制特定數據。如需詳細資訊，請參閱通用控件參數。

泛型控件語句

CONTROL controlText, id, className, style

controlText: 控件的視窗文字。如需詳細資訊，請參閱通用控件參數。
id: 控制標識碼。如需詳細資訊，請參閱通用控件參數。
className: 類別的名稱。這可能是以雙引號（“）括住的字串或下列其中一個預先定義的系統類別：BUTTON、STATIC、EDIT、LISTBOX、SCROLLBAR 或 COMBOBOX。
style: 視窗樣式（明確WS_*、BS_*、SS_*、ES_*、LBS_*、SBS_*，以及 Winuser.H 中定義的CBS_* 樣式值，可以藉由將 include 新增至 .rc 檔案來使用： #include "winuser.h"。如需詳細資訊，請參閱窗口樣式。

靜態控件語句

staticClass controlText, id

staticClass: LTEXT、 RTEXT 或 CTEXT。
controlText: 控件的視窗文字。如需詳細資訊，請參閱通用控件參數。
id: 控制標識碼。如需詳細資訊，請參閱通用控件參數。

按鈕控件語句

buttonClass controlText, id

buttonClass: AUTO3STATE、AUTOCHECKBOX、AUTORADIOBUTTON、CHECKBOX、PUSHBOX、PUSHBUTTON、RADIOBUTTON、STATE3 或 USERBUTTON。
controlText: 控件的視窗文字。如需詳細資訊，請參閱通用控件參數。
id: 控制標識碼。如需詳細資訊，請參閱通用控件參數。

編輯控件語句

editClass id

editClass: EDITTEXT、BEDIT、HEDIT 或 IEDIT。
id: 控制標識碼。如需詳細資訊，請參閱通用控件參數。

另請參閱

使用對話框
加速器
特徵
控制
CreateDialog
CreateWindow
DialogBox
GetDialogBaseUnits
LANGUAGE
LOGFONT
功能表
RCDATA
STRINGTABLE
VERSION

共用方式為