IMAPIViewContext::GetViewStatus
Область применения: Outlook 2013 | Outlook 2016
Извлекает текущее состояние средства просмотра.
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
Параметры
lpulStatus
[out] Указатель на битовую маску флагов, обеспечивающих состояние средства просмотра. Можно задать следующие флаги:
VCSTATUS_CATEGORY
Есть следующее или предыдущее сообщение в другой категории.
VCSTATUS_DELETE
Форма позволяет удалять сообщения.
VCSTATUS_INTERACTIVE
В форме должен отображаться пользовательский интерфейс. Если этот флаг не задан, форма должна подавлять отображение пользовательского интерфейса даже в ответ на команду, которая обычно вызывает отображение пользовательского интерфейса.
VCSTATUS_MODAL
Форма является модальной для средства просмотра.
VCSTATUS_NEXT
В представлении появится следующее сообщение.
VCSTATUS_PREV
В представлении есть предыдущее сообщение.
VCSTATUS_READONLY
Сообщение должно быть открыто в режиме только для чтения. Операции удаления, отправки и перемещения должны быть отключены.
VCSTATUS_UNREAD
В представлении есть следующее или предыдущее непрочитанное сообщение.
Возвращаемое значение
S_OK
Состояние средства просмотра было успешно возвращено.
Замечания
Объекты формы вызывают метод IMAPIViewContext::GetViewStatus , чтобы определить, есть ли больше сообщений для активации в представлении формы в любом или обоих направлениях, то есть в направлении, в котором команда Next активирует сообщения, в направлении, в котором команда Previous активирует сообщения, или в обоих направлениях. Значение, на которое указывает параметр lpulStatus , используется для определения допустимости флагов VCSTATUS_NEXT и VCSTATUS_PREV для IMAPIViewContext::ActivateNext. Если установлен флаг VCSTATUS_DELETE, но не флаг VCSTATUS_READONLY, сообщение можно удалить с помощью метода IMAPIMessageSite::D eleteMessage .
Как правило, формы отключают команды меню и кнопки, если они недопустимы для контекста средства просмотра. Средство просмотра может предупредить форму об изменении состояния, вызвав ее метод IMAPIFormAdviseSink::OnChange .
Флаг VCSTATUS_MODAL устанавливается, если форма должна быть модальной для окна, дескриптор которого передается в предыдущем вызове IMAPIForm::D oVerb . Если задано VCSTATUS_MODAL, форма может использовать поток, в котором был выполнен вызов DoVerb , пока форма не закроется. Если VCSTATUS_MODAL не задано, форма не должна быть модальной для этого окна и не должна использовать поток.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetViewStatus |
MFCMAPI реализует метод IMAPIViewContext::GetViewStatus в этой функции. |