IOleUndoUnit::OnNextAdd-Methode (ocidl.h)

  • Artikel

Benachrichtigt die letzte Rückgängig-Komponente in der Auflistung, dass eine neue Einheit hinzugefügt wurde.

Syntax

HRESULT OnNextAdd();

Rückgabewert

Implementierungen dieser Methode geben immer S_OK zurück. Der HRESULT-Rückgabetyp wird nur für die Remotability verwendet.

Hinweise

Ein -Objekt kann eine Rückgängig-Einheit für eine Aktion erstellen und sie dem Rückgängig-Manager hinzufügen, kann aber weiterhin Daten über private Schnittstellen einfügen. Wenn die Undo-Einheit einen Aufruf dieser Methode empfängt, kommuniziert sie an das erstellende Objekt, dass sich der Kontext geändert hat. Anschließend beendet das erstellende Objekt das Einfügen von Daten in die Undo-Einheit.

Die übergeordnete Undo-Einheit ruft diese Methode auf der zuletzt hinzugefügten untergeordneten Undo-Einheit auf, um die untergeordnete Einheit darüber zu benachrichtigen, dass sich der Kontext geändert hat und eine neue Rückgängig-Einheit hinzugefügt wurde.

Diese Methode wird beispielsweise zur Unterstützung von Fuzzy-Aktionen wie der Eingabe verwendet, die keinen eindeutigen Abschlusspunkt aufweisen, sondern nur beendet werden, wenn etwas anderes geschieht.

Diese Methode wird möglicherweise nicht immer aufgerufen, wenn der Rückgängig-Manager oder eine geöffnete übergeordnete Einheit die Einheit verwerfen möchte, indem stattdessen IUnknown::Release aufgerufen wird. Jede Verbindung, die Daten im Hintergrund über private Schnittstellen an die Rückgängig-Einheit weitergibt, sollte nicht IUnknown::AddRef the undo unit verwenden.

Hinweise zu Implementierern

Beachten Sie, dass übergeordnete Einheiten diese Methode lediglich an ihre zuletzt hinzugefügte untergeordnete Einheit delegieren. Eine übergeordnete Einheit sollte die Kommunikation über alle privaten Schnittstellen beenden, wenn sie geschlossen ist. Eine übergeordnete Einheit weiß, dass sie geschlossen wird, wenn sie S_FALSE vom Aufruf von IOleParentUndoUnit::Close empfängt.

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::Close

IOleUndoUnit