共用方式為


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_PUSHBUTTONES_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、cxcy成員會在對話方塊單位中指定值。 您可以使用 MapDialogRect 函式,將這些值轉換成螢幕單位 (圖元) 。

規格需求

需求
最低支援的用戶端
Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]

另請參閱

參考

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

概念

對話方塊

其他資源

MultiByteToWideChar

WM_HELP