Função IsDialogMessageA (winuser.h)

Determina se uma mensagem é destinada à caixa de diálogo especificada e, se for, processa a mensagem.

Sintaxe

BOOL IsDialogMessageA(
  [in] HWND  hDlg,
  [in] LPMSG lpMsg
);

Parâmetros

[in] hDlg

Digite: HWND

Um identificador para a caixa de diálogo.

[in] lpMsg

Tipo: LPMSG

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

Retornar valor

Tipo: BOOL

Se a mensagem tiver sido processada, o valor retornado será diferente de zero.

Se a mensagem não tiver sido processada, o valor retornado será zero.

Comentários

Embora a função IsDialogMessage seja destinada a caixas de diálogo de modelagem, você pode usá-la com qualquer janela que contenha controles, permitindo que as janelas forneçam a mesma seleção de teclado usada em uma caixa de diálogo.

Quando IsDialogMessage processa uma mensagem, ela verifica se há mensagens de teclado e as converte em seleções para a caixa de diálogo correspondente. Por exemplo, a tecla TAB, quando pressionada, seleciona o próximo controle ou grupo de controles e a tecla SETA PARA BAIXO, quando pressionada, seleciona o próximo controle em um grupo.

Como a função IsDialogMessage executa toda a tradução e expedição necessárias de mensagens, uma mensagem processada por IsDialogMessage não deve ser passada para a função TranslateMessage ou DispatchMessage .

IsDialogMessage envia mensagens WM_GETDLGCODE para o procedimento da caixa de diálogo para determinar quais chaves devem ser processadas.

IsDialogMessage pode enviar mensagens DM_GETDEFID e DM_SETDEFID para a janela. Essas mensagens são definidas no arquivo de cabeçalho Winuser.h como WM_USER e WM_USER + 1, portanto, conflitos são possíveis com mensagens definidas pelo aplicativo com os mesmos valores.

Requisitos

Confira também

Conceitual

DM_GETDEFID

DM_SETDEFID

Caixas de diálogo

Dispatchmessage

MSG

Referência

TranslateMessage

WM_GETDLGCODE

WM_USER