Поделиться через


Класс CDocItem

Базовый класс для элементов документа, являющихся компонентами данных документа.

Синтаксис

class CDocItem : public CCmdTarget

Участники

Открытые методы

Имя Описание
CDocItem::GetDocument Возвращает документ, содержащий элемент.
CDocItem::IsBlank Определяет, содержит ли элемент любую информацию.

Замечания

CDocItem объекты используются для представления элементов OLE как в клиентских, так и в серверных документах.

Дополнительные сведения см. в статье "Контейнеры: реализация контейнера".

Иерархия наследования

CObject

CCmdTarget

CDocItem

Требования

Заголовок: afxole.h

CDocItem::GetDocument

Вызовите эту функцию, чтобы получить документ, содержащий элемент.

CDocument* GetDocument() const;

Возвращаемое значение

Указатель на документ, содержащий элемент; ЗНАЧЕНИЕ NULL, если элемент не является частью документа.

Замечания

Эта функция переопределяется в производных классах COleClientItem и COleServerItem, возвращая указатель на COleDocument, COleLinkingDoc или объект COleServerDoc.

CDocItem::IsBlank

Вызывается платформой при сериализации по умолчанию.

virtual BOOL IsBlank() const;

Возвращаемое значение

Ненулевое значение, если элемент не содержит сведений; в противном случае — 0.

Замечания

По умолчанию CDocItem объекты не пусты. Объекты COleClientItem иногда пусты, так как они являются производными непосредственно от CDocItem. Однако объекты COleServerItem всегда пусты. По умолчанию приложения OLE, содержащие COleClientItem объекты без экстентов x или y, сериализуются. Это делается путем возврата TRUE из переопределения, IsBlank когда элемент не имеет экстент x или y.

Переопределите эту функцию, если вы хотите реализовать другие действия во время сериализации.

См. также

Класс CCmdTarget
Диаграмма иерархии
Класс COleDocument
Класс COleServerItem
Класс COleClientItem