Элемент управления MaskedEdit
Элемент управления MaskedEdit — это элемент управления поля редактирования, содержащий маску в текстовом поле элемента управления. Элемент управления можно связать со свойством строкового значения, введя имя свойства в столбец свойств таблицы Control Table.
Элемент управления MaskedEdit можно использовать для создания шаблона для ввода сведений пользователя, таких как номер телефона или код идентификатора продукта. Например, свойство PIDKEY может быть введено пользователем с помощью элемента управления MaskedEdit, указанного путем задания свойства PIDTemplate строку, как показано ниже:
12345<### —%%%%%%%>@@@@@
Строка определяет шаблон маскирования для записи PIDKEY Свойства пользователя. Видимый сегмент строки заключен в пару символов скобки (<>) .
В следующей таблице определен синтаксис маски.
| Характер | Значение |
|---|---|
| < | Левый конец видимого сегмента шаблона. Этот символ и все слева скрыты в пользовательском интерфейсе. В шаблоне не должно быть более одного экземпляра этого символа. |
| > | Правый конец видимого сегмента шаблона. Этот символ и все его право скрыты в пользовательском интерфейсе. Этот символ заменяется дефисом во время проверки. Если видимый сегмент начинается с <, его необходимо завершить с соответствующим >. |
| # | Этот символ может быть цифрой (числовой.) |
| % | Этот символ может быть альтернативной цифрой (числовой), которая позволяет маске управлять способом настраиваемых действий различать поля. |
| @ | Этот символ может быть случайной цифрой (числовой.) Этот символ не должен отображаться в видимой части шаблона. |
| & | Этот символ может быть любым символом. |
| ^ | Этот символ может быть альтернативным символом, который позволяет маске управлять способом настраиваемых действий различать поля. |
| ? | Этот символ может быть альтернативным символом, который позволяет маске управлять способом настраиваемых действий различать поля. |
| ` | Серьезные знаки акцента ' (значение ASCII 96) может представлять альтернативный символ, позволяющий маске управлять способом настраиваемых действий различать поля. |
| _ | Этот символ является символом символа подчеркивания. |
| = | Этот символ является терминатором поля. Это должно соответствовать #, %, ^или '. Это создает еще одну входную позицию того же типа, что и предыдущие позиции, и завершает поле с разделителем "-". |
Любой другой символ рассматривается как литеральная константа.
Для символов, которые можно изменить, элемент управления создает отдельные окна редактирования с одним окном для каждого блока смежных символов одного типа.
Атрибуты элемента управления
Чтобы изменить значение атрибута, используюющего событие, подпишите элемент управления на событие Control в таблице EventMapping и перечислите идентификатор атрибута в столбце атрибутов. Введите идентификатор события Control в столбце событий. С элементом управления MaskedEdit можно использовать следующие атрибуты.
| Атрибут | Шестнадцатеричный бит | Описание |
|---|---|---|
| ПрямаяpropertyName | Это имя косвенного свойства, связанного с элементом управления. Если задан бит косвенного атрибута, элемент управления отображает или изменяет значение свойства, имеющего это имя. Если задан бит косвенного атрибута, это имя также является значением свойства, указанного в столбце свойств таблицы Control Table. | |
| положение | Положение элемента управления в диалоговом окне. Введите ширину элемента управления, высоту и координаты левого угла элемента управления в столбцы Width, Height, X и Y таблицы управления . Используйте единиц установщика для длины и расстояния. |
|
| PropertyName | Это имя свойства, связанного с этим элементом управления. Если бит косвенного атрибута не задан, элемент управления отображает или изменяет значение свойства, имеющего это имя. Этот атрибут указан в столбце свойств таблицы управления . | |
| PropertyValue | Текущее значение свойства, отображаемого или измененного этим элементом управления. Если бит косвенного атрибута не задан, это значение PropertyName. Если задан бит косвенного атрибута, это значение IndirectPropertyName. Если атрибут изменяется, элемент управления отражает новое значение. | |
| текста | Чтобы задать стиль шрифта и шрифта текстовой строки, префиксирует строку отображаемых символов с помощью {\style} или {&стиле}. Где стиль — это идентификатор, указанный в столбце "Стиль" таблицы TextStyle. Если ни из них нет, но свойство DefaultUIFont defaultUIFont определяется как допустимый текстовый стиль, используется этот шрифт. Строка, указывающая шаблон маскирования, следует этому префиксу и использует синтаксис, описанный ранее в этом разделе. | |
| видимые | 0x00000000 0x00000001 |
Скрытый элемент управления. Видимый элемент управления. Включите этот бит в битовое слово столбца "Атрибуты" в таблицы управления, чтобы элемент управления был видимым или скрытым при создании. Вы также можете скрыть или показать элемент управления с помощью таблицы ControlCondition. |
| включено | 0x00000000 0x00000002 |
Управление в отключенном состоянии. Управление включенным состоянием. Включите этот бит в битовое слово в столбец "Атрибуты" таблицы управления , чтобы включить элемент управления при создании. Вы также можете включить или отключить элемент управления с помощью таблицы ControlCondition. |
| Sunken | 0x00000000 0x00000004 |
Отображает визуальный стиль по умолчанию. Отображает элемент управления с 3-D взглядом. Включите эти биты в битовое слово в столбец "Атрибуты" таблицы управления . |
| косвенные | 0x00000000 0x00000008 |
Элемент управления отображает или изменяет значение свойства в столбце "Свойство" таблицы управления. Элемент управления отображает или изменяет значение свойства, которое содержит идентификатор, указанный в столбце свойств таблицы управления . Определяет, ссылается ли свойство, связанное с этим элементом управления, косвенно. |
Замечания
Элемент управления MaskedEdit создает одно родительское окно класса BUTTON со стилями BS_OWNERDRAW и WS_EX_CONTROLPARENT. Он создает несколько дочерних окон в этом окне.
- Для константных текстовых частей создается статические окна со стилями SS_LEFT и WS_CHILD.
- Для редактируемых полей создается окно EDIT с стилями WS_CHILD, WS_BORDERи WS_TABSTOP.
- Для числовых полей окно также имеет стиль ES_NUMBER.
Альтернативные цифры, %и альтернативные буквенно-цифровые символы, ^, ?, и ', позволяют пользовательским действиям различать поля таким образом, чтобы управлять маской, например^ можно использовать для полей, которые должны быть прописными.