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

CObject

CCmdTarget

CDocItem

COleServerItem

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