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

ビューがアクティブになる、またはアクティブになるビューポートの四角形の座標を取得します。

構文

HRESULT GetRect(
  [out] LPRECT prcView
);

パラメーター

[out] prcView

IOleDocumentView::SetRect を使用して設定された現在のビューポートの座標を格納する RECT 構造体へのポインター。

戻り値

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

リターン コード	説明
E_UNEXPECTED	このビューでは、 IOleDocumentView::SetRect または IOleDocumentView::SetRectComplex の呼び出しがまだ行われていないため、返される四角形はありません。

解説

単一のドキュメント インターフェイス (SDI) アプリケーションの場合、ビューポートはフレーム ウィンドウのクライアント領域から、ツールバー、ステータス バーなどに割り当てられた領域を差し引いた値です。 マルチ ドキュメント インターフェイス (MDI) ウィンドウの場合、ビューポートは MDI ドキュメント ウィンドウのクライアント領域から他のフレーム レベルのユーザー インターフェイス要素を引いた値です。

このメソッドによって取得されるビューポート座標は、IOleDocumentView::SetRect または IOleDocumentView::SetRectComplex への最新の呼び出しで設定された座標です。

ドキュメント ビューでは、このメソッドを完全に実装する必要があります。E_NOTIMPLは許容される戻り値ではありません。

要件

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

関連項目

IOleDocumentView

IOleDocumentView::SetRect

IOleDocumentView::SetRectComplex