IMAPIForm::SetViewContext
Hace referencia a: Outlook 2013 | Outlook 2016
Establece un contexto de vista para el formulario.
HRESULT SetViewContext(
LPMAPIVIEWCONTEXT pViewContext
);
Parameters
pViewContext
[in] Puntero al nuevo contexto de vista del formulario.
Valor devuelto
S_OK
El contexto de vista se ha establecido correctamente.
Comentarios
Los visores de formularios llaman al método IMAPIForm::SetViewContext para establecer un contexto de vista de formulario determinado como actual. Un formulario solo puede tener un contexto de vista a la vez.
Notas a los implementadores
La mayoría de los servidores de formulario implementan SetViewContext mediante el algoritmo siguiente:
Si ya existe un contexto de vista para el formulario, cancele el registro del formulario llamando al método IMAPIViewContext::SetAdviseSink con null en el parámetro pmnvs y, a continuación, llame al método IUnknown::Release del contexto de vista para reducir su recuento de referencias.
Si el nuevo contexto de vista no es null, llame a IMAPIViewContext::SetAdviseSink mediante el parámetro pViewContext para configurar un nuevo receptor de aviso de vista.
Si el nuevo contexto de vista no es null, llame al método IMAPIViewContext::GetViewStatus para determinar qué marcas de estado se han establecido.
Si el nuevo contexto de vista no es null, almacénelo y llame a su método IUnknown::AddRef para incrementar su recuento de referencias.
Actualice los elementos de la interfaz de usuario que dependan del contexto de vista.
En función de las marcas de estado devueltas por IMAPIViewContext::GetViewStatus, SetViewContext también puede realizar otras acciones. Por ejemplo, si se devuelven las marcas VCSTATUS_NEXT y VCSTATUS_PREV, SetViewContext puede habilitar los botones Siguiente y Anterior para el nuevo contexto de vista.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
MFCMAPI usa el método IMAPIForm::SetViewContext para establecer el contexto de vista de MFCMAPI en el formulario antes de que se muestre el formulario. |
Vea también
IMAPIViewContext::GetViewStatus