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

  • [アーティクル]

ビューポート、スクロール バー、サイズ ボックスの四角形の座標を設定します。

構文

HRESULT SetRectComplex(
  [in] LPRECT prcView,
  [in] LPRECT prcHScroll,
  [in] LPRECT prcVScroll,
  [in] LPRECT prcSizeBox
);

パラメーター

[in] prcView

ビューポートの座標を含む RECT 構造体へのポインター。

[in] prcHScroll

水平スクロール バーの座標を含む RECT 構造体へのポインター。

[in] prcVScroll

垂直スクロール バーの座標を含む RECT 構造体へのポインター。

[in] prcSizeBox

サイズ ボックスの座標を含む RECT 構造体へのポインター。

戻り値

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

リターン コード 説明
E_FAIL
 操作が失敗しました。
E_NOTIMPL
 このビューを所有するドキュメント オブジェクトは、複雑な四角形をサポートしていません。

注釈

1 つのドキュメントが複数のシートまたはページで構成されるブックメタファーをサポートするフレームを表示します。通常、このメソッドを呼び出して、すべてのシートまたはページで共通に使用される座標を設定します。

呼び出し元へのメモ

IOleDocumentView::SetRectComplex の呼び出しは、複雑な四角形をサポートするドキュメント オブジェクトの通常のアクティブ化シーケンスの一部であり、通常は IOleDocumentView::UIActivate の呼び出しに続き、IOleDocumentView::Show の呼び出しの前に続きます。

ドキュメント オブジェクトの表示に使用されるウィンドウのサイズが変更されるたびに、コンテナーは IOleDocumentView::SetRectComplex または IOleDocumentView::SetRect を呼び出して、ビュー オブジェクトに新しいウィンドウ サイズに合わせてサイズを変更するように指示する必要があります。

実装者へのメモ

複雑な四角形をサポートするドキュメント オブジェクトは、DOCMISC と IOleDocument::GetDocMiscStatus で説明されているように、DOCMISC_SUPPORTCOMPLEXRECTANGLES でマークされます。 このメソッドをサポートしていないドキュメント オブジェクトは、E_NOTIMPLを返すことができます。

このメソッドの呼び出しを受け取ると、ビューは prcView で指定された座標に合わせてサイズを変更し、そのスクロール バーとサイズ ボックスを prcHScroll、 prcVScroll、 および prcSizeBox で説明されている領域に合わせる必要があります。

このメソッドは [input_sync] 属性を使用して定義されます。つまり、実装するオブジェクトは、このメソッドの実行中に、INPUT_SYNC以外の RPC 呼び出しを生成したり、実行したりすることはできません。

要件

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

こちらもご覧ください

IOleDocument::GetDocMiscStatus

IOleDocumentView