COleServerDoc::UpdateAllItems

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ドキュメントが変更されたことをドキュメントに接続されているすべてのリンクアイテムに通知します。

void UpdateAllItems(
   COleServerItem* pSender,
   LPARAM lHint = 0L,
   CObject* pHint = NULL,
   DVASPECT nDrawAspect = DVASPECT_CONTENT 
);

パラメータ

pSender
ドキュメントを変更するアイテムへのポインタ。すべてのアイテムを更新するときは NULL を指定します。
lHint
変更に関する情報を指定します。
pHint
変更に関する情報が格納されているオブジェクトへのポインタ。
nDrawAspect
アイテムがどのように描画されるかを指定します。これは、列挙子 DVASPECT の値です。このパラメータには、次のいずれかの値を指定できます。
- DVASPECT_CONTENT コンテナ内で埋め込みオブジェクトとして表示できる方法でアイテムを表します。
- DVASPECT_THUMBNAIL ブラウズツールで表示できる "略図" 表現でアイテムを描画します。
- DVASPECT_ICON アイテムをアイコンで表します。
- DVASPECT_DOCPRINT [ファイル] メニューの [印刷] コマンドを使って印刷した場合のようにアイテムを表します。

解説

一般的には、ユーザーがサーバードキュメントを変更した後この関数を呼び出します。OLE アイテムが自動リンクでドキュメントにリンクされていると、アイテムは更新されて変更を反映します。MFC ライブラリを使って記述されたコンテナアプリケーションでは、COleClientItem の OnChange メンバ関数が呼び出されます。

この関数は、通知したアイテムを除いたドキュメントアイテムのそれぞれの OnUpdate メンバ関数を pHint、lHint、nDrawAspect をパラメータとして呼び出します。ドキュメントに対して行われた変更についての情報をアイテムに渡すため、これらのパラメータを使います。lHint を使って情報のコード化ができます。または、変更についての情報を格納する CObject の派生クラスを定義し、pHint を使ってこのクラスのオブジェクトを渡すことができます。アイテムのプレゼンテーションが変更されたかどうかによって各アイテムの更新を最適化するには、COleServerItem の派生クラスの OnUpdate メンバ関数をオーバーライドします。