CDocItem-Klasse

Die Basisklasse für Dokumentelemente, die Komponenten der Daten eines Dokuments sind.

Syntax

class CDocItem : public CCmdTarget

Member

Öffentliche Methoden

Name Beschreibung
CDocItem::GetDocument Gibt das Dokument zurück, das das Element enthält.
CDocItem::IsBlank Bestimmt, ob das Element Informationen enthält.

Hinweise

CDocItem Objekte werden verwendet, um OLE-Elemente in Client- und Serverdokumenten darzustellen.

Weitere Informationen finden Sie im Artikel Container: Implementieren eines Containers.

Vererbungshierarchie

CObject

CCmdTarget

CDocItem

Anforderungen

Kopfzeile: afxole.h

CDocItem::GetDocument

Rufen Sie diese Funktion auf, um das Dokument abzurufen, das das Element enthält.

CDocument* GetDocument() const;

Rückgabewert

Ein Zeiger auf das Dokument, das das Element enthält; NULL, wenn das Element nicht Teil eines Dokuments ist.

Hinweise

Diese Funktion wird in den abgeleiteten Klassen COleClientItem und COleServerItem überschrieben, wobei ein Zeiger auf ein COleDocument-Objekt, ein COleLinkingDoc- oder ein COleServerDoc-Objekt zurückgegeben wird.

CDocItem::IsBlank

Wird vom Framework aufgerufen, wenn die Standard serialisierung auftritt.

virtual BOOL IsBlank() const;

Rückgabewert

Nonzero, wenn das Element keine Informationen enthält; andernfalls 0.

Hinweise

Standardmäßig CDocItem sind Objekte nicht leer. COleClientItem-Objekte sind manchmal leer, da sie direkt von CDocItem. COleServerItem-Objekte sind jedoch immer leer. Standardmäßig werden OLE-Anwendungen, die Objekte enthalten COleClientItem , die kein x- oder y-Ausmaß aufweisen, serialisiert. Dies geschieht durch Zurückgeben von TRUE aus einer Außerkraftsetzung, IsBlank wenn das Element kein x- oder y-Ausmaß aufweist.

Überschreiben Sie diese Funktion, wenn Sie andere Aktionen während der Serialisierung implementieren möchten.

Siehe auch

CCmdTarget-Klasse
Hierarchiediagramm
COleDocument-Klasse
COleServerItem-Klasse
COleClientItem-Klasse