Compartilhar via


Método IOleControl::OnMnemonic (ocidl.h)

Informa a um controle que o usuário pressionou um pressionamento de tecla que representa um teclado mnemônico.

Sintaxe

HRESULT OnMnemonic(
  [in] MSG *pMsg
);

Parâmetros

[in] pMsg

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

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
O método foi concluído com sucesso.
E_NOTIMPL
O controle não manipula mnemônicos. Isso indica uma condição inesperada e um erro de chamador. Por exemplo, o chamador incompatível com qual controle tem qual mnemônico.

Comentários

O pressionamento de tecla deve corresponder a uma das entradas ACCEL na tabela mnemônica retornada por meio de IOleControl::GetControlInfo. O controle executa qualquer ação apropriada para o pressionamento de teclas.

Anotações aos Chamadores

Um contêiner de um controle tem permissão para armazenar em cache a estrutura CONTROLINFO do controle, desde que o contêiner implemente IOleControlSite::OnControlInfoChanged para saber quando deve atualizar suas informações armazenadas em cache.

Observações aos implementadores

Se um controle alterar o conteúdo de sua estrutura CONTROLINFO , ele deverá notificar seu contêiner chamando IOleControlSite::OnControlInfoChanged.

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

Iolecontrol

IOleControlSite::OnControlInfoChanged