IMAPIForm::SetViewContext
Область применения: Outlook 2013 | Outlook 2016
Устанавливает контекст представления для формы.
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
Параметры
pViewContext
[в] Указатель на новый контекст представления для формы.
Возвращаемое значение
S_OK
Контекст представления настроен успешно.
Замечания
Средства просмотра форм вызывают метод IMAPIForm::SetViewContext , чтобы установить контекст представления формы как текущий. Форма может иметь только один контекст представления за раз.
Примечания для исполнителей
Большинство серверов форм реализуют SetViewContext с помощью следующего алгоритма:
Если контекст представления для формы уже существует, отмените регистрацию формы, вызвав метод IMAPIViewContext::SetAdviseSink с null в параметре pmnvs , а затем вызовите метод IUnknown::Release контекста представления для уменьшения числа ссылок.
Если контекст нового представления не имеет значения NULL, вызовите IMAPIViewContext::SetAdviseSink с помощью параметра pViewContext для настройки нового приемника рекомендаций представления.
Если новый контекст представления не имеет значения NULL, вызовите метод IMAPIViewContext::GetViewStatus , чтобы определить, какие флаги состояния были установлены.
Если новый контекст представления не имеет значения NULL, сохраните его и вызовите метод IUnknown::AddRef , чтобы увеличить количество ссылок.
Обновите все элементы пользовательского интерфейса, зависящие от контекста представления.
В зависимости от флагов состояния, возвращенных IMAPIViewContext::GetViewStatus, SetViewContext может также выполнять другие действия. Например, если возвращаются флаги VCSTATUS_NEXT и VCSTATUS_PREV, SetViewContext может включить кнопки Далее и Назад для нового контекста представления.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI использует метод IMAPIForm::SetViewContext для задания контекста представления MFCMAPI в форме перед отображением формы. |
См. также
IMAPIViewContext::GetViewStatus