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

[アーティクル]
03/15/2023

オブジェクトのコンテナーから、ユーザーがオブジェクトのサイズを変更するときに使用するサイズ設定のヒントを提供します。

構文

HRESULT GetNaturalExtent(
  [in]  DWORD          dwAspect,
  [in]  LONG           lindex,
  [in]  DVTARGETDEVICE *ptd,
  [in]  HDC            hicTargetDev,
  [in]  DVEXTENTINFO   *pExtentInfo,
  [out] LPSIZEL        pSizel
);

パラメーター

[in] dwAspect

要求された描画の側面。 DVASPECT 列挙によって定義される次の値のいずれかを指定できます。

値	説明
DVASPECT_CONTENT	コンテナー内の埋め込みオブジェクトとして表示できるように、コントロールの表現を指定します。この値は通常、複合ドキュメントオブジェクトに指定されます。この表示形式は、画面またはプリンターに対して指定できます。
DVASPECT_DOCPRINT	[ファイル] メニューの [印刷] コマンドを使用してプリンターに印刷されたかのように、画面上のコントロールの表現を指定します。記述されるデータでページのシーケンスを表現できます。
DVASPECT_ICON	コントロールの象徴的な表現を提供します。
DVASPECT_THUMBNAIL	オブジェクトを参照ツールで表示できるように、オブジェクトのサムネイル表示を指定します。サムネイルは約 120 x 120 ピクセルで、メタファイルにラップされる可能性がある 16 色 (推奨) のデバイスに依存しないビットマップです。

[in] lindex

描画操作の対象となるオブジェクトの部分を示します。その解釈は、 dwAspect パラメーターの値によって異なります。詳細については、 DVASPECT 列挙を参照してください。

[in] ptd

オブジェクトがレンダリングされるデバイスを記述するターゲットデバイス構造へのポインター。 NULL の場合は、既定のターゲットデバイス (通常は表示) に対してビューをレンダリングする必要があります。 NULL 以外の値は、hicTargetDev および hdcDraw と組み合わせて解釈されます。たとえば、 hdcDraw で プリンターがデバイスコンテキストとして指定されている場合、 ptd パラメーターはそのプリンターデバイスを記述する構造体を指します。 hicTargetDev が有効な値である場合は、データが実際に印刷される場合があります。また、hicTargetDev が NULL の場合は印刷プレビューモードで表示される場合があります。

[in] hicTargetDev

オブジェクトがデバイスメトリックを抽出し、デバイスの機能をテストできる ptd パラメーターによって示されるターゲットデバイスの情報コンテキストを指定します。 ptd が NULL の場合。オブジェクトは hicTargetDev パラメーターの値を無視する必要があります。

[in] pExtentInfo

サイズ設定データを指定する DVEXTENTINFO 構造体へのポインター。

[out] pSizel

オブジェクトによって返されるサイズ変更データへのポインター。返されるサイズ変更データは、調整されなかったディメンションに対して -1 に設定されます。つまり 、cx が -1 の場合、幅は調整されませんでした。 cy が -1 の場合、高さは調整されませんでした。サイズが調整されていないことを示すE_FAILが返された場合、 pSizel は NULL になる可能性があります。

戻り値

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

リターンコード	説明
E_FAIL	このメソッドは、指定した dwAspect に対して実装されていないか、サイズが調整されていません。
E_NOTIMPL	このメソッドは実装されませんでした。

解説

コントロールのサイズを変更するには、2 つの一般的な方法があります。最初のアプローチでは、サイズ設定自体を制御する責任があります。2 つ目の方法では、コントロールのサイズを変更するコンテナーの責任が与えられます。最初のアプローチは、自動サイズ設定と呼ばれます。 2 つ目の方法には、コンテンツのサイズ設定と整数のサイズ設定という 2 つの選択肢があります。

IViewObjectEx::GetNaturalExtent メソッドは、コンテンツと整数のサイズ設定の両方をサポートしています。コンテンツのサイズ設定では、コンテナーは DVEXTENTINFO 構造体をオブジェクトに渡し、オブジェクトが推奨サイズを返します。整数サイズ設定では、コンテナーは DVEXTENTINFO 内のオブジェクトに優先サイズを渡し、オブジェクトは実際にその高さを調整します。整数サイズ設定は、ユーザーがデザインモードで新しいサイズをラバーバンドするときに使用されます。

自動サイズ設定は、通常、Autosize プロパティが有効で、関連するテキストが変更された場合にサイズを変更する Label コントロールなどのオブジェクトで発生します。自動サイズ設定は、オブジェクトの状態によって異なる方法で処理されます。

オブジェクトが非アクティブな場合は、次の処理が行われます。

オブジェクトは IOleClientSite::RequestNewObjectLayout を呼び出します。
コンテナーは IOleObject::GetExtent を呼び出し、新しいエクステントを取得します。
コンテナーは IOleObject::SetExtent を呼び出し、新しいエクステントを調整します。

オブジェクトがアクティブな場合は、次の処理が行われます。

オブジェクトは IOleInPlaceSite::OnPosRectChange を呼び出して、サイズ変更が必要であることを指定します。
コンテナーは IOleInPlaceObject::SetObjectRects を呼び出し、新しいサイズを指定します。

要件


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

次の方法で共有

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

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース