COleServerDoc::UpdateAllItems
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
将项显示为就好象是在利用File菜单中的Print命令打印它。
说明:
此函数将文档改变了的信息通知给连接在此文档上的所有链接项。应用程序一般在用户改变服务器文档之后调用这个函数。如果一个OLE项以一个自动链接链接到此文档上,则该项被更新以反映这些变化。在用微软基础类库编写的容器应用程序中,将调用COleClientItem的OnChange成员函数。
除了发送项外,UpdateAllItems函数为文档的每个项调用OnUpdate成员函数,传递pHint,lHint和nDrawAspect参数。利用这些参数将有关对文档所做修改的信息传递给各个项。应用程序可以利用lHint对信息进行编码,或者定义一个CObject派生类来存储有关修改的信息并用pHint传递一个该类的对象。可在应用程序的COleServerItem派生类中重载OnUpdate成员函数,根据每个项的显示是否改变了来优化对各个项的更新。
请参阅:
COleServerDoc::NotifyChanged
,
COleServerItem::OnUpdate
,
COleServerDoc::NotifySaved
,
COleClientItem::OnChange