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

[アーティクル]
02/28/2024

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

構文

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

Share via