Compartilhar via


Classe CDocItem

A classe base para itens de documento, que são componentes dos dados de um documento.

Sintaxe

class CDocItem : public CCmdTarget

Membros

Métodos públicos

Nome Descrição
CDocItem::GetDocument Retorna o documento que contém o item.
CDocItem::IsBlank Determina se o item contém alguma informação.

Comentários

Objetos CDocItemsão usados para representar itens OLE em documentos de cliente e servidor.

Para obter mais informações, consulte o artigo Contêineres: implementando um contêiner.

Hierarquia de herança

CObject

CCmdTarget

CDocItem

Requisitos

Cabeçalho: afxole.h

CDocItem::GetDocument

Chame essa função para obter o documento que contém o item.

CDocument* GetDocument() const;

Valor de retorno

Um ponteiro para o documento que contém o item; NULL se o item não fizer parte de um documento.

Comentários

Essa função é substituída nas classes derivadas COleClientItem e COleServerItem, retornando um ponteiro para um COleDocument, um COleLinkingDoc ou um objeto COleServerDoc.

CDocItem::IsBlank

Chamado pela estrutura quando ocorre a serialização padrão.

virtual BOOL IsBlank() const;

Valor de retorno

Não zero se o item não contiver nenhuma informação; caso contrário, 0.

Comentários

Por padrão, os objetos CDocItem não estão em branco. COleClientItem às vezes ficam em branco porque derivam diretamente de CDocItem. No entanto, os objetos COleServerItem estão sempre em branco. Por padrão, os aplicativos OLE que contêm objetos COleClientItem que não têm extensão x ou y são serializados. Isso é feito retornando TRUE de uma substituição de IsBlank quando o item não tem extensão x ou y.

Substitua essa função se você quiser implementar outras ações durante a serialização.

Confira também

Classe CCmdTarget
Gráfico da hierarquia
Classe COleDocument
Classe COleServerItem
Classe COleClientItem