На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

DLGITEMTEMPLATEEX



The DLGITEMTEMPLATEEX structure is not defined in any standard header file. The structure definition is provided here to explain the format of an extended template for a dialog box.

For each control in a dialog box, an extended dialog box template has a block of data that uses the DLGITEMTEMPLATEEX format to describe the control. For a description of the format of an extended dialog box template, see DLGTEMPLATEEX.

// typedef struct {
// DWORD helpID;
// DWORD exStyle;
// DWORD style;
// short x;
// short y;
// short cx;
// short cy;
// WORD id;
// sz_Or_Ord windowClass; // name or ordinal of a window class
// sz_Or_Ord title; // title string or ordinal of a resource
// WORD extraCount; // bytes of following creation data
// } DLGITEMTEMPLATEEX;


Members

helpID

Specifies the help context identifier for the control. When the system sends a WM_HELP message, it passes the helpID value in the dwContextId member of the HELPINFO structure.

dwExtendedStyle

Specifies extended styles for a window. This member is not used to create controls in dialog boxes, but applications that use dialog box templates can use it to create other types of windows.

style

Specifies the style of the control. This member can be a combination of window style values (such as WS_BORDER) and one or more of the control style values (such as BS_PUSHBUTTON and ES_LEFT).

x

Specifies the x-coordinate, in dialog box units, of the upper-left corner of the control. This coordinate is always relative to the upper-left corner of the dialog box's client area.

y

Specifies the y-coordinate, in dialog box units, of the upper-left corner of the control. This coordinate is always relative to the upper-left corner of the dialog box's client area.

cx

Specifies the width, in dialog box units, of the control.

cy

Specifies the height, in dialog box units, of the control.

id

Specifies the control identifier.

windowClass

Specifies a variable-length array of 16-bit elements that identifies the window class of the control. If the first element of this array is any value other than 0xFFFF, the system treats the array as a null-terminated Unicode string that specifies the name of a registered window class.
If the first element is 0xFFFF, the array has one additional element that specifies the ordinal value of a predefined system class. The ordinal can be one of the following atom values.

Value Meaning
0x0080 Button
0x0081 Edit
0x0082 Static
0x0083 List box
0x0084 Scroll bar
0x0085 Combo box


title

Specifies a variable-length array of 16-bit elements that contains the initial text or resource identifier of the control. If the first element of this array is 0xFFFF, the array has one additional element that specifies an ordinal value that identifies a resource, such as an icon, in an executable file. You can use a resource identifier for controls, such as static icon controls, that load and display an icon or other resource rather than text.

If the first element is any value other than 0xFFFF, the system treats the array as a null-terminated Unicode string that specifies the initial text.

extraCount

Specifies the number of bytes of creation data that follow this member. If this value is greater than zero, the creation data begins at the next DWORD boundary. This creation data can be of any size and format. The control's window procedure must be able to interpret the data. When the system creates the control, it passes a pointer to this data in the lParam parameter of the WM_CREATE message that it sends to the control.



Remarks

An extended template for a dialog box consists of a DLGTEMPLATEEX header followed by a DLGITEMTEMPLATEEX structure for each control in the dialog box.
Each DLGITEMTEMPLATEEX structure must be aligned on a DWORD boundary. The variable-length windowClass and title arrays must be aligned on WORD boundaries. The creation data array, if any, must be aligned on a DWORD boundary.
If you specify character strings in the windowClass and title arrays, you must use Unicode strings. To create code that works on both Windows NT and Windows 95, use the MultiByteToWideChar function to generate these Unicode strings.

The x, y, cx, and cy members specify values in dialog box units. You can convert these values to screen units (pixels) by using the MapDialogRect function.

See Also

CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

DLGITEMTEMPLATEEX



Структура DLGITEMTEMPLATEEX не определена в любом стандартном файле заголовка. Структурное определение предусматривается здесь, чтобы объяснять формат расширенного шаблона для диалогового блока.

Для каждого управления в диалоговом блоке, расширенный диалоговый шаблон блока имеет блока данных, которые используют формат DLGITEMTEMPLATEEX, чтобы описывать управление. Для описания формата расширенного диалогового шаблона блока, смотри DLGTEMPLATEEX.

// typedef struct { // DWORD helpID;
// DWORD exStyle;
// СТИЛЬ DWORD;
// перемычка x;
// перемычка y;
// перемычка cx;
// перемычка cy;
// СЛОВО id;
// sz_Or_Ord windowClass; // имя или порядковое класса / окна/ названия sz_Or_Ord; // назовите строку или порядковую ресурса // WORD extraCount; // байты следующих данных / создания/ } DLGITEMTEMPLATEEX;


Участники

helpID

Определяет контекстный идентификатор подсказки для управления. Когда система посылает сообщение WM_HELP, она передает величину helpID в элемент dwContextId структуры HELPINFO.

dwExtendedStyle

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

стиль

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

x

Определяет x-coordinate, на диалоговых устройствах блока, верхнего левого угла управления. Эта координата - всегда относительно верхнего левого угла области клиента диалогового блока.

y

Определяет y-coordinate, на диалоговых устройствах блока, верхнего левого угла управления. Эта координата - всегда относительно верхнего левого угла области клиента диалогового блока.

cx

Определяет ширину, на диалоговых устройствах блока, управления.

cy

Определяет высоту, на диалоговых устройствах блока, управления.

id

Определяет управляющий идентификатор.

windowClass

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

Оцените Значение 0x0080 Кнопки Редактирования 0x0081 0x0082 Статический Список 0x0083 блок 0x0084 Перемещать зону блока 0x0085 Combo


название

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

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

extraCount

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



Замечания

Расширенный шаблон для диалогового блока состоит из заголовка DLGTEMPLATEEX сопровожденного структурой DLGITEMTEMPLATEEX для каждого управления в диалоговом блоке.
Каждая структура DLGITEMTEMPLATEEX должна быть выровнена на границе DWORD. Переменная-длина windowClass и название подготавливает, должны быть выровнены на ТЕКСТОВЫХ границах. Массив данных создания, если имеется в наличии, должен быть выровнен на границе DWORD.
Если Вы определяете символьные строки в windowClass и название подготавливается, Вы должны использовать строки Уникода. Для того, чтобы создавать код, который работает на как Windows NT так и Windows 95, используйте функцию MultiByteToWideChar, чтобы генерировать эти строки Уникода.

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

Смотри Также

CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz