Sdílet prostřednictvím


MESSAGE_HANDLER

Definuje položku mapy zprávy.

MESSAGE_HANDLER( 
   msg, 
   func  
)

Parametry

  • msg
    [v] Zprávy systému Windows.

  • func
    [v] Název funkce zpracování zprávy.

Poznámky

MESSAGE_HANDLERZadaný popisovač funkce mapuje zprávy systému Windows.

Všechny funkce v MESSAGE_HANDLER makra musí být definována takto:

LRESULT MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled);

Nastaví mapu zpráva bHandled na TRUE před MessageHandler se nazývá.Pokud MessageHandler plně nezpracovává zprávy, měli nastavit bHandled na FALSE označit zprávu zapotřebí dalšího zpracování.

[!POZNÁMKA]

Vždy začít zpráva mapa s BEGIN_MSG_MAP.Potom můžete deklarovat mapy následující alternativní zprávu s ALT_MSG_MAP.END_MSG_MAP makro označuje konec zprávy mapy.Mapa každé zprávy musí mít přesně jeden výskyt BEGIN_MSG_MAP a END_MSG_MAP .

Kromě MESSAGE_HANDLER , můžete použít COMMAND_HANDLER a NOTIFY_HANDLER mapování WM_COMMAND a WM_NOTIFY zprávy, resp..

Další informace o použití mapy zprávy v ATL naleznete Zpráva mapuje.

Příklad

class CMyBaseWindow : public CWindowImpl<CMyBaseWindow>
{
public:
   BEGIN_MSG_MAP(CMyBaseWindow)
      MESSAGE_HANDLER(WM_CREATE, OnCreate)
   END_MSG_MAP()

   // When a CMyBaseWindow object receives a WM_CREATE message, the message
   // is directed to CMyBaseWindow::OnCreate for the actual processing.
   LRESULT OnCreate(UINT /*nMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
      BOOL& /*bHandled*/)
   {
      return 0;   
   }
};

Požadavky

Záhlaví: atlwin.h

Viz také

Referenční dokumentace

MESSAGE_RANGE_HANDLER

Další zdroje

Zpráva mapa makra (ATL)

Makra ATL