IOleUndoManager::Open method

Opens a new parent undo unit, which becomes part of its containing unit's undo stack.

Syntax


HRESULT Open(
  [in] IOleParentUndoUnit *pPUU
);

Parameters

pPUU [in]

An IOleParentUndoUnit pointer to the parent undo unit to be opened.

Return value

This method returns S_OK if the parent undo unit was successfully opened or if a currently open unit is blocked. If the undo manager is currently disabled, it will return S_OK and do nothing else.

Remarks

This method is implemented the same as IOleParentUndoUnit::Open. The specified parent unit is created and remains open. The undo manager then calls the IOleUndoManager::Add or IOleUndoManager::Open methods on this parent unit to add new units to it. This parent unit receives any additional undo units until its IOleUndoManager::Close method is called.

The parent unit specified by pPUU is not added to the undo stack until its IOleUndoManager::Close method is called with the fCommit parameter set to TRUE.

The parent undo unit or undo manager must contain any undo unit given to it unless it is blocked. If it is blocked, it must return S_OK but should do nothing else.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OCIdl.h

IDL

OCIdl.idl

IID

IID_IOleUndoManager is defined as D001F200-EF97-11CE-9BC9-00AA00608E01

See also

IOleUndoManager
IOleParentUndoUnit

 

 

Show: