COleServerItem::OnSetExtent

[アーティクル]
08/09/2011

コンテナードキュメントで利用できる領域の大きさを OLE アイテムに通知するため、フレームワークによって呼び出されます。

virtual BOOL OnSetExtent(
   DVASPECT nDrawAspect,
   const CSize& size 
);

パラメーター

nDrawAspect
境界を指定する OLE アイテムの外観を指定します。このパラメーターには、次のいずれかの値を指定できます。
- DVASPECT_CONTENT コンテナー内で埋め込みオブジェクトとして表示できる方法でアイテムを表します。
- DVASPECT_THUMBNAIL ブラウズツールで表示できる "略図" 表現でアイテムを描画します。
- DVASPECT_ICON アイテムをアイコンで表します。
- DVASPECT_DOCPRINT [ファイル] メニューの [印刷] コマンドを使って印刷した場合のようにアイテムを表します。
size
OLE アイテムの新しいサイズを指定している CSize 構造体へのポインター。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

コンテナーアプリケーションが MFC ライブラリを使って記述されていると、対応する COleClientItem オブジェクトの SetExtent メンバー関数が呼び出されたときに、この関数が呼び出されます。既定の実装では、nDrawAspect が DVASPECT_CONTENT のときに、指定されたサイズを m_sizeExtent メンバーに設定します。アイテムのサイズを変更するときに特別な処理を行いたいときは、この関数をオーバーライドします。