IViewObject2::GetExtent メソッド (oleidl.h)
指定したビュー オブジェクトが指定したターゲット デバイスに描画されるサイズを取得します。
構文
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 で提供される 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 |