DTBLDDLBX
Область применения: Outlook 2013 | Outlook 2016
Описывает элемент управления раскрывающимся списком, который будет использоваться в диалоговом окне, созданном на основе отображаемой таблицы.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
typedef struct _DTBLDDLBX
{
ULONG ulFlags;
ULONG ulPRDisplayProperty;
ULONG ulPRSetProperty;
ULONG ulPRTableName;
} DTBLDDLBX, FAR *LPDTBLDDLBX;
Members
ulFlags
Зарезервировано, должно быть равно нулю.
ulPRDisplayProperty
Тег свойства для свойства типа PT_TSTRING. Это свойство является одним из столбцов в таблице, определяемой элементом ulPRTableName . Значения этого свойства отображаются в списке.
ulPRSetProperty
Тег свойства для свойства любого типа. Это свойство является одним из столбцов в таблице, определяемой элементом ulPRTableName . Когда пользователь списка выбирает значение свойства для элемента ulPRDisplayProperty из строк таблицы, определяемой элементом ulPRTableName , задается соответствующий элемент ulPRSetProperty .
ulPRTableName
Тег свойства для свойства таблицы типа PT_OBJECT, который можно открыть с помощью вызова OpenProperty . Таблица должна содержать два столбца: ulPRDisplayProperty и ulPRSetProperty. Строки таблицы должны соответствовать элементам в списке.
Замечания
Структура DTBLDDLBX описывает элемент управления раскрывающимся списком, который отображается в виде одного элемента до тех пор, пока пользователь не решит развернуть его.
Три свойства, определяемые тегами свойств, работают вместе, чтобы отобразить сведения в списке и задать связанное свойство. Элемент ulPRTableName — это объект таблицы, доступ к которому осуществляется через вызов IMAPIProp::OpenProperty. Таблица содержит два столбца: один столбец для свойства, определяемого элементом ulPRDisplayProperty, а другой для свойства, определяемого элементом ulPRSetProperty .
Свойство ulPRDisplayProperty управляет отображением списка. Когда пользователь выбирает одно из значений на экране, MAPI вызывает IMAPIProp::SetProps , чтобы задать соответствующее свойство, определенное элементом ulPRSetProperty . Это означает, что свойство в той же строке, что и выбранное свойство отображения. Для элемента ulPRSetProperty нельзя задать значение PR_NULL (PidTagNull).
Начальное значение отображается в списке, если MAPI извлек свойство, представленное элементом ulPRSetProperty , через вызов IMAPIProperty::GetProps и располагает строку в таблице со значением элемента ulPRSetProperty . Исходное отображаемое значение — это содержимое столбца ulPRDisplayProperty из этой строки, которое соответствует свойству в элементе ulPRDisplayProperty структуры. Значение, возвращаемое GetProps для свойства, определяемого элементом ulPRDisplayProperty , становится начальным значением, которое отображается при первом отображении списка.
Общие сведения о отображаемых таблицах см. в разделе Таблицы отображения. Сведения о реализации отображаемой таблицы см. в разделе Реализация таблицы отображения. Сведения о типах свойств см. в статье Обзор типов свойств MAPI.