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

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

指定したビューオブジェクトが指定したターゲットデバイスに描画されるサイズを取得します。

構文

HRESULT GetExtent(
  [in]  DWORD          dwDrawAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [out] LPSIZEL        lpsizel
);

パラメーター

[in] dwDrawAspect

要求と一致するサイズを持つオブジェクトのビュー。指定できる値は、 DVASPECT 列挙体と DVASPECT2 列挙体から取得されます。最適化された描画インターフェイスをサポートする新しいオブジェクトとコンテナーでは 、DVASPECT2 列挙値がサポートされることに注意してください。最適化された描画インターフェイスをサポートしていない古いオブジェクトとコンテナーは 、DVASPECT2をサポートしていない可能性があります。

[in] lindex

目的のオブジェクトの部分。現時点では、使用可能な値は -1 のみです。

[in] ptd

オブジェクトのサイズを返すターゲットデバイスを定義する DVTARGETDEVICE 構造体へのポインター。

[out] lpsizel

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

戻り値

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

リターンコード	説明
OLE_E_BLANK	適切なキャッシュは使用できません。

注釈

OLE で提供される IViewObject2::GetExtent の実装では、キャッシュでビューオブジェクトのサイズが検索されます。

IOleObject インターフェイスの IOleObject::GetExtent メソッドは、IViewObject2::GetExtent と同じ情報の一部を提供します。

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

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

呼び出し元へのメモ

オブジェクトがまだ実行されていない場合に実行されないようにするには、IOleObject::GetExtent ではなく IViewObject2::GetExtent を呼び出して、描画するプレゼンテーションのサイズを決定します。

要件

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