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 [仅限桌面应用]

另请参阅

引用

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

概念性

对话框

其他资源

MultiByteToWideChar

WM_HELP