Partilhar via

Classe CDocObjectServerItem

Implementa verbos do servidor OLE especificamente para servidores DocObject.

Sintaxe

class CDocObjectServerItem : public COleServerItem

Membros

Construtores Protegidos

Nome Descrição
CDocObjectServerItem::CDocObjectServerItem Constrói um objeto CDocObjectServerItem.

Métodos públicos

Nome Descrição
CDocObjectServerItem::GetDocument Recupera um ponteiro para o documento que contém o item.

Métodos protegidos

Nome Descrição
CDocObjectServerItem::OnDoVerb Chamado para executar um verbo.
CDocObjectServerItem::OnHide Gerará uma exceção se a estrutura tentar ocultar um item DocObject.
CDocObjectServerItem::OnShow Chamado pela estrutura para tornar o item DocObject ativo no local. Se o item não for um DocObject, chamará COleServerItem::OnShow.

Comentários

CDocObjectServerItem define funções de membro substituíveis: OnHide, OnDoVerb e OnShow.

Para usar CDocObjectServerItem, verifique se a substituição OnGetEmbeddedItem em sua classe derivada de COleServerDoc retorna um novo objeto CDocObjectServerItem. Se você precisar alterar qualquer funcionalidade no item, poderá criar uma instância de sua classe derivada de CDocObjectServerItem.

Para obter mais informações sobre DocObjects, consulte CDocObjectServer e COleCmdUI na Referência do MFC.

Hierarquia de herança

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Requisitos

Cabeçalho: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Constrói um objeto CDocObjectServerItem.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parâmetros

pServerDoc
Um ponteiro para o documento que conterá o novo item DocObject.

bAutoDelete
Indica se o objeto pode ser excluído quando um link para ele é liberado. Defina o argumento como FALSE se o objeto CDocObjectServerItem for parte integrante dos dados do documento. Defina como TRUE se o objeto for uma estrutura secundária usada para identificar um intervalo nos dados do documento que pode ser excluído pela estrutura.

CDocObjectServerItem::GetDocument

Recupera um ponteiro para o documento que contém o item.

COleServerDoc* 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

Isso permite o acesso ao documento do servidor que você passou como um argumento para o construtor CDocObjectServerItem.

CDocObjectServerItem::OnDoVerb

Chamado pela estrutura para executar o verbo especificado.

virtual void OnDoVerb(LONG iVerb);

Parâmetros

iVerb
Especifica o verbo a ser executado. Para obter valores possíveis, confira IOleObject::DoVerb no SDK do Windows.

Comentários

A implementação padrão chamará a função membro OnShow se o item for um DocObject e o OLEIVERB_INPLACEACTIVATE ou OLEIVERB_SHOW for especificado. Se o item não for um DocObject ou um verbo diferente for especificado, a implementação padrão chamará COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

Chamado pela estrutura para ocultar o item.

virtual void OnHide();

Comentários

A implementação padrão gerará uma exceção se o item for um DocObject. Não é possível ocultar um item DocObject ativo porque ele usa toda a exibição. Você precisa desativar o item DocObject para que ele desapareça. Se o item não for um DocObject, a implementação padrão chamará COleServerItem::OnHide.

CDocObjectServerItem::OnShow

Chamado pela estrutura para instruir o aplicativo de servidor a tornar o item DocObject ativo no local.

virtual void OnShow();

Comentários

Se o item não for um DocObject, a implementação padrão chamará COleServerItem::OnShow. Substitua essa função se você quiser executar um processamento especial ao abrir um item DocObject.

Confira também

Classe COleServerItem
Gráfico da hierarquia
Classe CDocObjectServer
Classe COleDocObjectItem

  • Last updated on