CDocObjectServerItem-Klasse
Implementiert OLE-Serververben speziell für DocObject-Server.
Syntax
class CDocObjectServerItem : public COleServerItem
Member
Geschützte Konstruktoren
| Name | Beschreibung |
|---|---|
| CDocObjectServerItem::CDocObjectServerItem | Erstellt ein CDocObjectServerItem-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CDocObjectServerItem::GetDocument | Ruft einen Zeiger auf das Dokument ab, das das Element enthält. |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CDocObjectServerItem::OnDoVerb | Wird aufgerufen, um ein Verb auszuführen. |
| CDocObjectServerItem::OnHide | Löst eine Ausnahme aus, wenn das Framework versucht, ein DocObject-Element auszublenden. |
| CDocObjectServerItem::OnShow | Wird vom Framework aufgerufen, um das DocObject-Element aktiv zu machen. Wenn das Element kein DocObject ist, ruft COleServerItem::OnShow auf. |
Hinweise
CDocObjectServerItem definiert überschreibbare Memberfunktionen: OnHide, OnDoVerb und OnShow.
Um dies zu verwenden CDocObjectServerItem, stellen Sie sicher, dass die OnGetEmbeddedItem-Überschreibung in Der COleServerDocabgeleiteten Klasse ein neues CDocObjectServerItem Objekt zurückgibt. Wenn Sie funktionen in Ihrem Element ändern müssen, können Sie eine neue Instanz ihrer eigenen CDocObjectServerItemabgeleiteten Klasse erstellen.
Weitere Informationen zu DocObjects finden Sie unter CDocObjectServer und COleCmdUI in der MFC-Referenz.
Vererbungshierarchie
CDocObjectServerItem
Anforderungen
Kopfzeile: afxdocob.h
CDocObjectServerItem::CDocObjectServerItem
Erstellt ein CDocObjectServerItem-Objekt.
CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);
Parameter
pServerDoc
Ein Zeiger auf das Dokument, das das neue DocObject-Element enthält.
bAutoDelete
Gibt an, ob das Objekt gelöscht werden kann, wenn ein Link zu dem Objekt freigegeben wird. Legen Sie das Argument auf FALSE fest, wenn das CDocObjectServerItem Objekt ein integraler Bestandteil der Daten Ihres Dokuments ist. Legen Sie es auf TRUE fest, wenn es sich bei dem Objekt um eine sekundäre Struktur handelt, die verwendet wird, um einen Bereich in den Daten Ihres Dokuments zu identifizieren, die vom Framework gelöscht werden können.
CDocObjectServerItem::GetDocument
Ruft einen Zeiger auf das Dokument ab, das das Element enthält.
COleServerDoc* GetDocument() const;
Rückgabewert
Ein Zeiger auf das Dokument, das das Element enthält; NULL, wenn das Element nicht Teil eines Dokuments ist.
Hinweise
Dies ermöglicht den Zugriff auf das Serverdokument, das Sie als Argument an den CDocObjectServerItem-Konstruktor übergeben haben.
CDocObjectServerItem::OnDoVerb
Vom Framework aufgerufen, um das angegebene Verb auszuführen.
virtual void OnDoVerb(LONG iVerb);
Parameter
iVerb
Gibt das auszuführende Verb an. Mögliche Werte finden Sie unter "IOleObject::D oVerb " im Windows SDK.
Hinweise
Die Standardimplementierung ruft die OnShow-Memberfunktion auf, wenn das Element ein DocObject ist und das OLEIVERB_INPLACEACTIVATE oder OLEIVERB_SHOW angegeben ist. Wenn das Element kein DocObject oder ein anderes Verb angegeben ist, ruft die Standardimplementierung COleServerItem::OnDoVerb auf.
CDocObjectServerItem::OnHide
Wird vom Framework aufgerufen, um das Element auszublenden.
virtual void OnHide();
Hinweise
Die Standardimplementierung löst eine Ausnahme aus, wenn es sich bei dem Element um ein DocObject handelt. Sie können ein aktives DocObject-Element nicht ausblenden, da es die gesamte Ansicht akzeptiert. Sie müssen das DocObject-Element deaktivieren, damit es ausgeblendet wird. Wenn das Element kein DocObject ist, ruft die Standardimplementierung COleServerItem::OnHide auf.
CDocObjectServerItem::OnShow
Wird vom Framework aufgerufen, um die Serveranwendung anzuweisen, das DocObject-Element aktiv zu machen.
virtual void OnShow();
Hinweise
Wenn das Element kein DocObject ist, ruft die Standardimplementierung COleServerItem::OnShow auf. Überschreiben Sie diese Funktion, wenn Sie beim Öffnen eines DocObject-Elements eine spezielle Verarbeitung durchführen möchten.
Siehe auch
COleServerItem-Klasse
Hierarchiediagramm
CDocObjectServer-Klasse
COleDocObjectItem-Klasse