Каноническое свойство PidTagControlFlags
Область применения: Outlook 2013 | Outlook 2016
Содержит битовую маску флагов, управляющих поведением элемента управления, используемого в диалоговом окне, созданном из таблицы отображения.
| Свойство | Значение |
|---|---|
| Связанные свойства: |
PR_CONTROL_FLAGS |
| Идентификатор: |
0x3F00 |
| Тип данных: |
PT_LONG |
| Область: |
Таблица отображения MAPI |
Замечания
Для этого свойства можно задать один или несколько следующих флагов:
DT_ACCEPT_DBCS
Элемент управления может содержать Double-Byte символы набора символов (DBCS). Этот флаг используется с элементами управления редактирования. Он позволяет использовать многобайтовые наборы символов.
DT_EDITABLE
Элемент управления можно изменить; значение, связанное с элементом управления, можно изменить. Если этот флаг не задан, элемент управления доступен только для чтения. Это значение игнорируется в элементах управления label, group box, standard push button, multivalued drop down list box и list box.
DT_MULTILINE
Элемент управления "Изменение" может содержать несколько строк. Это означает, что в элементе управления можно ввести возвращаемый символ. Этот флаг действителен только для элементов управления редактирования.
DT_PASSWORD_EDIT
Применяется к элементам управления редактирования. Элемент управления "Изменение" обрабатывается как пароль. Значение отображается с помощью звездочек вместо того, чтобы повторять фактические введенные символы.
DT_REQUIRED
Если элемент управления допускает изменения (DT_EDITABLE), он должен иметь значение перед вызовом IMAPIProp::SaveChanges .
DT_SET_IMMEDIATE
Включает немедленное задание значения; как только значение в элементе управления изменится, MAPI вызывает метод SetProps для свойства, связанного с этим элементом управления. Если этот флаг не задан, значения задаются при закрытии диалогового окна.
DT_SET_SELECTION
При выборе в списке столбец индекса этого списка задается в качестве свойства. Всегда используется с DT_SET_IMMEDIATE.
Это свойство хранится в элементе ulCtlFlags структуры DTCTL элемента управления. Большинство флагов элементов управления применяются ко всем элементам управления, разрешающим ввод пользователем; некоторые из них применяются только к элементу управления edit. Элементы управления, которые не разрешают ввод пользователем, такие как кнопка или метка, устанавливают 0 для флагов элементов управления.
Многие из значений флага являются понятными. Например, если DT_REQUIRED задано для элемента управления, он должен содержать значение, прежде чем диалоговое окно будет разрешено закрыть. Поставщик услуг может предоставить значение через реализацию IMAPIProp или пользователь может ввести его. DT_EDITABLE указывает, что значение элемента управления можно изменить. DT_MULTILINE позволяет значению элемента управления редактирования охватывать несколько строк.
Некоторые флаги элементов управления не столь очевидны по своему значению. Когда элемент управления задает флаг DT_SET_IMMEDIATE, любые изменения его значения влияют, как только пользователь переходит к новому элементу управления. MAPI выполняет один вызов метода IMAPIProp::SetProps интерфейса свойства элемента управления. Это отличается от поведения по умолчанию, которое заключается в том, что изменения значений элементов управления вступают в силу до тех пор, пока пользователь не наберет кнопку ОК или не закроет диалоговое окно. Флаг DT_SET_IMMEDIATE часто используется в сочетании с уведомлениями таблицы отображения.
В следующей таблице перечислены типы элементов управления и все значения флагов, которые можно задать для каждого типа.
| Control | Допустимые значения для этого свойства |
|---|---|
| Кнопка |
Должно быть равно нулю |
| Флажок |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Поле со списком |
DT_EDITABLE, DT_REQUIRED, DT_SET_IMMEDIATE |
| Раскрывающийся список |
DT_EDITABLE, DT_SET_IMMEDIATE |
| Изменить |
DT_ACCEPT_DBCS, DT_MULTILINE, DT_EDITABLE, DT_PASSWORD_EDIT, DT_REQUIRED, DT_SET_IMMEDIATE |
| Поле группы |
Должно быть равно нулю |
| Label |
Должно быть равно нулю |
| Поле со списком |
Должно быть равно нулю |
| Раскрывающийся список с несколькими значениями |
Должно быть равно нулю |
| Список с несколькими значениями |
Должно быть равно нулю |
| Страница с вкладками |
Должно быть равно нулю |
| Переключатель |
Должно быть равно нулю |
Связанные ресурсы
Файлы заголовков
Mapidefs.h
Предоставляет определения типов данных.
Mapitags.h
Содержит определения свойств, перечисленных как альтернативные имена.