IMAPIFormAdviseSink::OnChange
Hace referencia a: Outlook 2013 | Outlook 2016
Indica que se ha producido un cambio en el estado del visor de formularios.
HRESULT OnChange(
ULONG ulDir
);
Parameters
ulDir
[in] Máscara de bits de marcas que proporciona información sobre el cambio que se ha producido en el visor y la respuesta esperada en el formulario. Se pueden establecer las siguientes marcas:
VCSTATUS_CATEGORY
Hay un mensaje siguiente o anterior en otra categoría.
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 debe ser modal para el visor de formularios.
VCSTATUS_NEXT
Hay un siguiente mensaje en el visor de formularios.
VCSTATUS_PREV
Hay un mensaje anterior en el visor de formularios.
VCSTATUS_READONLY
Las operaciones de eliminación, envío y movimiento deben deshabilitarse.
VCSTATUS_UNREAD
Hay un mensaje no leído siguiente o anterior en el visor de formularios.
Valor devuelto
S_OK
La notificación se realizó correctamente.
Comentarios
Los visores de formularios llaman al método IMAPIFormAdviseSink::OnChange para notificar al formulario sobre un cambio en el estado de un visor. Normalmente, el único cambio es establecer o borrar la marca de VCSTATUS_NEXT o VCSTATUS_PREVIOUS en función de la presencia o ausencia de un mensaje siguiente o anterior en el visor. En consecuencia, el objeto form habilita o deshabilita las acciones siguientes o anteriores que admita.
La configuración de VCSTATUS_MODAL y VCSTATUS_INTERACTIVE no puede cambiar en un contexto de vista una vez creada.
Notas a los implementadores
La implementación específica de este método depende completamente de los detalles del formulario. La mayoría de los objetos de formulario usan este método para cambiar su interfaz de usuario (por ejemplo, para habilitar o deshabilitar comandos de menú o botones para que coincidan con el parámetro de marcas de estado del visor).