Função DefFrameProcA (winuser.h)

Artigo
08/27/2023

Fornece processamento padrão para qualquer mensagem de janela que o procedimento de janela de uma janela de quadro de MDI (interface de vários documentos) não processe. Todas as mensagens de janela que não são processadas explicitamente pelo procedimento de janela devem ser passadas para a função DefFrameProc , não para a função DefWindowProc .

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela de quadro MDI.

[in] hWndMDIClient

Digite: HWND

Um identificador para a janela do cliente MDI.

[in] uMsg

Tipo: UINT

A mensagem a ser processada.

[in] wParam

Tipo: WPARAM

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

[in] lParam

Tipo: LPARAM

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

Retornar valor

Tipo: LRESULT

O valor retornado especifica o resultado do processamento da mensagem e depende da mensagem. Se o parâmetro hWndMDIClient for NULL, o valor retornado será o mesmo que para a função DefWindowProc .

Comentários

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 o processamento de mensagens padrão. Todas as mensagens que um aplicativo normalmente passaria para DefWindowProc (como mensagens não cliente e a mensagem WM_SETTEXT ) devem ser passadas para DefFrameProc . A função DefFrameProc também manipula as mensagens a seguir.

Mensagem	Resposta
WM_COMMAND	Ativa a janela filho MDI que o usuário escolhe. Essa mensagem é enviada quando o usuário escolhe uma janela filho MDI no menu de janela da janela do quadro MDI. O identificador de janela que acompanha essa mensagem identifica a janela filho MDI a ser ativada.
WM_MENUCHAR	Abre o menu de janela da janela filho MDI ativa quando o usuário pressiona a combinação de teclas ALT+ – (menos).
WM_SETFOCUS	Passa o foco do teclado para a janela do cliente MDI, que, por sua vez, o passa para a janela filho MDI ativa.
WM_SIZE	Redimensiona a janela do cliente MDI para caber na área de cliente da nova janela de quadro. Se o procedimento da janela de quadro dimensionar a janela do cliente MDI para um tamanho diferente, ele não deverá passar a mensagem para a função DefWindowProc .

Observação

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

Requisitos

Requisito	Valor
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