Partilhar via


Classe CDocItem

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

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

Sintaxe

class CDocItem : public CCmdTarget

Membros

Métodos Públicos

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

Observações

CDocItem os objetos são usados para representar elementos OLE tanto em documentos cliente como servidor.

Para mais informações, consulte o artigo Containers: Implementing a Container.

Hierarquia de herança

CObject

CCmdTarget

CDocItem

Requerimentos

Cabeçalho: afxole.h

CDocItem::GetDocument

Ligue a esta 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.

Observações

Esta função é sobreposta nas classes derivadas COleClientItem e COleServerItem, retornando um ponteiro para um COleDocument, um COleLinkingDoc ou um objeto COleServerDoc .

CDocItem::IsBlank

Chamado pelo framework quando ocorre a serialização por defeito.

virtual BOOL IsBlank() const;

Valor de retorno

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

Observações

Por defeito, CDocItem os objetos não estão em branco. Os objetos COleClientItem por vezes estão em branco porque derivam diretamente de CDocItem. No entanto, os objetos COleServerItem estão sempre em branco. Por defeito, aplicações OLE que contêm COleClientItem objetos sem extensão x ou y são serializadas. Isto é feito ao devolver TRUE de uma sobreposição de IsBlank quando o item não tem extensão x ou y.

Anule esta função se quiser implementar outras ações durante a serialização.

Consulte também

Classe CCmdTarget
Gráfico de Hierarquia
Classe COleDocument
COleServerItem Classe
COleClientItem Classe