IsDialogMessage

9/9/2008

Essa função determina se uma mensagem é destinada a caixa diálogo especificado e, se for, processa a mensagem.

Syntax

BOOL IsDialogMessage( 
  HWND hDlg, 
  LPMSG lpMsg
); 

Parameters

• hDlg
  [no] Tratar a caixa de diálogo.

• lpMsg
  [no] Ponteiro longo para um MSG estrutura que contém a mensagem a ser verificado.

Return Value

Nonzero indica que a mensagem tiver sido processada. Zero indica que a mensagem não foi processada.

Remarks

Embora o IsDialogMessage função destina-se de sem janela restrita caixas diálogo, você pode usá-lo com qualquer janela que contém controles, habilitando as janelas fornecer a mesma teclado seleção como é usado em uma caixa diálogo.

Se um personalizado, janela diálogo Application-defined é usada com essa função, seu nome classe deve ser DIALOG. Ou, sua classe deve ser registrado com o cbWndExtra membro das WNDCLASS estrutura definida como um valor igual a ou maior que o cbWndExtra valor obtida por um chamar para o GetClassInfo função sobre o sistema classe DIALOG.

Quando IsDialogMessage Processos uma mensagem, ele verifica para teclado mensagens e converte-los em seleções para o correspondente caixa diálogo. De exemplo, o tecla TAB, quando pressionada, seleciona o próximo controle ou GRUPO de controles e a chave seta para baixo, quando pressionada, seleciona o próximo controle em um GRUPO.

Porque o IsDialogMessage função executa todas as convertendo necessárias e distribuindo de mensagens, uma mensagem processada pelo IsDialogMessage Não deve ser passado para o TranslateMessage Ou DispatchMessage função.

IsDialogMessage Envia WM_GETDLGCODE mensagens para o procedimento caixa de diálogo para determinar quais teclas devem ser processadas.

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

Requirements

Header	winuser.h
Library	Dlgmgr.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

DispatchMessage
TranslateMessage
DM_GETDEFID
DM_SETDEFID
WM_GETDLGCODE
WM_USER
MSG
WNDCLASS
Dialog Boxes Functions