IViewObjectEx::GetRect メソッド (ocidl.h)

要求された描画の側面を記述する四角形を取得します。

構文

HRESULT GetRect(
  [in]  DWORD   dwAspect,
  [out] LPRECTL pRect
);

パラメーター

[in] dwAspect

要求された描画アスペクト。

[out] pRect

要求された描画の側面を説明する四角形へのポインター。

戻り値

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

リターン コード	説明
DV_E_DVASPECT	メソッドは、指定された側面をサポートしていません。 オブジェクトが要求されたアスペクトをサポートしていないか、アスペクトが四角形ではありません。

注釈

このメソッドは、指定した描画面を記述する四角形を返します。 返される四角形は、オブジェクトの原点を基準とした HIMETRIC 単位です。 返される四角形は、次のように描画の側面によって異なります。

描画の縦横比	説明
DVASPECT_CONTENT	オブジェクトは、オブジェクト全体の外接する四角形を返す必要があります。 左上隅はオブジェクトの原点にあり、サイズは IViewObject2::GetExtent によって返されるエクステントと等しくなります。
DVASPECT_OPAQUE	四角形の不透明な領域を持つオブジェクトは、その四角形を返す必要があります。 他のユーザーは失敗し、エラー コードDV_E_DVASPECTを返す必要があります。 四角形が返された場合、その側面に対して IViewObject::D raw を呼び出すことで、完全に隠されていることが保証されます。 コンテナーでは、その四角形を使用して、オブジェクトの不透明な部分をクリップしてから、背後にあるオブジェクトを前方パスに描画する必要があります。 四角形以外の不透明な領域を持つオブジェクトでこのメソッドが失敗した場合、コンテナーは、DVASPECT_CONTENTの側面を使用して、オブジェクト全体を背面から前面に描画する必要があります。
DVASPECT_TRANSPARENT	オブジェクトは、すべての透明または不規則な部分を覆う四角形を返す必要があります。 オブジェクトに透明または不規則な部分がない場合は、DV_E_ASPECTを返す可能性があります。 コンテナーでは、この四角形を使用して、特定のオブジェクトの透明な部分に他のオブジェクトが重なっているかどうかを判断できます。

要件

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

こちらもご覧ください

IViewObjectEx