DLGITEMTEMPLATEEX 結構
擴充對話方塊範本用來描述擴充對話方塊的文字區塊。 如需擴充對話方塊範本格式的描述，請參閱 DLGTEMPLATEEX。
語法
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
成員
-
helpID
-
類型： DWORD
-
控制項的說明內容識別碼。 當系統傳送WM_HELP訊息時，它會在HELPINFO結構的dwCoNtextId成員中傳遞helpID值。
-
exStyle
-
類型： DWORD
-
視窗的延伸樣式。 這個成員不會用來在對話方塊中建立控制項，但使用對話方塊範本的應用程式可以使用它來建立其他類型的視窗。 如需值清單，請參閱 擴充視窗樣式。
-
style
-
類型： DWORD
-
控制項的樣式。 這個成員可以是 視窗樣式值 的組合 (，例如 WS_BORDER) 和一或多個 控制項樣式 (值 的組合，例如 BS_PUSHBUTTON 和 ES_LEFT) 。
-
x
-
類型： short
-
控制項左上角的 x 座標，以對話方塊單位表示。 這個座標一律相對於對話方塊工作區的左上角。
-
y
-
類型： short
-
控制項左上角的 Y 座標，以對話方塊單位為單位。 這個座標一律相對於對話方塊工作區的左上角。
-
殘雪
-
類型： short
-
控制項的寬度，以對話方塊單位為單位。
-
cy
-
類型： short
-
控制項的對話方塊單位高度。
-
id
-
類型： DWORD
-
控制項識別碼。
-
windowClass
-
類型： sz_Or_Ord
-
16 位元素的可變長度陣列，指定控制項的視窗類別。 如果這個陣列的第一個專案是0xFFFF以外的任何值，則系統會將陣列視為 Null 終止的 Unicode 字串，指定已註冊的視窗類別名稱。
如果第一個元素0xFFFF，陣列會有一個額外的元素，指定預先定義系統類別的序數值。 序數可以是下列其中一個 Atom 值。
值 意義 - 0x0080
按鈕 - 0x0081
編輯 - 0x0082
靜態 - 0x0083
清單方塊 - 0x0084
捲軸 - 0x0085
下拉式方塊 -
title
-
類型： sz_Or_Ord
-
16 位元素的可變長度陣列，其中包含控制項的初始文字或資源識別碼。 如果這個陣列的第一個元素是0xFFFF，陣列有一個額外的元素，指定資源序數值，例如可執行檔中的圖示。 您可以針對控制項使用資源識別碼，例如靜態圖示控制項，這些控制項會載入並顯示圖示或其他資源，而不是文字。 如果第一個專案是0xFFFF以外的任何值，則系統會將陣列視為指定初始文字的 Null 終止 Unicode 字串。
-
extraCount
-
類型： WORD
-
在此成員後面的建立資料位元組數目。 如果此值大於零，則建立資料會從下一個 WORD 界限開始。 此建立資料可以是任何大小和格式。 控制項的視窗程式必須能夠解譯資料。 當系統建立控制項時，它會在傳送至控制項之WM_CREATE訊息的lParam參數中傳遞此資料的指標。
備註
對話方塊的擴充範本是由 DLGTEMPLATEEX 標頭所組成，後面接著對話方塊中每個控制項的 DLGITEMTEMPLATEEX 結構。
每個 DLGITEMTEMPLATEEX 結構都必須對齊 DWORD 界限。 可變長度 的 windowClass 和 標題 陣列必須在 WORD 界限上對齊。 如果有任何，建立資料陣列必須在 WORD 界限上對齊。
如果您在 windowClass 和 標題 陣列中指定字元字串，則必須使用 Unicode 字串。 使用 MultiByteToWideChar 函式從 ANSI 字串產生 Unicode 字串。
x、y、cx和cy成員會在對話方塊單位中指定值。 您可以使用 MapDialogRect 函式，將這些值轉換成螢幕單位 (圖元) 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |