Compartilhar via

Método IOleControlSite::TranslateAccelerator (ocidl.h)

  • Artigo

Passa um pressionamento de tecla para o site de controle para processamento.

Sintaxe

HRESULT TranslateAccelerator(
  [in] MSG   *pMsg,
  [in] DWORD grfModifiers
);

Parâmetros

[in] pMsg

Um ponteiro para a estrutura MSG que descreve o pressionamento de tecla a ser processado.

[in] grfModifiers

Sinalizadores que descrevem o estado das teclas Control, Alt e Shift. O valor do sinalizador pode ser qualquer valor de enumeração KEYMODIFIERS válido.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 O contêiner processou a mensagem.
S_FALSE
 O contêiner não processou a mensagem. Esse valor também deve ser retornado em todos os outros casos de erro além de E_NOTIMPL.
E_NOTIMPL
 O contêiner não implementa o suporte ao acelerador.

Comentários

Esse método é chamado por um controle que pode ser ativo pela interface do usuário. Nesses casos, um controle pode processar todos os pressionamentos de tecla primeiro por meio de IOleInPlaceActiveObject::TranslateAccelerator, de acordo com as regras normais do Documento Composto OLE. Dentro desse método, o controle pode fornecer ao contêiner determinadas mensagens para processar primeiro chamando IOleControlSite::TranslateAccelerator e usando o valor retornado para determinar se algum processamento ocorreu. Caso contrário, o controle sempre processa a mensagem primeiro. Se o controle não usar o pressionamento de tecla como acelerador, ele passará o pressionamento de teclas para o contêiner por meio desse método.

Requisitos

Requisito Valor
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 ocidl.h

Confira também

Iolecontrolsite

IOleInPlaceActiveObject::TranslateAccelerator