IMAPIFormAdviseSink::OnChange

The IMAPIFormAdviseSink::OnChange method notifies a form object about a change in a form viewer s status.

Quick Info

See IMAPIFormAdviseSink : IUnknown1PBDFMN.

HRESULT OnChange(

Parameters

ulDir

[in] Bitmask of flags that controls handling changes to the form viewer s status. The following flags can be set:

VCSTATUS_INTERACTIVE

The form should display a user interface. If this flag is not set, the form should suppress displaying a user interface even in response to a verb that usually causes a user interface to be displayed.

VCSTATUS_MODAL

The form is to be modal to the form viewer.

VCSTATUS_NEXT

There is a next message in the form viewer.

VCSTATUS_PREV

There is a previous message in the form viewer.

VCSTATUS_READONLY

Delete, submit, and move operations should be disabled.

Return Values

S_OK

The call succeeded and has returned the expected value or values.

Remarks

Form viewers call the IMAPIFormAdviseSink::OnChange method to notify the form object about a change in a viewer s status. Usually, the only change is setting or clearing the VCSTATUS_NEXT or VCSTATUS_PREVIOUS flag based on the presence or absence of a next or previous message in the viewer. The form object then enables or disables any next or previous actions it supports accordingly.

The settings of VCSTATUS_MODAL and VCSTATUS_INTERACTIVE cannot change in a view context once it has been created.

See Also