IOleDocumentView::Show メソッド (docobj.h)

[アーティクル]
03/05/2024

ビューをアクティブ化または非アクティブ化します。

構文

HRESULT Show(
  [in] BOOL fShow
);

パラメーター

[in] fShow

TRUE の場合、ビューはそれ自体を表示します。 FALSE の場合、ビューはそれ自体を非表示にします。

戻り値

このメソッドは、成功したS_OKを返します。その他の可能な戻り値は次のとおりです。

リターンコード	説明
E_FAIL	操作が失敗しました。
E_OUTOFMEMORY	操作に使用できるメモリが不足しています。
E_UNEXPECTED	予期しないエラーが発生しました。

注釈

Show の呼び出しはアクティブ化シーケンスの最後の手順です。これは、ドキュメントオブジェクトを表示する前に、そのオブジェクトが占有する領域を正確に把握し、そのすべてのツールを使用できるようにする必要があるためです。

呼び出し元へのメモ

ビューをアクティブ化するためにこのメソッドを呼び出すには、 IOleDocumentView::SetInPlaceSite、 IOleDocumentView::UIActivate、および IOleDocumentView::SetRect (または IOleDocumentView::SetRectComplex) の呼び出しに従う必要があります。

実装者へのメモ

このメソッドの実装は、次の擬似コードを具体化する必要があります。

if (fShow)
    {
    In-place activate the view but do not UI activate it.
    Show the view window. 
    }
else
    {
    Call IOleDocumentView::UIActivate(FALSE) on this view
    Hide the view window
    }

ドキュメントオブジェクトのすべてのビューでは、少なくともインプレースアクティブ化をサポートする必要があります。E_NOTIMPLは許容される値ではありません。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	docobj.h