IMAPIViewContext::GetViewStatus
適用対象: Outlook 2013 | Outlook 2016
現在のビューアーの状態を取得します。
HRESULT GetViewStatus(
ULONG FAR * lpulStatus
);
パラメーター
lpulStatus
[out]ビューアーの状態を提供するフラグのビットマスクへのポインター。 次のフラグを設定できます。
VCSTATUS_CATEGORY
別のカテゴリに次または前のメッセージがあります。
VCSTATUS_DELETE
フォームを使用すると、メッセージを削除できます。
VCSTATUS_INTERACTIVE
フォームにはユーザー インターフェイスが表示されます。 このフラグが設定されていない場合、フォームでは、通常、ユーザー インターフェイスが表示される動詞に応答しても、ユーザー インターフェイスの表示を抑制する必要があります。
VCSTATUS_MODAL
フォームはビューアーにモーダルです。
VCSTATUS_NEXT
ビューに次のメッセージが表示されます。
VCSTATUS_PREV
ビューに前のメッセージがあります。
VCSTATUS_READONLY
メッセージは読み取り専用モードで開きます。 削除、送信、移動の操作は無効にする必要があります。
VCSTATUS_UNREAD
ビューに次または前の未読メッセージが表示されます。
戻り値
S_OK
ビューアーの状態が正常に返されました。
注釈
フォーム オブジェクトは IMAPIViewContext::GetViewStatus メソッドを呼び出して、 フォーム ビューでアクティブ化するメッセージが、次のコマンドによってメッセージをアクティブ化する方向、 前 のコマンドによってメッセージがアクティブ化される方向、またはその両方向にアクティブ化されるメッセージが増えるかどうかを判断します。 lpulStatus パラメーターによって指される値は、VCSTATUS_NEXTフラグとVCSTATUS_PREV フラグが IMAPIViewContext::ActivateNext に対して有効かどうかを判断するために使用されます。 VCSTATUS_DELETE フラグが設定されていても、VCSTATUS_READONLY フラグが設定されていない場合は、 IMAPIMessageSite::D eleteMessage メソッドを使用してメッセージを削除できます。
通常、フォームは、ビューアーのコンテキストに対して有効でない場合、メニュー コマンドとボタンを無効にします。 ビューアーは、 IMAPIFormAdviseSink::OnChange メソッドを呼び出すことによって、フォームに状態の変化を警告できます。
VCSTATUS_MODAL フラグは、以前の IMAPIForm::D oVerb 呼び出しでハンドルが渡されるウィンドウにフォームをモーダルにする必要がある場合に設定されます。 VCSTATUS_MODALが設定されている場合、フォームは、フォームが閉じるまで DoVerb 呼び出しが行われたスレッドを使用できます。 VCSTATUS_MODALが設定されていない場合、フォームはこのウィンドウにモーダルではなく、スレッドを使用しないでください。
MFCMAPI リファレンス
MFCMAPI のサンプル コードについては、次の表を参照してください。
| ファイル | 関数 | コメント |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::GetViewStatus |
MFCMAPI は、この関数に IMAPIViewContext::GetViewStatus メソッドを 実装します。 |