IOleObject::GetExtent メソッド (oleidl.h)

[アーティクル]
08/25/2023

実行中のオブジェクトの現在の表示サイズを取得します。

構文

HRESULT GetExtent(
  [in]  DWORD dwDrawAspect,
  [out] SIZEL *psizel
);

パラメーター

[in] dwDrawAspect

制限が取得されるオブジェクトの側面。値は、列挙体 DVASPECT から取得され、 DVASPECT2から取得されます。最適化された描画インターフェイスをサポートする新しいオブジェクトとコンテナーでは 、DVASPECT2 列挙値がサポートされることに注意してください。最適化された描画インターフェイスをサポートしていない古いオブジェクトとコンテナーは 、DVASPECT2をサポートしていない可能性があります。このメソッドの最も一般的な値は、コンテナー内のオブジェクトの完全なレンダリングを指定するDVASPECT_CONTENTです。

[out] psizel

オブジェクトサイズが返される位置のポインター。

戻り値

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

リターンコード	説明
E_INVALIDARG	指定された dwDrawAspect 値が無効です。

注釈

コンテナーは、実行中のオブジェクトで IOleObject::GetExtent を 呼び出して、現在の表示サイズを取得します。コンテナーがそのサイズに対応できる場合は、通常、コンテナーよりも適切なサイズがオブジェクトによって認識されるためです。コンテナーは通常、オブジェクトの初期化の一環としてこの呼び出しを行います。

IOleObject::GetExtent によって返される表示サイズは、IOleObject::SetExtent によって最後に設定されたサイズとは異なる場合があります。後者のメソッドは、メソッドの呼び出し時にオブジェクトの表示領域を指定しますが、アプリケーションによって決まるオブジェクトのネイティブサイズが必ずしも変更されるとは限りません。

dwAspect で新しい側面の 1 つが要求された場合、このメソッドは失敗するか、DVASPECT_CONTENTのアスペクトと同じ四角形を返すことができます。

メモこのメソッドは、DVASPECT2のすべての新しい側面について、DVASPECT_CONTENTと同じサイズを返す必要があります。 IViewObject2::GetExtent は同じことを行う必要があります。

呼び出し元へのメモ

コンテナーは実行中のオブジェクトに対してのみこの呼び出しを行うことができるため、キャッシュから読み込まれたオブジェクトの表示サイズを取得する場合は、代わりに IViewObject2::GetExtent を呼び出す必要があります。

実装者へのメモ

実装は、sizel 構造体をオブジェクトの高さと幅で埋め込んで構成されます。

要件

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