Partilhar via

Classe CDocObjectServerItem

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.

Implementa verbos de servidor OLE especificamente para servidores DocObject.

Sintaxe

class CDocObjectServerItem : public COleServerItem

Membros

Construtores Protegidos

Nome Description
CDocObjectServerItem::CDocObjectServerItem Constrói um CDocObjectServerItem objeto.

Métodos Públicos

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

Métodos Protegidos

Nome Description
CDocObjectServerItem::OnDoVerb Chamado para executar um verbo.
CDocObjectServerItem::OnHide Lança uma exceção se o framework tentar ocultar um item DocObject.
CDocObjectServerItem::OnShow Chamado pelo framework para tornar o item DocObject ativo no local. Se o item não for um DocObject, chama o COleServerItem::OnShow.

Observações

CDocObjectServerItem define funções de membro sobrescritas: OnHide, OnDoVerb e OnShow.

Para usar CDocObjectServerItem, assegure que o override OnGetEmbeddedItem na sua COleServerDocclasse derivada devolve um novo CDocObjectServerItem objeto. Se precisares de alterar alguma funcionalidade no teu item, podes criar uma nova instância da tua CDocObjectServerItemprópria classe -derivada.

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

Hierarquia de herança

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Requerimentos

Cabeçalho: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Constrói um CDocObjectServerItem objeto.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parâmetros

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

bAutoDelete
Indica se o objeto pode ser eliminado quando um link para ele é libertado. Defina o argumento para FALSE se o CDocObjectServerItem objeto for parte integrante dos dados do seu documento. Defina-o como TRUE se o objeto for uma estrutura secundária usada para identificar um intervalo nos dados do seu documento que pode ser eliminado pelo framework.

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.

Observações

Isto permite o acesso ao documento do servidor que passou como argumento para o construtor CDocObjectServerItem .

CDocObjectServerItem::OnDoVerb

Chamado pelo framework para executar o verbo especificado.

virtual void OnDoVerb(LONG iVerb);

Parâmetros

iVerb
Especifica o verbo executar. Para valores possíveis, veja IOleObject::D oVerb no SDK do Windows.

Observações

A implementação padrão chama 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 for especificado um verbo diferente, a implementação por defeito chama COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

Chamado pelo framework para esconder o item.

virtual void OnHide();

Observações

A implementação padrão lança uma exceção se o item for um DocObject. Não podes esconder um item DocObject ativo porque ocupa toda a vista. Tens de desativar o item DocObject para o fazer desaparecer. Se o item não for um DocObject, a implementação padrão chama COleServerItem::OnHide.

CDocObjectServerItem::OnShow

Chamado pelo framework para instruir a aplicação servidor a tornar o item DocObject no local ativo.

virtual void OnShow();

Observações

Se o item não for um DocObject, a implementação padrão chama COleServerItem::OnShow. Sobrescrita esta função se quiseres realizar um processamento especial ao abrir um item DocObject.

Consulte também

COleServerItem Classe
Gráfico de Hierarquia
Classe CDocObjectServer
Classe COleDocObjectItem

  • Last updated on