Função IsAccelerator (ole2.h)

  • Artigo

Determina se o pressionamento de tecla especificado é mapeado para um acelerador na tabela de aceleradores especificada.

Sintaxe

BOOL IsAccelerator(
  [in]  HACCEL hAccel,
  [in]  int    cAccelEntries,
  [in]  LPMSG  lpMsg,
  [out] WORD   *lpwCmd
);

Parâmetros

[in] hAccel

Um identificador para a tabela de aceleradores.

[in] cAccelEntries

O número de entradas na tabela de aceleradores.

[in] lpMsg

Um ponteiro para a mensagem de pressionamento de tecla a ser traduzida.

[out] lpwCmd

Um ponteiro para uma variável para receber o identificador de comando correspondente se houver um acelerador para o pressionamento de tecla. Esse parâmetro pode ser NULL.

Retornar valor

Se a mensagem for para o aplicativo de objeto, o valor retornado será TRUE. Se a mensagem não for para o objeto e deve ser encaminhada para o contêiner, o valor retornado será FALSE.

Comentários

Embora um objeto esteja ativo no local, o objeto sempre tem a primeira chance de converter os pressionamentos de tecla em aceleradores. Se o pressionamento de tecla corresponder a um de seus aceleradores, o objeto não deverá chamar a função OleTranslateAccelerator , mesmo que sua chamada à função TranslateAccelerator falhe. A falha ao processar pressionamentos de tecla dessa maneira pode levar a um comportamento inconsistente.

Se o pressionamento de teclas não for um dos aceleradores do objeto, o objeto deverá chamar OleTranslateAccelerator para permitir que o contêiner tente a tradução do acelerador.

O servidor do objeto pode chamar IsAccelerator para determinar se a mensagem de acelerador pertence a ele. Alguns servidores fazem a tradução de acelerador por conta própria e não chamam TranslateAccelerator. Esses aplicativos não chamarão IsAccelerator, pois eles já têm as informações.

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 ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

OleTranslateAccelerator

TranslateAccelerator