IMAPIFormAdviseSink::OnChangeIMAPIFormAdviseSink::OnChange

適用されます: OutlookApplies to: Outlook

フォーム ビューアーのステータスに変更が発生したことを示します。Indicates that a change has occurred in the status of the form viewer.

HRESULT OnChange(
  ULONG ulDir
);

ParametersParameters

ulDirulDir

[in]ビューアーと、フォーム内の予想される応答で発生した変更に関する情報を提供するフラグのビットマスクです。[in] A bitmask of flags that provides information about the change that has occurred in the viewer and the expected response in the form. 次のフラグを設定することができます。The following flags can be set:

VCSTATUS_CATEGORYVCSTATUS_CATEGORY

別のカテゴリで次または前のメッセージが表示されます。There is a next or previous message in another category.

VCSTATUS_INTERACTIVEVCSTATUS_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_MODALVCSTATUS_MODAL

フォームがモーダル フォーム ビューアーに表示します。The form is to be modal to the form viewer.

VCSTATUS_NEXTVCSTATUS_NEXT

フォーム ビューアーに次のメッセージが表示されます。There is a next message in the form viewer.

VCSTATUS_PREVVCSTATUS_PREV

フォーム ビューアーで前のメッセージが表示されます。There is a previous message in the form viewer.

VCSTATUS_READONLYVCSTATUS_READONLY

削除、送信、および移動の操作を無効にする必要があります。Delete, submit, and move operations should be disabled.

VCSTATUS_UNREADVCSTATUS_UNREAD

フォーム ビューアーで次または前の未読メ ッ セージがあります。There is a next or previous unread message in the form viewer.

�߂�lReturn value

S_OKS_OK

通知が正常に完了しました。The notification was successful.

備考Remarks

フォーム ビューアーは、ビューアーのステータスの変更のフォームを通知するためにIMAPIFormAdviseSink::OnChangeメソッドを呼び出します。Form viewers call the IMAPIFormAdviseSink::OnChange method to notify the form about a change in a viewer's status. 通常、唯一の変更は設定か、ビューアー内の次または前のメッセージの有無に基づいて、VCSTATUS_NEXT または VCSTATUS_PREVIOUS フラグをオフにします。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. したがって、フォーム オブジェクトは、有効または、サポートする前または次のアクションを無効にします。Accordingly, the form object then enables or disables any next or previous actions it supports.

VCSTATUS_MODAL と VCSTATUS_INTERACTIVE の設定は、それが作成された後、ビューのコンテキストで変更できません。The settings of VCSTATUS_MODAL and VCSTATUS_INTERACTIVE cannot change in a view context after it has been created.

実装者へのメモNotes to implementers

このメソッドの特定の実装では、フォームの仕様に完全に依存しています。The specific implementation of this method is completely dependent on the specifics of the form. フォームのほとんどのオブジェクトは、独自のユーザー インターフェイス (たとえば、有効にするか、ビューアーのステータス フラグのパラメーターと一致するのにには、メニュー コマンドやボタンを無効にするのに場合など) を変更するのにはこのメソッドを使用します。Most form objects use this method to change their user interface (for example, to enable or disable menu commands or buttons to match the viewer status flags parameter).

関連項目See also

IMAPIViewContext::ActivateNextIMAPIViewContext::ActivateNext

IMAPIFormAdviseSink: IUnknownIMAPIFormAdviseSink : IUnknown