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 [僅限傳統型應用程式]

另請參閱

參考

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

概念

對話方塊

其他資源

MultiByteToWideChar

WM_HELP