Freigeben über


COleClientItem::OnChange

Aufgerufen vom Framework, wenn sich der Benutzer ändert, speichert oder schließt das OLE-Element.

virtual void OnChange( 
   OLE_NOTIFICATION nCode, 
   DWORD dwParam  
);

Parameter

  • nCode
    Der Grund der Server geändert hat dieses Element. Es kann einen der folgenden Werte aufweisen:

    • OLE_CHANGED, das die Darstellung des OLE-Elements sich geändert hat.

    • OLE_SAVED das OLE-Element wurde gespeichert.

    • OLE_CLOSED das OLE-Element ist geschlossen.

    • OLE_CHANGED_STATE, das das OLE-Element sich von einem Zustand in einen anderen geändert hat.

  • dwParam
    Wenn nCodeOLE_SAVED oder OLE_CLOSED ist, wird dieser Parameter nicht verwendet. Wenn nCodeOLE_CHANGED ist, enthält dieser Parameter den Aspekt des OLE-Elements an, das geändert wurde. Für mögliche Werte finden Sie im dwParam-Parameter von COleClientItem::Draw. Wenn nCodeOLE_CHANGED_STATE ist, ist dieser Parameter ein COleClientItem::ItemState-Enumerationswert und beschreibt den Zustand, der eingegeben wird. Es kann einen der folgenden Werte aufweisen: emptyState, loadedState, openState, activeState oder activeUIState.

Hinweise

(Wenn die Serveranwendung mit Microsoft Foundation Class-Bibliothek geschrieben, wird diese Funktion in Reaktion auf die Notify-Memberfunktionen von COleServerDoc oder von COleServerItem aufgerufen). Die Standardimplementierung markiert das Containerdokument, wie geändert, wenn nCodeOLE_CHANGED oder OLE_SAVED ist.

Für OLE_CHANGED_STATE ist der aktuelle Zustand, der von GetItemState zurückgegeben wird, noch der alte Zustand und bedeutet den Zustand, der vor dieser Zustandsänderung aktuell war.

Überschreiben Sie diese Funktion, um auf Änderungen im Zustand des OLE-Elements zu reagieren. In der Regel aktualisieren Sie die Darstellung des Elements, indem Sie den Bereich ungültig wird, in dem das Element angezeigt wird. Rufen Sie die Basisklassenimplementierung am Anfang der Überschreibung auf.

Anforderungen

Header: afxole.h

Siehe auch

Referenz

COleClientItem-Klasse

Hierarchiediagramm

COleClientItem::GetItemState

COleServerItem::NotifyChanged

COleServerDoc::NotifyChanged

COleServerDoc::NotifyClosed

COleServerDoc::NotifySaved