Contêineres: Notificações de item do cliente
Este artigo descreve as funções substituíveis estrutura MFC chama quando aplicativos de servidor modificar itens no documento do seu aplicativo cliente.
COleClientItem define diversas funções substituíveis que são chamadas em resposta às solicitações do aplicativo de componente, também é chamado de aplicativo do servidor.Esses overridables normalmente agem sistema autônomo notificações.Eles informam o aplicativo contêiner de vários eventos, sistema autônomo rolagem, ativação ou uma alterar de posição e sistema autônomo alterações que o usuário fizer ao editar ou manipular o item.
A estrutura notifica o aplicativo de contêiner de alterações por meio de uma telefonar de COleClientItem::OnChange, uma função substituível cuja implementação é necessária. Esta função protegida recebe dois argumentos.O primeiro Especifica o motivo pelo qual que o servidor o item alterado:
Notificação |
Significado |
|---|---|
OLE_CHANGED |
Aparência do item OLE foi alterado. |
OLE_SAVED |
O item OLE foi salvo. |
OLE_CLOSED |
O item OLE foi fechado. |
OLE_RENAMED |
O documento do servidor que contém o item OLE foi renomeado. |
OLE_CHANGED_STATE |
O item OLE foi alterado de um estado para outro. |
OLE_CHANGED_ASPECT |
Aspecto de desenho do item OLE foi alterado pela estrutura. |
Esses valores são do OLE_NOTIFICATION enumeração, que é definida em AFXOLE.H.
O segundo argumento para essa função especifica como o item foi alterado ou o que estado que ele entrou:
Quando o primeiro argumento é |
Segundo argumento |
|---|---|
OLE_SAVED ou OLE_CLOSED |
Não é usado. |
OLE_CHANGED |
Especifica o aspecto do item OLE que foi alterado. |
OLE_CHANGED_STATE |
Descreve o estado que está sendo inserido (emptyState, loadedState, openState, activeState, ou activeUIState). |
Para obter mais informações sobre os estados que pode assumir um item do cliente, consulte Contêineres: Estados de item do cliente.
A estrutura chama COleClientItem::OnGetItemPosition Quando um item está sendo ativado para edição no local. Implementação é necessário para aplicativos que oferecem suporte à edição in-loco.O Assistente de aplicativos MFC fornece uma implementação básica, que atribui sistema autônomo coordenadas do item para o CRect objeto que é passado sistema autônomo um argumento para OnGetItemPosition.
Se a posição ou dimensionar de um item for alterado durante a edição in-loco, as informações do contêiner sobre posição e retângulos de recorte do item devem ser atualizadas e o servidor deve receber informações sobre as alterações.A estrutura chama COleClientItem::OnChangeItemPosition para essa finalidade. MFC aplicativo assistente fornece uma substituir que chama a função da classe base.Você deve edição a função que o Assistente de aplicativo grava para o seu COleClientItem-classe derivada para que a função atualiza as informações mantidas pelo seu objeto de item do cliente.
Consulte também
Conceitos
Contêineres: Estados de item do cliente