Classe de COleServerDoc

Artigo
02/25/2013

A classe base para documentos VELHOS do servidor.

class AFX_NOVTABLE COleServerDoc : public COleLinkingDoc

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
COleServerDoc::ActivateDocObject	Alterna o documento associado de DocObject.
COleServerDoc::ActivateInPlace	Alterna o documento para edição in-place.
COleServerDoc::DeactivateAndUndo	Desativa a interface do usuário do servidor.
COleServerDoc::DiscardUndoState	Informações de estado de desfazer- descarta.
COleServerDoc::GetClientSite	Recupera um ponteiro para a interface subjacente de IOleClientSite .
COleServerDoc::GetEmbeddedItem	Retorna um ponteiro para um item que representa o documento inteiro.
COleServerDoc::GetItemClipRect	Retorna o retângulo atual de identificação para edição in-place.
COleServerDoc::GetItemPosition	Retorna o retângulo da posição atual, relativo a área cliente de aplicativo do recipiente, para edição in-place.
COleServerDoc::GetZoomFactor	Retorna o fator de zoom em pixels.
COleServerDoc::IsDocObject	Determina se o documento é um DocObject.
COleServerDoc::IsEmbedded	Indica se o documento está inserido em um documento recipiente ou em uma execução autônomo.
COleServerDoc::IsInPlaceActive	Retorna TRUE se o item está ativado no lugar.
COleServerDoc::NotifyChanged	Contêiner que notifica o usuário alterou o documento.
COleServerDoc::NotifyClosed	Contêiner que notifica o usuário desliga o documento.
COleServerDoc::NotifyRename	Contêiner que notifica o usuário renomeou o documento.
COleServerDoc::NotifySaved	Contêiner que notifica o usuário salvou o documento.
COleServerDoc::OnDeactivate	Chamado pela estrutura quando o usuário desativar um item que está ativado no lugar.
COleServerDoc::OnDeactivateUI	Chamado pela estrutura para destruir controles e outros elementos da interface do usuário criados para o ativação in-loco.
COleServerDoc::OnDocWindowActivate	Quando chamado pela estrutura do quadro a janela do documento de contêiner está ativado ou desativada.
COleServerDoc::OnResizeBorder	Chamado pela estrutura quando a janela ou a janela de documento de quadro de aplicativo de recipiente são redimensionadas.
COleServerDoc::OnShowControlBars	Chamado pela estrutura para mostrar ou ocultar barras de controle para edição in-place.
COleServerDoc::OnUpdateDocument	Chamado pela estrutura quando um documento de servidor que é um item inserido é salvo, atualizando a cópia do contêiner de itens.
COleServerDoc::RequestPositionChange	Altera a posição do quadro de edição in-loco.
COleServerDoc::SaveEmbedding	Informa o aplicativo de contêiner salvar o documento.
COleServerDoc::ScrollContainerBy	Rola o documento contêiner.
COleServerDoc::UpdateAllItems	Contêiner que notifica o usuário alterou o documento.

Métodos protegidos

Nome	Descrição
COleServerDoc::CreateInPlaceFrame	Chamado pela estrutura para criar uma janela de quadro chave para edição in-place.
COleServerDoc::DestroyInPlaceFrame	Chamado pela estrutura para destruir uma janela de quadro chave para edição in-place.
COleServerDoc::GetDocObjectServer	Substituir essa função para criar um novo objeto de CDocObjectServer e para indicar que este documento é um contêiner de DocObject.
COleServerDoc::OnClose	Quando um chamado pela estrutura de um contêiner feche o documento.
COleServerDoc::OnExecOleCmd	Executa um comando especificado ou exibe ajuda para o comando.
COleServerDoc::OnFrameWindowActivate	Chamado pela estrutura quando a janela de quadro do recipiente é ativada ou desativada.
COleServerDoc::OnGetEmbeddedItem	Chamado para obter COleServerItem que representa o documento inteiro; usado para obter um item inserido.Implementação necessária.
COleServerDoc::OnReactivateAndUndo	Chamado pela estrutura para desfazer as alterações feitas durante a edição in-loco.
COleServerDoc::OnSetHostNames	Chamado pela estrutura quando um contêiner definir o título da janela para um objeto inserido.
COleServerDoc::OnSetItemRects	Chamado pela estrutura para posicionar a janela de quadro de edição in-loco dentro da janela de aplicativo de contêiner.
COleServerDoc::OnShowDocument	Chamado pela estrutura para mostrar ou ocultar o documento.

Comentários

Um documento de servidor pode conter objetos de COleServerItem , que representam o servidor que a interface entrou ou vinculou itens.Quando um aplicativo para servidores é lançado por um contêiner editar um item inserido, o item é carregado como seu próprio documento do servidor; o objeto de COleServerDoc contém apenas um objeto de COleServerItem , consistindo no documento inteiro.Quando um aplicativo para servidores é lançado por um contêiner editar um item associado, um documento existente é carregado a partir do disco; uma parte do conteúdo do documento é realçada para indicar o item associado.

Os objetos deCOleServerDoc também podem conter itens da classe de COleClientItem .Isso permite que você crie aplicativos de contêiner- servidor.A estrutura fornece funções para armazenar corretamente os itens de COleClientItem para atender a COleServerItem objetos.

Se seu aplicativo para servidores não faz links de suporte, um documento de servidor sempre irá conter somente um item do servidor, que representa o objeto inserido inteiro como um documento.Se seu aplicativo para servidores torna os links de suporte, deve criar um item de servidor sempre que uma seleção é copiado para a área de transferência.

Para usar COleServerDoc, derive uma classe de ele e implementar a função de membro de OnGetEmbeddedItem , que permite que seu servidor suporte itens inseridos.Derive uma classe de COleServerItem para implementar os itens nos documentos, e retornar objetos da classe de OnGetEmbeddedItem.

Para suportar vinculou itens, COleServerDoc fornece a função de membro de OnGetLinkedItem .Você pode usar a implementação padrão ou substituí-lo se você tem sua própria maneira para gerenciar itens do documento.

Você precisa de um COleServerDoc- classe derivada para cada tipo de documento de servidor seus suporte do aplicativo.Por exemplo, se seu aplicativo para servidores oferece suporte planilhas e elementos gráficos, você precisar dois COleServerDoc- classes derivadas.

Para obter mais informações sobre servidores, consulte o artigo servidores: implementando um servidor.