Função IsAccelerator (ole2.h)
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 |