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 坐标(以对话框为单位)。 此坐标始终相对于对话框工作区的左上角。

cx

类型: short

控件的宽度(以对话框单位为单位)。

cy

类型: short

控件的高度(以对话框单位为单位)。

id

类型:DWORD

控件标识符。

windowClass

类型: sz_Or_Ord

一个由 16 位元素构成的可变长度数组,用于指定控件的窗口类。 如果此数组的第一个元素是除 0xFFFF 以外的任何值,则系统会将该数组视为以 null 结尾的 Unicode 字符串,该字符串指定已注册窗口类的名称。

如果第一个元素0xFFFF,则数组具有一个附加元素,用于指定预定义系统类的序号值。 序号可以是以下原子值之一。

含义
0x0080
Button
0x0081
编辑
0x0082
静态
0x0083
列表框
0x0084
滚动条
0x0085
组合框

title

类型: sz_Or_Ord

包含控件的初始文本或资源标识符的 16 位元素的可变长度数组。 如果此数组的第一个元素0xFFFF,则数组具有一个附加元素,用于指定可执行文件中资源(如图标)的序号值。 可以为加载和显示图标或其他资源而不是文本的控件(例如静态图标控件)使用资源标识符。 如果第一个元素是除 0xFFFF 以外的任何值,则系统会将数组视为指定初始文本的以 null 结尾的 Unicode 字符串。

extraCount

类型: WORD

此成员后面的创建数据的字节数。 如果此值大于零,则创建数据从下一 个 WORD 边界开始。 此创建数据可以是任何大小和格式。 控件的窗口过程必须能够解释数据。 当系统创建控件时,它会在发送到控件的WM_CREATE消息的 lParam 参数中传递指向此数据的指针。

备注

对话框的扩展模板由 DLGTEMPLATEEX 标头和对话框中每个控件的 DLGITEMTEMPLATEEX 结构组成。

每个 DLGITEMTEMPLATEEX 结构必须在 DWORD 边界上对齐。 可变长度 windowClasstitle 数组必须在 WORD 边界上对齐。 创建数据数组(如果有)必须在 WORD 边界上对齐。

如果在 windowClasstitle 数组中指定字符串,则必须使用 Unicode 字符串。 使用 MultiByteToWideChar 函数从 ANSI 字符串生成 Unicode 字符串。

xycxcy 成员以对话框单位指定值。 可以使用 MapDialogRect 函数将这些值转换为屏幕单位 (像素) 。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]

另请参阅

引用

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

概念性

对话框

其他资源

MultiByteToWideChar

WM_HELP