IOleUndoUnit::D o-Methode (ocidl.h)

  • Artikel

Weist die Undo-Einheit an, ihre Aktion auszuführen. Beachten Sie, dass, wenn sie untergeordnete Rückgängigeinheiten enthält, auch deren Do-Methoden aufgerufen werden müssen.

Syntax

HRESULT Do(
  [in] IOleUndoManager *pUndoManager
);

Parameter

[in] pUndoManager

Ein Zeiger auf den Rückgängig-Manager. Siehe IOleUndoManager.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Die Undo-Einheit ist für die Durchführung ihrer Maßnahmen verantwortlich. Das Ausführen einer eigenen Rückgängig-Aktion führt zu einer weiteren Aktion, die möglicherweise rückgängig gemacht werden kann. Wenn pUndoManager jedoch NULL ist, sollte die Rückgängig-Einheit ihre Rückgängig-Aktion ausführen, aber nicht versuchen, etwas auf den Stapel "Wiederholen" oder "Rückgängig" zu setzen.

Wenn pUndoManager nicht NULL ist, ist die Einheit erforderlich, um eine entsprechende Einheit auf den Stapel zum Wiederholen oder Rückgängigieren zu platzieren. Infolgedessen verschiebt sich diese Methode entweder selbst in den Wiederholungs- oder Rückgängigstapel, oder sie erstellt eine neue Rückgängig-Einheit und fügt sie dem entsprechenden Stapel hinzu. Nach dem Erstellen einer neuen Rückgängig-Einheit ruft diese Rückgängig-Einheit IOleUndoManager::Open oder IOleUndoManager::Add auf. Der Rückgängig-Manager legt die neue Rückgängig-Einheit abhängig vom aktuellen Zustand auf den Stapel "Rückgängig" oder "Wiederholen".

Eine übergeordnete Einheit muss denselben Rückgängig-Manager (möglicherweise NULL) an ihre untergeordneten Elemente übergeben, der dem übergeordneten Element zugewiesen wurde. Es ist zulässig, aber nicht erforderlich, wenn pUndoManagerNULL ist, eine übergeordnete Einheit im Stapel "Wiederholen" oder "Rückgängig" zu öffnen, solange kein Commit erfolgt. Eine blockierte übergeordnete Einheit stellt sicher, dass dem Stapel von untergeordneten Einheiten nichts hinzugefügt wird.

Wenn es sich bei dieser Rückgängig-Einheit um eine übergeordnete Einheit handelt, sollte sie sich vor dem Aufrufen der Do-Methode für ihre untergeordneten Elemente auf den Stapel "Wiederholen" oder "Rückgängig" platzieren.

Nach dem Aufrufen dieser Methode muss der Rückgängig-Manager die Undo-Einheit freigeben.

Hinweise zu Implementierern

Auf der IOleUndoManager-Schnittstelle finden Sie Fehlerbehandlungsstrategien für Rückgängig-Einheiten. Die Fehlerbehandlungsstrategie wirkt sich auf die Implementierung dieser Methode aus, insbesondere bei übergeordneten Einheiten.

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

IOleUndoManager::Add

IOleUndoManager::Open

IOleUndoUnit