IOleObject::GetExtent メソッド (oleidl.h)
実行中のオブジェクトの現在の表示サイズを取得します。
構文
HRESULT GetExtent(
[in] DWORD dwDrawAspect,
[out] SIZEL *psizel
);
パラメーター
[in] dwDrawAspect
制限が取得されるオブジェクトの側面。値は、列挙 体 DVASPECT から取得され、 DVASPECT2から取得されます。 最適化された描画インターフェイスをサポートする新しいオブジェクトとコンテナーでは 、DVASPECT2 列挙値がサポートされることに注意してください。 最適化された描画インターフェイスをサポートしていない古いオブジェクトとコンテナーは 、DVASPECT2をサポートしていない可能性があります。 このメソッドの最も一般的な値は、コンテナー内のオブジェクトの完全なレンダリングを指定するDVASPECT_CONTENTです。
[out] psizel
オブジェクト サイズが返される位置のポインター。
戻り値
このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
指定された dwDrawAspect 値が無効です。 |
注釈
コンテナーは、実行中のオブジェクトで IOleObject::GetExtent を 呼び出して、現在の表示サイズを取得します。 コンテナーがそのサイズに対応できる場合は、通常、コンテナーよりも適切なサイズがオブジェクトによって認識されるためです。 コンテナーは通常、オブジェクトの初期化の一環としてこの呼び出しを行います。
IOleObject::GetExtent によって返される表示サイズは、IOleObject::SetExtent によって最後に設定されたサイズとは異なる場合があります。後者のメソッドは、メソッドの呼び出し時にオブジェクトの表示領域を指定しますが、アプリケーションによって決まるオブジェクトのネイティブ サイズが必ずしも変更されるとは限りません。
dwAspect で新しい側面の 1 つが要求された場合、このメソッドは失敗するか、DVASPECT_CONTENTのアスペクトと同じ四角形を返すことができます。
呼び出し元へのメモ
コンテナーは実行中のオブジェクトに対してのみこの呼び出しを行うことができるため、キャッシュから読み込まれたオブジェクトの表示サイズを取得する場合は、代わりに IViewObject2::GetExtent を呼び出す必要があります。実装者へのメモ
実装は、sizel 構造体をオブジェクトの高さと幅で埋め込んで構成されます。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | oleidl.h |