TN024: mensagens e recursos definidos pelo MFC
Observação
A nota técnica a seguir não foi atualizada desde que foi incluída pela primeira vez na documentação online. Como resultado, alguns procedimentos e tópicos podem estar desatualizados ou incorretos. Para obter as informações mais recentes, é recomendável que você pesquise o tópico de interesse no índice de documentação online.
Esta nota descreve as mensagens internas do Windows e os formatos de recurso usados pelo MFC. Essas informações explicam a implementação da estrutura e ajudarão a depurar o aplicativo. Para os aventureiros, embora todas essas informações não tenha suporte oficial, você pode usar algumas dessas informações para implementações avançadas.
Essa observação contém detalhes da implementação privada do MFC. Todo o conteúdo está sujeito a alterações no futuro. As mensagens privadas do Windows no MFC têm significado apenas no escopo de um aplicativo, mas serão alteradas no futuro para conter mensagens em todo o sistema.
O intervalo de mensagens privadas do Windows e os tipos de recursos do MFC estão no intervalo de "sistema" reservado pelo Microsoft Windows. No momento, nem todos os números nos intervalos são usados e, no futuro, novos números no intervalo podem ser usados. Os números usados atualmente podem ser alterados.
As mensagens privadas do Windows no MFC estão no intervalo 0x360-0x37F>.
Os tipos de recursos privados do MFC estão no intervalo 0xF0-0xFF>.
Mensagens privadas do Windows no MFC
Essas mensagens do Windows são usadas no lugar das funções virtuais C++, em que o acoplamento relativamente solto é necessário entre objetos de janela e onde uma função virtual C++ não seria apropriada.
Essas mensagens privadas do Windows e estruturas de parâmetro associadas são declaradas no cabeçalho privado do MFC 'AFXPRIV. H'. Lembre-se de que qualquer um dos códigos que inclua esse cabeçalho pode estar dependendo de um comportamento não documentado e provavelmente será interrompido nas versões futuras do MFC.
No caso raro de necessidade de lidar com uma dessas mensagens, você deve usar a macro de mapa de mensagens ON_MESSAGE e tratar a mensagem no formato genérico LRESULT/WPARAM/LPARAM.
WM_QUERYAFXWNDPROC
Esta mensagem é enviada para uma janela que está sendo criada. Ela é enviada muito antecipadamente no processo de criação como método para determinar se o WndProc é AfxWndProc. AfxWndProc retorna 1.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado |
| lParam | Não usado |
| returns | 1, se processado por AfxWndProc |
WM_SIZEPARENT
Esta mensagem é enviada por uma janela com moldura para os filhos imediatos durante o redimensionamento (CFrameWnd::OnSize chama CFrameWnd::RecalcLayout que chama CWnd::RepositionBars), para reposicionar as barras de controle ao redor da lateral do quadro. A estrutura AFX_SIZEPARENTPARAMS contém o retângulo do cliente disponível atual do pai e um HDWP (que pode ser NULL) com o qual DeferWindowPos de ser chamado para minimizar novas pinturas.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado |
| lParam | Endereço de uma estrutura AFX_SIZEPARENTPARAMS |
| returns | Não usado (0) |
Ignorar a mensagem indica que a janela não faz parte do layout.
WM_SETMESSAGESTRING
Esta mensagem é enviada para uma janela com moldura, para solicitar que atualize a linha de mensagem na barra de status. Uma ID de cadeia de caracteres ou um LPCSTR pode ser especificado (mas não ambos).
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | ID da cadeia de caracteres (ou zero) |
| lParam | LPCSTR para a cadeia de caracteres (ou NULL) |
| returns | Não usado (0) |
WM_IDLEUPDATECMDUI
Esta mensagem é enviada em tempo ocioso para implementar a atualização de tempo ocioso dos manipuladores de interface do usuário de comando de atualização. Se a janela (geralmente uma barra de controle) tratar a mensagem, criará um objeto CCmdUI (ou um objeto de uma classe derivada) e chamará CCmdUI::DoUpdate para cada um dos "itens" na janela. Isso, por sua vez, verificará se há um manipulador ON_UPDATE_COMMAND_UI para os objetos na cadeia de manipuladores de comandos.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | BOOL bDisableIfNoHandler |
| lParam | Não usado (0) |
| returns | Não usado (0) |
bDisableIfNoHandler é um valor diferente de zero para desabilitar o objeto de interface do usuário, se não houver um manipulador ON_UPDATE_COMMAND_UI nem um ON_COMMAND.
WM_EXITHELPMODE
Esta mensagem é postada em um CFrameWnd para sair do modo de ajuda confidencial do contexto. O recebimento dessa mensagem termina o loop modal iniciado por CFrameWnd::OnContextHelp.
| Parâmetro e valor de retorno | Descrição |
|---|---|
| wParam | Não usado (0) |
| lParam | Não usado (0) |
| returns | Não usado |
WM_INITIALUPDATE
Esta mensagem é enviada pelo modelo de documento para todos os descendentes de uma janela com moldura, quando é seguro realizar a atualização inicial. Ela é mapeada para uma chamada para CView::OnInitialUpdate, mas pode ser usada em outras classes derivadas de CWnd para outra atualização única.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado (0) |
| lParam | Não usado (0) |
| returns | Não usado (0) |
WM_RECALCPARENT
Esta mensagem é enviada por um modo de exibição para a janela pai (obtida por meio de GetParent), para forçar o novo cálculo de layout (geralmente, o pai chamará RecalcLayout). Ela é usada em aplicativos de servidor OLE em que é necessário aumentar o tamanho do quadro, à medida que o tamanho total do modo de exibição aumenta.
Se a janela pai processar essa mensagem, ela deverá retornar TRUE e preencher o RECT passado em lParam com o novo tamanho da área do cliente. Isso é usado em CScrollView para tratar corretamente as barras de rolagem (coloque-as na parte externa da janela, quando forem adicionadas), quando um objeto de servidor é ativado no local.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado (0) |
| lParam | LPRECT rectClient, pode ser NULL |
| returns | TRUE, se o novo retângulo do cliente for retornado. Caso contrário, FALSE |
WM_SIZECHILD
Esta mensagem é enviada por COleResizeBar para a janela do proprietário (por meio do GetOwner), quando o usuário redimensiona a barra de redimensionamento com os identificadores de redimensionamento. COleIPFrameWnd responde a essa mensagem tentando reposicionar a janela com moldura como o usuário solicitou.
O novo retângulo, fornecido nas coordenadas do cliente em relação à janela com moldura que contém a barra de redimensionamento, é apontado por lParam.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado (0) |
| lParam | LPRECT rectNew |
| returns | Não usado (0) |
WM_DISABLEMODAL
Esta mensagem é enviada para todas as janelas pop-up pertencentes a uma janela com moldura que está sendo desativada. A janela com moldura usa o resultado para determinar se a janela pop-up deve ser desabilitada.
Você pode usar isso para executar o processamento especial na janela pop-up, quando o quadro entrar em um estado modal ou para impedir que determinadas janelas pop-up sejam desabilitadas. As dicas de ferramenta usam essa mensagem para se destruir, quando a janela com moldura entra em um estado modal, por exemplo.
| Parâmetros e valores retornados | Descrição |
|---|---|
| wParam | Não usado (0) |
| lParam | Não usado (0) |
| returns | Um valor diferente de zero para NÃO desabilitar a janela. 0 indica que a janela será desabilitada |
WM_FLOATSTATUS
Esta mensagem é enviada para todas as janelas pop-up pertencentes a uma janela com moldura, quando o quadro é ativado ou desativado por outra janela com moldura de nível superior. Ela é usada pela implementação do MFS_SYNCACTIVE no CMiniFrameWnd, para manter a ativação dessas janelas pop-up em sincronia com a ativação da janela com moldura de nível superior.
| Parâmetros | Descrição |
|---|---|
| wParam | É um dos seguintes valores: FS_SHOW FS_HIDE FS_ACTIVATE FS_DEACTIVATE FS_ENABLEFS_DISABLE FS_SYNCACTIVE |
| lParam | Não usado (0) |
O valor retornado deverá ser diferente de zero, se FS_SYNCACTIVE estiver definido e a janela sincronizar a ativação com o quadro pai. CMiniFrameWnd retorna um valor diferente de zero, quando o estilo é definido como MFS_SYNCACTIVE.
Para obter mais informações, confira a implementação do CMiniFrameWnd.
WM_ACTIVATETOPLEVEL
Esta mensagem é enviada para uma janela de nível superior, quando uma janela no "grupo de nível superior" é ativada ou desativada. Uma janela faz parte de um grupo de nível superior, se for uma janela de nível superior (sem pai nem proprietário) ou pertencer a essa janela. O uso dessa mensagem é semelhante a WM_ACTIVATEAPP, mas ela funciona em situações em que janelas pertencentes a processos diferentes são misturadas em uma única hierarquia de janela (comum em aplicativos OLE).
WM_COMMANDHELP, WM_HELPHITTEST, WM_EXITHELPMODE
Estas mensagens são usadas na implementação da Ajuda sensível ao contexto. Veja a Observação Técnica 28, para obter mais informações.
Formatos de Recursos Privados do MFC
No momento, o MFC define dois formatos de recursos privados: RT_TOOLBAR e RT_DLGINIT.
Formato de Recurso RT_TOOLBAR
A barra de ferramentas padrão fornecida pelo AppWizard baseia-se em um recurso personalizado RT_TOOLBAR, que foi introduzido no MFC 4.0. Você pode editar esse recurso usando o editor de barra de ferramentas.
Formato de Recurso RT_DLGINIT
Um formato de recurso privado do MFC é usado para armazenar informações adicionais de inicialização da caixa de diálogo. Isso inclui as cadeias de caracteres iniciais armazenadas em uma caixa de combinação. O formato desse recurso não foi criado para ser editado manualmente, mas é tratado pelo Visual C++.
O Visual C++ e esse recurso RT_DLGINIT não são necessários para usar os recursos relacionados do MFC, pois há uma alternativa de API para usar as informações no recurso. O uso do Visual C++ facilita muito a gravação, manutenção e tradução do aplicativo no longo prazo.
A estrutura básica de um recurso RT_DLGINIT é a seguinte:
+---------------+ \
| Control ID | UINT |
+---------------+ |
| Message # | UINT |
+---------------+ |
|length of data | DWORD |
+---------------+ | Repeated
| Data | Variable Length | for each control
| ... | and Format | and message
+---------------+ /
| 0 | BYTE
+---------------+
Uma seção repetida contém a ID de controle para enviar a mensagem, o nº da Mensagem a ser enviada (uma mensagem normal do Windows) e um tamanho variável dos dados. A mensagem do Windows é enviada em um formulário:
SendDlgItemMessage(<Control ID>, <Message #>, 0, &<Data>);
Este é um formato muito geral, que permite qualquer conteúdo de dados e mensagens do Windows. O editor de recursos do Visual C++ e o MFC dão suporte apenas a um subconjunto limitado de mensagens do Windows: CB_ADDSTRING para as opções de lista iniciais para caixas de combinação (os dados são uma cadeia de caracteres de texto).
Confira também
Observações técnicas por número
Observações técnicas por categoria
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de