Общие параметры элемента управления

Ниже описан общий синтаксис инструкции определения ресурсов элемента управления. Значение каждого параметра приведено ниже. Иногда оператор будет использовать параметр по-другому или игнорировать параметр. Вариант для конкретного оператора описан в документации по инструкции.

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

text

Текст, отображаемый элементом управления. Текст расположен в элементе управления или рядом с элементом управления.

Этот параметр должен содержать нулевые или более символы, заключенные в двойные кавычки ("). Строки автоматически завершаются null и преобразуются в Юникод в результирующем файле ресурсов.

По умолчанию символы, перечисленные между двойными кавычками, являются символами ANSI, а escape-последовательности интерпретируются как escape-последовательности байтов. Если строка предшествует префиксу "L", строка представляет собой строку расширенных символов, а escape-последовательности интерпретируются как 2-байтовые escape-последовательности, указывающие символы Юникода. Если в тексте требуется двойная кавычка, необходимо включить двойную кавычку дважды.

Амперсанд (&) в тексте указывает, что следующий символ используется в качестве символа mnemonic для элемента управления. При отображении элемента управления амперсанд не отображается, но подчеркивается символ mnemonic. Пользователь может выбрать элемент управления, нажав клавишу, соответствующую подчеркиваемой символу. Чтобы использовать амперсанд в качестве символа в строке, вставьте два амперсанда (&>).

id

Идентификатор элемента управления. Это значение должно быть 16-разрядное целое число без знака в диапазоне от 0 до 65 535 или простое арифметическое выражение, которое оценивает значение в этом диапазоне.

x

Координата X левой части элемента управления относительно левой стороны диалогового окна. Это значение должно быть 16-разрядным целым числом без знака в диапазоне от 0 до 65 535. Координата находится в диалоговых единицах и относится к источнику диалогового окна, окна или элемента управления, содержащего указанный элемент управления.

г

Координата Y верхней части элемента управления относительно верхней части диалогового окна. Это значение должно быть 16-разрядным целым числом без знака в диапазоне от 0 до 65 535. Координата находится в блоках диалоговых окон относительно источника диалогового окна, окна или элемента управления, содержащего указанный элемент управления.

width

Ширина элемента управления. Это значение должно быть 16-разрядным целым числом без знака в диапазоне от 1 до 65 535. Ширина составляет 1/4 символьных единиц.

height

Высота элемента управления. Это значение должно быть 16-разрядным целым числом без знака в диапазоне от 1 до 65 535. Высота составляет 1/8 символов.

style

Стили элементов управления. Используйте побитовый оператор OR (|) для объединения стилей. Дополнительные сведения см. в разделе "Стили окон".

расширенный стиль

Расширенные стили окон. Необходимо указать стиль, чтобы указать расширенный стиль. Дополнительные сведения см. в разделе EXSTYLE.

helpId

Числовое выражение, указывающее идентификатор, используемый для идентификации элемента управления во время обработки WM_HELP.

controlData

Данные, относящиеся к элементу управления. При создании диалогового окна и элементе управления в этом диалоговом окне, который содержит данные, относящиеся к элементу управления, указатель на эти данные передаются в процедуру окна элемента управления через lParam сообщения WM_CREATE для этого элемента управления.

Замечания

Горизонтальные диалоговые единицы — 1/4 единицы базовой ширины диалогового окна. Вертикальные единицы — 1/8 блока высоты диалогового окна. Текущие базовые единицы диалога вычисляются по высоте и ширине текущего системного шрифта. Функция GetDialogBaseUnits возвращает базовые единицы диалога в пикселях. Координаты относятся к источнику диалогового окна.