TN071: implementação de IOleCommandTarget MFC
Dica
A nota técnica a seguir não foi atualizada desde que ela foi incluída pela primeira vez na documentação online.Como resultado, alguns procedimentos e tópicos podem estar incorretos ou expirados.Para obter as informações mais recentes, é recomendável que você procure o tópico de interesse no índice de documentação online.
A interface de IOleCommandTarget habilita objetos e seus contêineres a expedição comando entre si. Por exemplo, as barras de ferramentas de um objeto pode conter os botões para comandos como Imprimir, Visualizar Impressão, Salvar, New, e Zoom. Se esse objeto foi inserido em um contêiner que da suporte a IOleCommandTarget, o objeto pode habilitar os botões e encaminhar os comandos ao contêiner para processar quando o usuário clicou nos. Se um contêiner queria o objeto inserido para se imprimir, pode fazer essa solicitação ao enviar um comando por meio da interface de IOleCommandTarget do objeto inserido.
IOleCommandTarget é Automação- como a interface usada por um cliente para invocar métodos em um servidor. Porém, usando IOleCommandTarget salva a sobrecarga de fazer chamadas por meio das interfaces de automação como os programadores não precisam usar o método normalmente caro de Invoke de IDispatch.
MFC no, a interface de IOleCommandTarget é usada por servidores ativas do documento para permitir que os contêineres ativas do documento despachem comandos ao servidor. A classe do servidor ativo do documento, CDocObjectServerItem, mapas da interface de MFC do (consulte TN038: Implementação de MFC/OLE IUnknown) para implementar a interface de IOleCommandTarget .
IOleCommandTarget é implementado da classe de COleFrameHook . COleFrameHook é uma classe não documentado MFC que implementa a funcionalidade da janela do quadro de contêineres de edição no local. COleFrameHook também usa mapas da interface de MFC para implementar a interface de IOleCommandTarget . A implementação deCOleFrameHook de IOleCommandTarget encaminha comandos DE a COleDocObjectItem- contêiner ativas derivados do documento. Isso permite a qualquer MFC o contêiner ativa do documento receba mensagens de servidores ativas independentes do documento.
Mapas de comando OLE MFC
Os desenvolvedores de MFC podem tirar proveito de IOleCommandTarget usando mapas com OLE DB do comando MFC. Os mapas com OLE DB de comando são como mapas de mensagem como podem ser usados para mapear comandos DE as funções de membro da classe que contém o mapa do comando. Para fazer isso, macros de trabalho local no mapa de comando para especificar o grupo de comando OLE de comando que você deseja manipular, o comando OLE, e a ID de comando da mensagem de WM_COMMAND que será enviada quando o comando OLE é recebido. MFC O também fornece um número de macros predefinidos para comandos do padrão. Para obter uma lista dos comandos do padrão que foi criado originalmente para uso com aplicativos do Microsoft Office, consulte a enumeração de OLECMDID, que é definida em docobj.h.
Quando um comando OLE é recebido por um aplicativo MFC que contém um mapa de comando OLE MFC, o tenta localizar o grupo de ID de comando e de comando para o comando solicitado no mapa de comando OLE do aplicativo. Se for encontrada uma correspondência, uma mensagem de WM_COMMAND foi despachada ao aplicativo que contém o mapa de comando com a ID do comando solicitado. (Consulte a descrição de ON_OLECMD em.) Desse modo, os comandos OLE despachados para um aplicativo são transformados em mensagens de WM_COMMAND por MFC. As mensagens de WM_COMMAND são roteadas pelos mapas da mensagem do aplicativo com a arquitetura padrão roteamento de comando MFC.
Diferentemente dos mapas da mensagem, mapas com OLE DB do comando MFC não têm suporte ClassWizard. Os desenvolvedores de MFC deve adicionar suporte OLE do mapa de comando e entradas com OLE DB do mapa de comando para a mão. Os mapas com OLE DB de comando podem ser adicionados aos servidores ativas do documento MFC em qualquer classe que estiver na cadeia retornadas roteamento de WM_COMMAND no momento em que o documento ativo está ativa no local em um contêiner. Essas classes incluem as classes derivadas do aplicativo de CWinApp, de CView, de CDocument, e de COleIPFrameWnd. Em contêineres ativas do documento, mapas com OLE DB do comando só podem ser adicionados a COleDocObjectItem- classe derivada. Além disso, em contêineres ativas do documento, as mensagens de WM_COMMAND serão despachadas somente ao mapa em COleDocObjectItem- classe derivada da mensagem.
Macros OLE DB do mapa de comando
Use os seguintes macros para adicionar funcionalidade do mapa de comando para sua classe:
DECLARE_OLECMD_MAP ()
Esta macro vai na declaração de classe (normalmente no arquivo de cabeçalho) da classe que contém o mapa do comando.
BEGIN_OLECMD_MAP(theClass, baseClass)
theClass
Nome da classe que contém o mapa do comando.baseClass
Nome da classe base da classe que contém o mapa do comando.
Esta macro marca o início do mapa de comando. Use esta macro no arquivo de implementação da classe que contém o mapa de comando.
END_OLECMD_MAP()
Esta macro marca o fim do mapa de comando. Use esta macro no arquivo de implementação da classe que contém o mapa de comando. Esta macro sempre deve obedecer a macro de BEGIN_OLECMD_MAP .
ON_OLECMD(pguid, olecmdid, id)
pguid
Ponteiro para o GUID do grupo de comando OLE do comando. Esse parâmetro é nulo para o grupo de comando OLE padrão.olecmdid
ID do comando OLE do comando ser invocado.id
ID da mensagem de WM_COMMAND a ser enviada ao aplicativo que contém o mapa de comando quando este comando OLE for invocado.
Use a macro de ON_OLECMD no mapa de comando para adicionar entradas para os comandos DE que você deseja controlar. Quando os comandos OLE são recebidos, eles serão convertidos a mensagem especificada de WM_COMMAND e retornado por meio da mensagem de aplicativo usando a arquitetura de comando- roteamento MFC do padrão.
Exemplo
O exemplo a seguir mostra como adicionar o recurso OLE de comando- manipulação a um servidor ativo do documento MFC tratar o comando OLE de OLECMDID_PRINT . Este exemplo supõe que você usou AppWizard para gerar um aplicativo MFC que é um servidor ativo do documento.
No CView- o arquivo de cabeçalho derivado da classe, adiciona a macro de DECLARE_OLECMD_MAP à declaração da classe.
Dica
Use CView- classe derivada porque é uma das classes no servidor ativo do documento que está na cadeia retornadas roteamento de WM_COMMAND .
class CMyServerView : public CView { protected: // create from serialization only CMyServerView(); DECLARE_DYNCREATE(CMyServerView) DECLARE_OLECMD_MAP() . . . };No arquivo de implementação de CView- a classe derivada, adiciona as macros de BEGIN_OLECMD_MAP e de END_OLECMD_MAP :
BEGIN_OLECMD_MAP(CMyServerView, CView) END_OLECMD_MAP()Para tratar o comando de OLE cópia padrão, adicione uma macro de ON_OLECMD ao mapa do comando especificando o ID do comando OLE para o comando de cópia e ID_FILE_PRINT padrão para a ID de WM_COMMAND ID_FILE_PRINT é a ID de comando padrão de cópia usado por aplicativos AppWizard- gerados MFC:
BEGIN_OLECMD_MAP(CMyServerView, CView) ON_OLECMD(NULL,OLECMDID_PRINT,ID_FILE_PRINT) END_OLECMD_MAP()
Observe que o de macros de comando OLE padrão, definido em afxdocob.h, pode ser usado no lugar de macro de ON_OLECMD porque OLECMDID_PRINT é uma ID de comando OLE padrão A macro de ON_OLECMD_PRINT realizará a mesma tarefa que a macro de ON_OLECMD mostrado acima.
Quando um aplicativo de contêiner esse servidor envia um comando de OLECMDID_PRINT por meio da interface de IOleCommandTarget do servidor, o manipulador do comando de impressão MFC será invocado no servidor, fazendo com que o servidor imprimir o aplicativo. O código ativa do contêiner do documento para invocar o comando copiar adicionado nas etapas acima seria algo como:
void CContainerCntrItem::DoOleCmd()
{
IOleCommandTarget *pCmd = NULL;
HRESULT hr = E_FAIL;
OLECMD ocm={OLECMDID_PRINT, 0};
hr = m_lpObject->QueryInterface(IID_IOleCommandTarget,reinterpret_cast<void**>(&pCmd));
if(FAILED(hr))
return;
hr = pCmd->QueryStatus(NULL, 1, &ocm, NULL);
if(SUCCEEDED(hr) && (ocm.cmdf & OLECMDF_ENABLED))
{
//Command is available and enabled so call it
COleVariant vIn;
COleVariant vOut;
hr = pCmd->Exec(NULL, OLECMDID_PRINT,
OLECMDEXECOPT_DODEFAULT, &vIn, &vOut);
ASSERT(SUCCEEDED(hr));
}
pCmd->Release();
}