IOleUndoUnit::OnNextAdd 方法 (ocidl.h)

通知集合中的最后一个撤消单元已添加新单元。

语法

HRESULT OnNextAdd();

返回值

此方法的实现始终返回S_OK。 HRESULT 返回类型仅用于可远程性。

注解

对象可以为操作创建撤消单元并将其添加到撤消管理器,但可以继续通过专用接口将数据插入其中。 当撤消单元收到对此方法的调用时,它会将上下文已更改的创建对象传达回该对象。 然后,创建对象停止将数据插入撤消单元。

父撤消单元在其最近添加的子撤消单元上调用此方法,以通知子单元上下文已更改,并添加了新的撤消单元。

例如,此方法用于支持模糊操作(如键入),这些操作没有明确的终止点,而是仅在发生其他情况时才终止。

如果撤消管理器或打开的父单元选择通过调用 IUnknown::Release 来放弃该单元,则可能不会始终调用此方法。 通过专用接口将数据馈送给后台撤消单元的任何连接都不应对撤消单元进行 IUnknown::AddRef

实施者说明

请注意,父单元仅将此方法委托给最近添加的子单元。 父单元在关闭时应通过任何专用接口终止通信。 父单元在收到调用 IOleParentUndoUnit::Close S_FALSE时知道它正在关闭。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 ocidl.h

另请参阅

IOleParentUndoUnit::Close

IOleUndoUnit