Изменение элемента управления (установщик Windows)

Элемент управления Edit — это поле редактирования, связанное со свойством строкового или целочисленного значения. Введите имя свойства в столбец "Свойство" таблицы Control.

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

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

Идентификатор атрибута Шестнадцатеричный бит Description
НепрямаяpropertyName Это имя косвенного свойства, связанного с элементом управления. Если задан бит косвенного атрибута, элемент управления отображает или изменяет значение свойства, имеющего это имя. Если задан бит косвенного атрибута, это имя также является значением свойства, указанного в столбце свойств таблицы Control.
Занимаемая должность Положение элемента управления в диалоговом окне. Введите ширину, высоту и координаты левого угла элемента управления в столбцы Width, Height, X и Y таблицы Control. Используйте единицы установщика для длины и расстояния.
PropertyName Это имя свойства, связанного с этим элементом управления. Если бит косвенного атрибута не задан, элемент управления отображает или изменяет значение свойства, имеющего это имя. Этот атрибут указан в столбце "Свойство" таблицы Control.
PropertyValue Текущее значение свойства, отображаемое или измененное этим элементом управления. Если бит косвенного атрибута не задан, это значение PropertyName. Если задан бит непрямого атрибута, это значение IndirectPropertyName. Если атрибут изменяется, элемент управления отражает новое значение.
Text Чтобы задать стиль шрифта и шрифта текстовой строки, префиксировать строку отображаемых символов с помощью {\style} или {&style}. Где стиль — это идентификатор, указанный в столбце TextStyle таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont определено как допустимый текстовый стиль, этот шрифт будет использоваться. Чтобы указать количество символов, которые пользователь может ввести, добавьте {n} после любых спецификаций шрифтов. Где n является положительным целым числом.
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
Текст в элементе управления выровнен по левому краю. Текст в элементе управления выровнен справа.
LeftScroll 0x00000000 0x00000080
Полоса прокрутки расположена справа от элемента управления. Полоса прокрутки расположена слева от элемента управления.
Bidi 0x000000E0 Задайте это значение для сочетания атрибутов RTLRO, RightAligned и LeftScroll .
Многострочный 0x00010000 Создает элемент управления редактирования нескольких строк с вертикальной полосой прокрутки. Включите 65536 в битовое слово в столбце "Атрибуты" элемента управления , чтобы создать несколько элементов управления редактирования строк с вертикальной полосой прокрутки.
Пароль 0x00200000 Создает элемент управления редактирования для ввода паролей. Добавьте 2097152 в значение в столбце "Атрибуты" таблицы Control, чтобы создать элемент управления редактированием, отображающий каждый символ в виде звездочки (*), как они вводятся в элемент управления. Установка атрибута пароля запрещает установщику записывать свойство, связанное с элементом управления "Изменить" в файл журнала. Дополнительные сведения см. в разделе "Запрет записи конфиденциальной информации в файл журнала"

Замечания

Этот элемент управления можно создать из класса EDIT с помощью функции CreateWindowEx. Он содержит стили WS_BORDER, WS_CHILD, WS_TABSTOP и WS_GROUP .

Длина введенного текста может быть ограничена путем ввода числа от 0 до 2147483646 в фигурные скобки в начале поля "Текст" в таблице control. Например, если текстовое поле начинается с {80}, длина строки ограничена 80 символами. Если такой предел не указан в таблице или если задано значение 0, длина устанавливается максимально возможно (2147483646 символов). Отрицательное или нечисловое значение приведет к возникновению ошибки.

Для совместимости с средствами чтения с экрана при создании диалогового окна с элементом управления "Изменить" в качестве первого активного элемента управления необходимо сделать текстовое поле, относящееся к полю редактирования, первым активным элементом управления в таблице диалоговых окон. Так как статический текст не может сосредоточиться, при создании диалогового окна поле редактирования будет иметь фокус изначально, но это гарантирует, что средства чтения с экрана отображают правильные сведения.

Свойство, связанное с элементом управления "Изменить", устанавливается только в том случае, если элемент управления теряет фокус. Поэтому необходимо переходить на вкладку из элемента управления или выбрать другой элемент управления для обновления свойства.