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 坐标(以对话框为单位)。 此坐标始终相对于对话框工作区的左上角。
-
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 边界上对齐。 可变长度 windowClass 和 title 数组必须在 WORD 边界上对齐。 创建数据数组(如果有)必须在 WORD 边界上对齐。
如果在 windowClass 和 title 数组中指定字符串,则必须使用 Unicode 字符串。 使用 MultiByteToWideChar 函数从 ANSI 字符串生成 Unicode 字符串。
x、y、cx 和 cy 成员以对话框单位指定值。 可以使用 MapDialogRect 函数将这些值转换为屏幕单位 (像素) 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |