IMAPIViewContext::GetViewStatus
Hace referencia a: Outlook 2013 | Outlook 2016
Recupera el estado actual del visor.
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
Parameters
lpulStatus
[out] Puntero a una máscara de bits de marcas que proporcionan el estado del visor. Se pueden establecer las siguientes marcas:
VCSTATUS_CATEGORY
Hay un mensaje siguiente o anterior en otra categoría.
VCSTATUS_DELETE
El formulario permite quitar mensajes.
VCSTATUS_INTERACTIVE
El formulario debe mostrar una interfaz de usuario. Si no se establece esta marca, el formulario debe suprimir la visualización de una interfaz de usuario incluso en respuesta a un verbo que normalmente hace que se muestre una interfaz de usuario.
VCSTATUS_MODAL
El formulario es modal para el visor.
VCSTATUS_NEXT
Hay un mensaje siguiente en la vista.
VCSTATUS_PREV
Hay un mensaje anterior en la vista.
VCSTATUS_READONLY
El mensaje se va a abrir en modo de solo lectura. Las operaciones de eliminación, envío y movimiento deben deshabilitarse.
VCSTATUS_UNREAD
Hay un mensaje no leído siguiente o anterior en la vista.
Valor devuelto
S_OK
El estado del visor se devolvió correctamente.
Comentarios
Los objetos Form llaman al método IMAPIViewContext::GetViewStatus para determinar si hay más mensajes que activar en una vista de formulario en ambas direcciones o en la dirección en la que un comando Siguiente activa los mensajes, en la dirección en la que un comando Anterior activa los mensajes o en ambas direcciones. El valor al que apunta el parámetro lpulStatus se usa para determinar si las marcas VCSTATUS_NEXT y VCSTATUS_PREV son válidas para IMAPIViewContext::ActivateNext. Si se establece la marca de VCSTATUS_DELETE, pero no la marca VCSTATUS_READONLY, el mensaje se puede eliminar mediante el método IMAPIMessageSite::D eleteMessage .
Normalmente, los formularios deshabilitan los comandos de menú y los botones si no son válidos para el contexto del visor. Un visor puede alertar a un formulario de un cambio de estado llamando a su método IMAPIFormAdviseSink::OnChange .
La marca VCSTATUS_MODAL se establece si el formulario debe ser modal a la ventana cuyo identificador se pasa en la llamada IMAPIForm::D oVerb anterior. Si se establece VCSTATUS_MODAL, el formulario puede usar el subproceso en el que se realizó la llamada a DoVerb hasta que se cierre el formulario. Si no se establece VCSTATUS_MODAL, el formulario no debe ser modal a esta ventana y no debe usar el subproceso.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetViewStatus |
MFCMAPI implementa el método IMAPIViewContext::GetViewStatus en esta función. |