COleClientItem::OnChange

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

ユーザーが OLE アイテムを変更、保存、閉じたときに、フレームワークが呼び出します。

virtual void OnChange(
   OLE_NOTIFICATION nCode,
   DWORD dwParam 
);

パラメーター

nCode
サーバーがアイテムを変更した理由。次のいずれかの値になります。
- OLE_CHANGED OLE アイテムの外観が変更されました。
- OLE_SAVED OLE アイテムが保存されました。
- OLE_CLOSED OLE アイテムが閉じられました。
- OLE_CHANGED_STATE OLE アイテムが別の状態に変化しました。
dwParam
nCode が OLE_SAVED または OLE_CLOSED のとき、このパラメーターは使われません。 nCode が OLE_CHANGED のときは、このパラメーターは変更された OLE アイテムの外観を指定します。指定する値については、COleClientItem::Draw の dwParam を参照してください。 nCode が OLE_CHANGED_STATE のときは、このパラメーターは COleClientItem::ItemState 列挙値で、変化後の状態を示します。次のいずれかの値を指定できます。emptyState, loadedState, openState, activeState, or activeUIState.

解説

サーバーアプリケーションが MFC ライブラリを使って記述されていると、この関数は COleServerDoc または COleServerItem の Notify メンバー関数に対する応答として呼び出されます。既定の実装では、nCode が OLE_CHANGED または OLE_SAVED だと、コンテナードキュメントが変更されたものとしてマークします。

OLE_CHANGED_STATE では、GetItemState で返される現在の状態は古い状態のままであり、この状態変更の直前の状態を示しています。

OLE アイテムの状態変更に応答するには、この関数をオーバーライドします。一般的には、アイテムが表示されている領域を無効化して、アイテムの外観を更新します。オーバーライドした関数の最初で、基本クラスの実装を呼び出します。