Элемент управления RadioButtonGroup
Элемент управления RadioButtonGroup — это группа переключателей. Он позволяет пользователю выбрать строковое или целое значение для свойства из предопределенного списка значений. Этот элемент управления можно связать с свойством, введя имя свойства в столбец свойств таблицы Control. Укажите возможные значения для выбора в столбце Value таблицы RadioButton. Обратите внимание, что отображаемая строка не обязательно совпадает со значением, которое выбирает пользователь.
Каждый элемент управления RadioButtonGroup связан со свойством. Значение по умолчанию для этого свойства должно быть инициализировано в таблице свойств. В каждой radioButtonGroup, указанной в таблице RadioButton, может быть одна переключатель, которая имеет значение в поле Value, которое соответствует значению по умолчанию для этого свойства. Это кнопка по умолчанию для элемента управления RadioButtonGroup. Изначально кнопка по умолчанию отображается, как выбрано в элементе управления.
Обратите внимание, что фокус на диалоговом окне не может перейти к элементу управления RadioButtonGroup, пока не выбрана одна из кнопок в группе. Чтобы переместить фокус в эту группу кнопок, укажите одну из кнопок в качестве кнопки по умолчанию для группы.
RadioButtonGroup управляет только заданными значениями свойств и не может использоваться для отправки controlEvent.
Реализация обрабатывает всю группу как один элемент управления, поэтому невозможно скрыть или отключить отдельные кнопки в группе. Аналогичным образом все кнопки должны иметь одинаковый стиль, то есть все они имеют текст или все они имеют растровые изображения (или другие аналогичные функции). Позиция кнопок создается относительно группы. Таким образом, всю группу можно переместить, изменив только координаты группы без изменения отдельных кнопок. При создании элемента управления проверяет, что отдельные кнопки не выходят за рамки группы.
Атрибуты элемента управления
С этим элементом управления можно использовать следующие атрибуты. Чтобы изменить значение атрибута с помощью события, подпишите элемент управления ControlEvent в таблице EventMapping и перечислите идентификатор атрибута в столбце атрибута. Введите идентификатор ControlEvent в столбце событий.
| Идентификатор атрибута | Шестнадцатеричный бит | Description |
|---|---|---|
| НепрямаяpropertyName | Это имя косвенного свойства, связанного с элементом управления. Если задан бит косвенного атрибута, элемент управления отображает или изменяет значение свойства, имеющего это имя. Если задан бит косвенного атрибута, это имя также является значением свойства, указанного в столбце свойств таблицы Control. | |
| Занимаемая должность | Положение элемента управления в диалоговом окне. Введите ширину, высоту и координаты левого угла элемента управления в столбцы Width, Height, X и Y таблицы Control. Используйте единицы установщика для длины и расстояния. |
|
| PropertyName | Это имя свойства, связанного с этим элементом управления. Если бит косвенного атрибута не задан, элемент управления отображает или изменяет значение свойства, имеющего это имя. Этот атрибут указан в столбце "Свойство" таблицы Control. | |
| PropertyValue | Текущее значение свойства, отображаемое или измененное этим элементом управления. Если бит косвенного атрибута не задан, это значение PropertyName. Если задан бит непрямого атрибута, это значение IndirectPropertyName. Если атрибут изменяется, элемент управления отражает новое значение. | |
| Text | Этот атрибут элемента управления может указывать текст, отображаемый элементом управления, изображением, хранящимся в двоичной таблице или набором изображений во время выполнения. Чтобы указать текст, введите текстовую строку в текстовый столбец таблицы Control. Чтобы задать стиль шрифта и шрифта этого текста, префиксирует строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определено как допустимый текстовый стиль, этот шрифт будет использоваться. Чтобы указать значок или растровое изображение, хранящиеся в двоичной таблице, введите первичный ключ записи изображения из столбца "Имя" двоичной таблицы в текстовый столбец записи таблицы Control для элемента управления. |
|
| Visible | 0x00000000 0x00000001 |
Скрытый элемент управления. Видимый элемент управления. Включите этот бит в битовое слово столбца "Атрибуты" в таблице Control, чтобы сделать элемент управления видимым или скрытым при его создании. Вы также можете скрыть или показать элемент управления с помощью таблицы ControlCondition. |
| Включено | 0x00000000 0x00000002 |
Управление в отключенном состоянии. Управление включенным состоянием. Включите этот бит в столбец "Атрибуты" элемента управления , чтобы включить элемент управления при создании. Вы также можете включить или отключить элемент управления с помощью таблицы ControlCondition. |
| Затонувший | 0x00000000 0x00000004 |
Отображает визуальный стиль по умолчанию. Отображает элемент управления с 3-D. Включите эти биты в битовое слово в столбец "Атрибуты" таблицы Control. |
| Косвенные | 0x00000000 0x00000008 |
Элемент управления отображает или изменяет значение свойства в столбце "Свойство" таблицы Control. Элемент управления отображает или изменяет значение свойства, которое содержит идентификатор, указанный в столбце свойств таблицы Control. Определяет, ссылается ли свойство, связанное с этим элементом управления, косвенно. |
| Целое число | 0x00000000 0x00000010 |
Свойство, связанное с элементом управления, является строковым значением. Свойство, связанное с элементом управления, является целым значением. Включите этот бит в битовое слово столбца "Атрибуты" таблицы Control, чтобы задать этот атрибут при создании элемента управления. |
| RTLRO | 0x00000000 0x00000020 |
Текст в элементе управления отображается в порядке чтения слева направо. Текст в элементе управления отображается в порядке чтения справа налево. |
| RightAligned | 0x00000000 0x00000040 |
Текст в элементе управления выровнен по левому краю. Текст в элементе управления выровнен справа. |
| PushLike | 0x00000000 0x00020000 |
Элемент управления рисуется с обычным внешним видом. Элемент управления имеет стиль BS_PUSHLIKE и отображается как кнопка push. Включите этот бит в битовое слово столбца "Атрибуты" таблицы Control, чтобы задать этот атрибут при создании элемента управления. |
| Bitmap | 0x00000000 0x00040000 |
Текст в элементе управления указывается в текстовом столбце таблицы Control. Элемент управления имеет стиль BS_BITMAP, текст в элементе управления заменяется растровым изображением. Текстовый столбец в таблице Control используется в качестве внешнего ключа для двоичной таблицы. Включите этот бит в битовое слово в столбец "Атрибуты" таблицы Control. Не устанавливайте биты стиля значка и растрового рисунка одновременно. Кнопка не может содержать как растровое изображение, так и текст. Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определено как допустимый текстовый стиль, этот шрифт будет использоваться. |
| Значок | 0x00000000 0x00080000 |
Текст в элементе управления указывается в текстовом столбце таблицы Control. Элемент управления имеет стиль BS_ICON, текст в элементе управления заменяется изображением значка. Текстовый столбец в таблице Control используется в качестве внешнего ключа для двоичной таблицы. Включите этот бит в битовое слово в столбец "Атрибуты" таблицы Control. Не устанавливайте одновременно биты значка и растрового изображения. Кнопка не может содержать изображение значка и текст. Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определено как допустимый текстовый стиль, этот шрифт будет использоваться. |
| Фиксированный размер | 0x00000000 0x00100000 |
Растяните изображение значка, чтобы он соответствовал элементу управления. Обрезка или центр изображения значка в элементе управления. Включите этот бит в битовое слово столбца "Атрибуты" таблицы Control. |
| Значок | 0x00000000 0x00200000 0x00400000 0x00600000 |
Загружает первый образ. Загружает первый образ 16x16. Загружает первый образ 32x32. Загружает первый образ 48x48. Файл значка может содержать изображения разного размера одного значка. Включите значение соответствующего битового слова в столбец "Атрибуты" таблицы Control Если эти биты не заданы, установщик игнорирует атрибут FixedSize и изображение растянуто, чтобы поместить прямоугольник элемента управления. Если заданы биты IconSize и FixedSize, изображение меньше, чем элемент управления, и изображение больше, чем элемент управления. |
| HasBorder | не задать 0x01000000 |
Нет границы и текста. Отображает границу и текст. Включите 16777216 в битовое слово в столбец "Атрибуты" элемента управления для отображения границы и текста. |
Замечания
Из-за того, как Windows рисует кадр, между верхней частью окна элемента управления и видимым кадром, даже если нет подпись.
Этот элемент управления можно создать из класса BUTTON с помощью функции CreateWindowEx. Если бит HasBorder задан, он имеет стиль BS_GROUPBOX, в противном случае он имеет стиль BS_OWNERDRAW.
Элемент управления RadioButtonGroup не должен перекрывать другие элементы управления, а другие элементы управления не должны перекрываться в RadioButtonGroup. Перекрытие этого элемента управления и другое может привести к неправильной функции или отображению элементов управления. Чтобы предоставить программы чтения с экрана с дополнительным описательным текстом о элементе управления RadioButtonGroup, следуйте примеру, приведенному в разделе "Добавление дополнительного текста в переключатели".