IAddrBook::Details
Область применения: Outlook 2013 | Outlook 2016
Отображает диалоговое окно со сведениями о конкретной записи адресной книги.
HRESULT Details(
ULONG_PTR FAR * lpulUIParam,
LPFNDISMISS lpfnDismiss,
LPVOID lpvDismissContext,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPFNBUTTON lpfButtonCallback,
LPVOID lpvButtonContext,
LPSTR lpszButtonText,
ULONG ulFlags
);
Параметры
lpulUIParam
[в] Указатель на дескриптор родительского окна диалогового окна.
lpfnDismiss
[в] Указатель на функцию на основе прототипа DISMISSMODELESS или NULL. Этот элемент применяется только к немодерной версии диалогового окна, как указано в заданном флаге DIALOG_SDI. MAPI вызывает функцию DISMISSMODLESS , когда пользователь закрывает диалоговое окно безмодерного адреса, информируя клиента, который вызывает сведения о том, что диалоговое окно больше неактивно.
lpvDismissContext
[в] Указатель на контекстную информацию, передаваемую в функцию DISMISSMODELESS , на которую указывает параметр lpfnDismiss . Этот параметр применяется только к версии диалогового окна без режима, включив флаг DIALOG_SDI в параметр ulFlags .
cbEntryID
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID .
lpEntryID
[в] Указатель на идентификатор записи, для которой отображаются сведения.
lpfButtonCallback
[в] Указатель на функцию на основе прототипа функции LPFNBUTTON . Функция LPFNBUTTON добавляет кнопку в диалоговое окно сведений.
lpvButtonContext
[в] Указатель на данные, который использовался в качестве параметра для функции, указанной параметром lpfButtonCallback .
lpszButtonText
[в] Указатель на строку, содержащую текст, применяемый к добавленной кнопке, если эта кнопка расширяема. Если расширяемая кнопка не требуется, параметр lpszButtonText должен иметь значение NULL.
ulFlags
[в] Битовая маска флагов, управляющая типом текста для параметра lpszButtonText . Можно задать следующие флаги:
AB_TELL_DETAILS_CHANGE
Указывает, что details возвращает S_OK, если в адрес действительно внесены изменения; В противном случае функция Details возвращает S_FALSE.
DIALOG_MODAL
Отображение модальной версии диалогового окна "Общий адрес", которое всегда отображается в клиентах, отличных от Outlook. Этот флаг является взаимоисключающим с DIALOG_SDI.
DIALOG_SDI
Отображение нережимой версии диалогового окна "Общий адрес". Этот флаг игнорируется для клиентов, отличных от Outlook.
MAPI_UNICODE
Переданные строки имеют формат Юникода. Если флаг MAPI_UNICODE не задан, строки имеют формат ANSI.
Возвращаемое значение
S_OK
Диалоговое окно сведений было успешно отображено для записи адресной книги.
Замечания
Клиентские приложения вызывают метод Details для отображения диалогового окна с подробными сведениями о конкретной записи в адресной книге. Чтобы добавить в диалоговое окно определяемую клиентом кнопку, можно использовать параметры lpfButtonCallback, lpvButtonContext и lpszButtonText . При нажатии кнопки MAPI вызывает функцию обратного вызова, на которую указывает lpfButtonCallback, передавая идентификатор записи кнопки и данные в lpvButtonContext. Если расширяемая кнопка не требуется, значение lpszButtonText должно иметь значение NULL.
Details поддерживает символьные строки Юникода; Строки Юникода преобразуются в формат многобайтовой символьной строки (MBCS) перед их отображением в диалоговом окне сведений.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| BaseDialog.cpp |
CBaseDialog::OnOpenEntryID |
MFCMAPI использует метод Details для отображения диалогового окна, в котором отображаются сведения о записи адресной книги. |