Структура 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 сообщение, она передает значение helpID в элементе dwContextId структуры HELPINFO .

exStyle

Тип: DWORD

Расширенные стили для окна. Этот элемент не используется для создания элементов управления в диалоговых окнах, но приложения, использующие шаблоны диалоговых окон, могут использовать его для создания других типов окон. Список значений см. в разделе Стили расширенных окон.

style

Тип: DWORD

Стиль элемента управления. Этот элемент может быть сочетанием значений стиля окна (например , WS_BORDER) и одного или нескольких значений стиля элемента управления (например , BS_PUSHBUTTON и ES_LEFT).

x

Тип: short

Координата по оси X в единицах диалогового окна верхнего левого угла элемента управления. Эта координата всегда находится относительно левого верхнего угла клиентской области диалогового окна.

y

Тип: short

Координата по оси Y в единицах диалогового окна верхнего левого угла элемента управления. Эта координата всегда находится относительно левого верхнего угла клиентской области диалогового окна.

Cx

Тип: short

Ширина элемента управления в единицах диалогового окна.

Cy

Тип: short

Высота элемента управления в единицах диалогового окна.

идентификатор

Тип: DWORD

Идентификатор элемента управления.

windowClass

Тип: sz_Or_Ord

Массив переменной длины из 16-разрядных элементов, указывающий класс окна элемента управления . Если первым элементом этого массива является любое значение, отличное от 0xFFFF, система рассматривает массив как строку Юникода, завершающуюся null, которая указывает имя зарегистрированного класса окна.

Если первый элемент является 0xFFFF, массив имеет один дополнительный элемент, указывающий порядковое значение предопределенного системного класса. Порядковый номер может быть одним из следующих значений атома.

Значение	Значение
0x0080	Кнопка
0x0081	Изменить
0x0082	Статические
0x0083	Список
0x0084	полоса прокрутки;
0x0085	Поле со списком

title

Тип: sz_Or_Ord

Массив переменной длины из 16-разрядных элементов, содержащий начальный текст или идентификатор ресурса элемента управления. Если первый элемент этого массива является 0xFFFF, массив имеет один дополнительный элемент, указывающий порядковое значение ресурса, например значок, в исполняемом файле. Идентификатор ресурса можно использовать для таких элементов управления, как статические значки, которые загружают и отображают значок или другой ресурс, а не текст. Если первый элемент имеет любое значение, отличное от 0xFFFF, система рассматривает массив как строку Юникода, завершающуюся null, которая указывает начальный текст.

extraCount

Тип: WORD

Количество байтов данных создания, следующих за этим элементом. Если это значение больше нуля, создание данных начинается с следующей границы WORD . Эти данные создания могут иметь любой размер и формат. Оконная процедура элемента управления должна иметь возможность интерпретировать данные. Когда система создает элемент управления, она передает указатель на эти данные в параметре lParamWM_CREATE сообщения, отправляемого элементу управления.

Комментарии

Расширенный шаблон для диалогового окна состоит из заголовка DLGTEMPLATEEX , за которым следует структура DLGITEMTEMPLATEEX для каждого элемента управления в диалоговом окне.

Каждая структура DLGITEMTEMPLATEEX должна быть выровнена по границе DWORD . Массивы windowClass и title переменной длины должны быть выровнены по границам WORD . Массив данных создания( если таковой имеется) должен быть выровнен по границе WORD .

При указании символьных строк в массивах windowClass и title необходимо использовать строки Юникода. Используйте функцию MultiByteToWideChar для создания строк Юникода из строк ANSI.

Элементы x, y, cx и cy задают значения в единицах диалогового окна. Эти значения можно преобразовать в единицы экрана (пиксели) с помощью функции MapDialogRect .

Требования

См. также раздел

Справочные материалы

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Основные понятия

Диалоговые окна

Другие ресурсы

MultiByteToWideChar

WM_HELP