Mapping Messages to Functions
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

Mapping Messages to Functions

The Properties window enables you to bind message handlers (member functions of MFC user-interface classes) to the messages generated by your application's resources. They use MFC message maps to create the binding.

When you use Class View to create a new class derived from one of the framework classes, it automatically places a complete and functional class in the header (.h) and implementation (.cpp) files that you specify.

Note   To add a new class that does not handle messages, create the class directly in the text editor.

To define or remove a message handler using the Properties window

  1. In Class View, click the class.
  2. In the Properties window, click the Messages button.
    Note   The Messages button is available when you select either the class name in Class View or when you click within the source window.

    If your project has a handler for a message, then the name of the handler appears in the right column next to the message.

  3. If the message has no handler, then click the cell in the right column in the Properties window to display the suggested name of the handler as <add>HandlerName. (For example, the WM_TIMER message handler suggests <add>OnTimer).
  4. Click the suggested name to add stub code for the function.
  5. To edit a message handler, double-click the message in Class View and edit the code in the source window.

To remove a message handler, double-click the handler in the right column and select <delete>HandlerName. The function's code is commented out.

See Also

Adding a Message Handler | Working with Classes | Adding a Class | Adding a Member Function | Adding a Member Variable | Overriding a Virtual Function | Adding Event Handlers for Dialog Box Controls | Navigating the Class Structure

© 2015 Microsoft