IOleUndoUnit-Schnittstelle (ocidl.h)

Dient als Standard-Schnittstelle für eine Rückgängig-Einheit. Eine Rückgängig-Einheit kapselt die Informationen, die zum Rückgängigmachen oder Wiederholen einer einzelnen Aktion erforderlich sind.

Wenn sich der Zustand eines Objekts ändert und es eine Rückgängig-Einheit erstellen muss, muss es zuerst wissen, welche übergeordneten Einheiten geöffnet sind. Es ruft die IOleUndoManager::GetOpenParentState-Methode auf, um dies zu bestimmen. Wenn der Aufruf S_FALSE zurückgibt, gibt es kein aktivierende übergeordnetes Element. Wenn der Aufruf S_OK zurückgibt, aber das flag UAS_NOPARENTENABLE festgelegt ist, ist das geöffnete übergeordnete Element ein deaktiviertes übergeordnetes Element. In beiden Fällen ruft das Objekt IOleUndoManager::D iscardFrom(NULL) für den Rückgängig-Manager auf und überspringt das Erstellen der Rückgängig-Einheit.

Wenn die Methode S_OK zurückgibt, aber das flag UAS_BLOCKED festgelegt ist, ist das geöffnete übergeordnete Element ein blockierendes übergeordnetes Element. Das -Objekt muss keine Rückgängig-Einheit erstellen, da sie sofort verworfen würde. Wenn der Rückgabewert S_OK ist und keines der Bitflags festgelegt ist, erstellt das Objekt die Rückgängig-Einheit und ruft IOleUndoManager::Add im Rückgängig-Manager auf.

Das -Objekt sollte einen Zeiger auf den Rückgängig-Manager beibehalten.

Vererbung

Die IOleUndoUnit-Schnittstelle erbt von der IUnknown-Schnittstelle . IOleUndoUnit verfügt auch über folgende Arten von Membern:

Methoden

Die IOleUndoUnit-Schnittstelle verfügt über diese Methoden.

IOleUndoUnit::D o Weist die Rückgängig-Einheit an, ihre Aktion auszuführen. Beachten Sie, dass, wenn sie untergeordnete Rückgängig-Einheiten enthält, auch deren Do-Methoden aufgerufen werden müssen.
IOleUndoUnit::GetDescription Ruft eine Beschreibung der Rückgängig-Einheit ab, die auf der Benutzeroberfläche zum Rückgängigmachen oder Wiederholen verwendet werden kann.
IOleUndoUnit::GetUnitType Ruft die CLSID und einen Typbezeichner für die Rückgängig-Einheit ab.
IOleUndoUnit::OnNextAdd Benachrichtigt die letzte Rückgängig-Komponente in der Auflistung, dass eine neue Einheit hinzugefügt wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IOleParentUndoUnit

IOleUndoManager