Função de retorno de chamada TranslateDispatch

Artigo
06/13/2023

[TranslateDispatch está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Usado pelo cliente da função DoReaderMode para interceptar e manipular explicitamente todas as mensagens do Windows direcionadas para a área de rolagem da janela do modo leitor. Essa é uma função de retorno de chamada definida pelo aplicativo.

Sintaxe

BOOL CALLBACK TranslateDispatch(
  _In_ const MSG *lpmsg
);

Parâmetros

lpmsg [in]

Tipo: const MSG*

Um ponteiro para uma estrutura MSG que contém a mensagem interceptada.

Valor retornado

Tipo: BOOL

TRUE se a mensagem foi tratada por essa função; caso contrário, FALSE. Se FALSE, a mensagem será tratada pela implementação do modo de leitor padrão. Essa implementação manipula o movimento e os botões do mouse, bem como pressionamentos de tecla.

Exemplos

O exemplo a seguir descreve uma implementação dessa função.

BOOL CALLBACK
TranslateDispatchCallback(LPMSG lpmsg)
{
    BOOL fResult = FALSE;

    if (lpmsg->message == WM_KEYDOWN)
    {
        
        // Perform custom keyboard actions here.
        fResult = TRUE;
    }

    return fResult;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]

Partilhar via