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 |