Função DefDlgProcW (winuser.h)

Artigo
08/27/2023

Chama o procedimento de janela da caixa de diálogo padrão para fornecer processamento padrão para todas as mensagens de janela que uma caixa de diálogo com uma classe de janela privada não processa.

Sintaxe

LRESULT LRESULT DefDlgProcW(
  [in] HWND   hDlg,
  [in] UINT   Msg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parâmetros

[in] hDlg

Digite: HWND

Um identificador para a caixa de diálogo.

[in] Msg

Tipo: UINT

A mensagem.

[in] wParam

Tipo: WPARAM

Obter informações adicionais específicas de mensagem.

[in] lParam

Tipo: LPARAM

Obter informações adicionais específicas de mensagem.

Valor retornado

Tipo: LRESULT

O valor retornado especifica o resultado do processamento da mensagem e depende da mensagem enviada.

Comentários

A função DefDlgProc é o procedimento de janela para a classe predefinida da caixa de diálogo. Este procedimento fornece processamento interno para a caixa de diálogo encaminhando mensagens para o procedimento da caixa de diálogo e realizando o processamento padrão para todas as mensagens que o procedimento da caixa de diálogo retorna como FALSE. Os aplicativos que criam procedimentos de janela personalizados para suas caixas de diálogo personalizadas geralmente usam DefDlgProc em vez da função DefWindowProc para realizar o processamento de mensagens padrão.

Os aplicativos criam classes de caixa de diálogo personalizadas preenchendo uma estrutura WNDCLASS com informações apropriadas e registrando a classe com a função RegisterClass . Alguns aplicativos preenchem a estrutura usando a função GetClassInfo , especificando o nome da caixa de diálogo predefinida. Nesses casos, os aplicativos modificam pelo menos o membro lpszClassName antes de se registrarem. Em todos os casos, o membro cbWndExtra do WNDCLASS para uma classe de caixa de diálogo personalizada deve ser definido como pelo menos DLGWINDOWEXTRA.

A função DefDlgProc não deve ser chamada por um procedimento de caixa de diálogo; fazer isso resulta em execução recursiva.

Requisitos


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	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll