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