Classe COleClientItem

Artigo
06/10/2015

Define a interface recipiente para itens VELHOS.

class COleClientItem : public CDocItem

Membros

Construtores public

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

Métodos públicos

Nome	Descrição
COleClientItem::Activate	Abra o item para OLE uma operação e executa no verbo especificado.
COleClientItem::ActivateAs	Alterna o item como outro tipo.
COleClientItem::AttachDataObject	Acessa os dados no objeto OLE.
COleClientItem::CanCreateFromData	Indica se um aplicativo de contêiner pode criar um objeto inserido.
COleClientItem::CanCreateLinkFromData	Indica se um aplicativo de contêiner pode criar um objeto associado.
COleClientItem::CanPaste	Indica se a área de transferência contém um item OLE embeddable ou estático.
COleClientItem::CanPasteLink	Indica se a área de transferência contém um item OLE enlaçável.
COleClientItem::Close	Fecha um link a um servidor mas não destrói o item OLE.
COleClientItem::ConvertTo	Converte o item para outro tipo.
COleClientItem::CopyToClipboard	Copia o item OLE para a área de transferência.
COleClientItem::CreateCloneFrom	Cria uma cópia de um item existente.
COleClientItem::CreateFromClipboard	Cria um item inserido da área de transferência.
COleClientItem::CreateFromData	Cria um item inserido de um objeto de dados.
COleClientItem::CreateFromFile	Cria um item inserido de um arquivo.
COleClientItem::CreateLinkFromClipboard	Cria um item associado da área de transferência.
COleClientItem::CreateLinkFromData	Cria um item associado de um objeto de dados.
COleClientItem::CreateLinkFromFile	Cria um item associado de um arquivo.
COleClientItem::CreateNewItem	Cria um novo item inserido iniciando o aplicativo para servidores.
COleClientItem::CreateStaticFromClipboard	Cria um item estático da área de transferência.
COleClientItem::CreateStaticFromData	Cria um item estático de um objeto de dados.
COleClientItem::Deactivate	Desativa o item.
COleClientItem::DeactivateUI	Restaura a interface do usuário do aplicativo de contêiner para seu estado original.
COleClientItem::Delete	Exclui ou desliga o item OLE se fosse um item associado.
COleClientItem::DoDragDrop	Executa uma operação de arrastar e soltar.
COleClientItem::DoVerb	Executa o verbo especificado.
COleClientItem::Draw	Desenha o item OLE.
COleClientItem::GetActiveView	Obtém a exibição em que o item é ativado no lugar.
COleClientItem::GetCachedExtent	Retorna os limites do retângulo OLE de item.
COleClientItem::GetClassID	Obtém a identificação de classe do item atual
COleClientItem::GetClipboardData	Obtém os dados que devem ser colocados na área de transferência chamar a função de membro de CopyToClipboard .
COleClientItem::GetDocument	Retorna o objeto de COleDocument que contém o item atual.
COleClientItem::GetDrawAspect	Obtém a exibição atual de item para renderização.
COleClientItem::GetExtent	Retorna os limites do retângulo OLE de item.
COleClientItem::GetIconFromRegistry	Retrives um identificador para um ícone associado com o servidor de um determinado CLSID.
COleClientItem::GetIconicMetafile	Obtém o metarquivo usado desenhando o ícone de item.
COleClientItem::GetInPlaceWindow	Retorna um ponteiro para a janela de edição in-loco de item.
COleClientItem::GetItemState	Obtém o estado atual do item.
COleClientItem::GetLastStatus	Retorna o status da operação OLE a última vez.
COleClientItem::GetLinkUpdateOptions	Retorna o modo de atualização para um item associado (recurso avançado).
COleClientItem::GetType	Retorna o tipo (inserido, ou) associado estático de item OLE.
COleClientItem::GetUserType	Obtém uma cadeia de caracteres que descreve o tipo de item.
COleClientItem::IsInPlaceActive	Retorna TRUE se o item está no lugar.
COleClientItem::IsLinkUpToDate	Retorna Verdadeiro se um item associado é atualizado com seu documento de origem.
COleClientItem::IsModified	Retorna TRUE se o item foi alterado desde que foi o exceto o último.
COleClientItem::IsOpen	Retorna TRUE se o item está atualmente aberto no aplicativo para servidores.
COleClientItem::IsRunning	Retorna TRUE se o aplicativo para servidores de item está sendo executado.
COleClientItem::OnActivate	Chamado pela estrutura para notificar o item que está ativado.
COleClientItem::OnActivateUI	Chamado pela estrutura para notificar o item que está ativada e deve mostrar sua interface do usuário.
COleClientItem::OnChange	Chamado quando o servidor modificar o item OLE. Implementação necessária.
COleClientItem::OnDeactivate	Chamado pela estrutura quando um item é desativado.
COleClientItem::OnDeactivateUI	Chamado pela estrutura quando o servidor remova sua interface do usuário no lugar.
COleClientItem::OnGetClipboardData	Chamado pela estrutura para obter os dados a serem copiados para a área de transferência.
COleClientItem::OnInsertMenus	Chamado pela estrutura para criar um menu composto.
COleClientItem::OnRemoveMenus	Chamado pela estrutura para remover os menus do contêiner de um menu composto.
COleClientItem::OnSetMenu	Chamado pela estrutura do para instalar e remover um menu composto.
COleClientItem::OnShowControlBars	Chamado pela estrutura para exibir e ocultar barras de controle.
COleClientItem::OnUpdateFrameTitle	Chamado pela estrutura para atualizar a barra de título da janela do quadro.
COleClientItem::ReactivateAndUndo	Reactivates o item e desfaz a operação da última de edição in-loco.
COleClientItem::Release	Libera a conexão a um item associado OLE e fechá-lo estiver aberta. Não destrói o item de cliente.
COleClientItem::Reload	Recarrega o item após uma chamada a ActivateAs.
COleClientItem::Run	Executa o aplicativo associado com o item.
COleClientItem::SetDrawAspect	Define a exibição atual de item para renderização.
COleClientItem::SetExtent	Define o retângulo delimitador do item OLE.
COleClientItem::SetHostNames	Defina os nomes que o servidor exibe ao editar o item OLE.
COleClientItem::SetIconicMetafile	Armazenar em cache o metarquivo usado desenhando o ícone de item.
COleClientItem::SetItemRects	Define o retângulo delimitador do item.
COleClientItem::SetLinkUpdateOptions	Defina o modo de atualização para um item associado (recurso avançado).
COleClientItem::SetPrintDevice	Define o dispositivo de destino PRINT- para este item de cliente.
COleClientItem::UpdateLink	Atualiza o cache de apresentação de um item.

Métodos protegidos

Nome	Descrição
COleClientItem::CanActivate	Chamado pela estrutura para determinar se o ativação in-loco é permitido.
COleClientItem::OnChangeItemPosition	Chamado pela estrutura quando a posição de um item alterar.
COleClientItem::OnDeactivateAndUndo	Chamado pela estrutura para desfazer após a ativação.
COleClientItem::OnDiscardUndoState	Chamado pela estrutura para descartar o item desfazer informações de estado.
COleClientItem::OnGetClipRect	Chamado pela estrutura para obter recorte- o retângulo de item coordena.
COleClientItem::OnGetItemPosition	Chamado pela estrutura para obter a posição do item relativo para o modo de exibição.
COleClientItem::OnGetWindowContext	Chamado pela estrutura quando um item é ativado no lugar.
COleClientItem::OnScrollBy	Chamado pela estrutura para rolar o item no modo.
COleClientItem::OnShowItem	Chamado pela estrutura para exibir o item OLE.

Comentários

Um item OLE representa os dados, criados e mantidos por um aplicativo para servidores, que perfeitamente” “pode ser inserido em um documento de modo que ele para o usuário para ser um único documento. O resultado é um “documento composto” feitas de item OLE e um documento recipiente.

Um item OLE pode ser inserido ou associado. Se for inserida, os dados são armazenados como parte do documento composto. Se são associados, os dados são armazenados como parte de um arquivo separado criado pelo aplicativo para servidores, e somente um link para o arquivo é armazenado no documento composto. Todos os itens VELHOS contêm informações que especifica o aplicativo para servidores que deve ser chamado para editá-los.

COleClientItem define várias funções substituíveis que são chamadas em resposta às solicitações de aplicativo para servidores; esses overridables geralmente agem como notificações. Isso permite o aplicativo para servidores informar o contêiner de alterações que o usuário faz quando editando o item OLE, ou recuperar as informações necessárias durante a edição.

COleClientItem pode ser usado com a classe de COleDocument, de COleLinkingDoc, ou de COleServerDoc . Para usar COleClientItem, derive uma classe de ele e implementar a função de membro de OnChange , que define como o contêiner responde às alterações feitas ao item. Para oferecer suporte a ativação in-loco, substituir a função de membro de OnGetItemPosition . Essa função fornece informações sobre a posição exibida de item OLE.

Para obter mais informações sobre como usar a interface continente, consulte os artigos Recipientes: implementando um contêiner e ativação.

Dica

Refere-se Windows SDK inseriu e vinculou itens como “objetos e” refere-se tipos de itens como “classes.” Usa essa referência o termo “item” distinguir a entidade OLE do objeto correspondente C++ e o termo “tipo” para distinguir a categoria OLE da classe C++.