IMAPIForm::SetViewContext
适用于：Outlook 2013 | Outlook 2016
为窗体建立视图上下文。
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
参数
pViewContext
[in]指向窗体的新视图上下文的指针。
返回值
S_OK
已成功设置视图上下文。
备注
表单查看者调用 IMAPIForm：：SetViewContext 方法，将特定的表单视图上下文设置为当前。 一个窗体一次只能有一个视图上下文。
针对实现者的说明
大多数表单服务器使用以下算法实现 SetViewContext ：
如果表单的视图上下文已存在，请通过调用 pmnvs 参数中为 null 的 IMAPIViewContext：：SetAdviseSink 方法取消窗体的注册，然后调用视图上下文的 IUnknown：：Release 方法来减少其引用计数。
如果新视图上下文不为 null，请使用 pViewContext 参数调用 IMAPIViewContext：：SetAdviseSink 以设置新的视图建议接收器。
如果新视图上下文不为 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