Compartilhar via

Interface IOleCommandTarget (docobj.h)

  • Artigo

Permite que objetos e seus contêineres enviem comandos uns para os outros. Por exemplo, as barras de ferramentas de um objeto podem conter botões para comandos como Imprimir, Visualizar Impressão, Salvar, Novo e Zoom.

As diretrizes normais de ativação in-loco recomendam que você remova ou desabilite esses botões porque não há mecanismo padrão eficiente disponível para expedi-los para o contêiner. Da mesma forma, um contêiner até agora não tinha meios eficientes para enviar comandos como Imprimir, Configuração de Página e Propriedades para um objeto ativo in-loco. Esse roteamento de comando simples poderia ter sido tratado por meio de padrões de Automação OLE existentes e da interface IDispatch , mas a sobrecarga com IDispatch é maior do que é necessária no caso de objetos de documento. A interface IOleCommandTarget fornece um meio mais simples de alcançar as mesmas extremidades.

Os comandos disponíveis são definidos por identificadores inteiros em um grupo. O grupo em si é identificado com um GUID. A interface permite que um chamador consulte o suporte de um ou mais comandos dentro de um grupo e emita um comando com suporte para o objeto .

Herança

A interface IOleCommandTarget herda da interface IUnknown . IOleCommandTarget também tem estes tipos de membros:

Métodos

A interface IOleCommandTarget tem esses métodos.

 
IOleCommandTarget::Exec

Executa o comando especificado ou exibe a ajuda para o comando.
IOleCommandTarget::QueryStatus

Consulta o objeto para saber o status de um ou mais comandos gerados pelos eventos da interface do usuário.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho docobj.h