Função DefMDIChildProcW (winuser.h)

Artigo
11/20/2024

Fornece processamento padrão para qualquer mensagem de janela que o procedimento de janela de uma janela filho MDI (interface de vários documentos) não processa. Uma mensagem de janela não processada pelo procedimento de janela deve ser passada para a função de DefMDIChildProc, não para a função de DefWindowProc.

Sintaxe

LRESULT LRESULT DefMDIChildProcW(
  [in] HWND   hWnd,
  [in] UINT   uMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Parâmetros

[in] hWnd

Tipo: HWND

Um identificador para a janela filho do MDI.

[in] uMsg

Tipo: UINT

A mensagem a ser processada.

[in] wParam

Tipo: WPARAM

Informações adicionais específicas da mensagem.

[in] lParam

Tipo: LPARAM

Informações adicionais específicas da mensagem.

Valor de retorno

Tipo: LRESULT

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

Observações

A função DefMDIChildProc pressupõe que a janela pai da janela filho do MDI identificada pelo parâmetro hWnd foi criada com a classe MDICLIENT .

Quando o procedimento de janela de um aplicativo não manipula uma mensagem, ele normalmente passa a mensagem para a função DefWindowProc para processar a mensagem. Os aplicativos MDI usam as funções DefFrameProc e DefMDIChildProc em vez de DefWindowProc para fornecer processamento de mensagens padrão. Todas as mensagens que um aplicativo normalmente passaria para DefWindowProc (como mensagens nãoclientes e a mensagem WM_SETTEXT) devem ser passadas para DefMDIChildProc. Além disso, DefMDIChildProc também manipula as mensagens a seguir.

Mensagem	Resposta
WM_CHILDACTIVATE	Executa o processamento de ativação quando janelas filho MDI são dimensionadas, movidas ou exibidas. Essa mensagem deve ser passada.
WM_GETMINMAXINFO	Calcula o tamanho de uma janela filho MDI maximizada, com base no tamanho atual da janela do cliente MDI.
WM_MENUCHAR	Passa a mensagem para a janela do quadro MDI.
WM_MOVE	Recalcula as barras de rolagem do cliente MDI se elas estiverem presentes.
WM_SETFOCUS	Ativa a janela filho se ela não for a janela filho MDI ativa.
WM_SIZE	Executa operações necessárias para alterar o tamanho de uma janela, especialmente para maximizar ou restaurar uma janela filho MDI. A falha ao passar essa mensagem para a função DefMDIChildProc produz resultados altamente indesejáveis.
WM_SYSCOMMAND	Manipula comandos de menu de janela: SC_NEXTWINDOW, SC_PREVWINDOW, SC_MOVE, SC_SIZEe SC_MAXIMIZE.

Nota

O cabeçalho winuser.h define DefMDIChildProc como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll