Handlers for Commands and Control Notifications

|  Overview |  How Do I | 

There are no default handlers for commands or control-notification messages. Therefore, you are bound only by convention in naming your handlers for these categories of messages. When you map the command or control notification to a handler, ClassWizard proposes a name based on the command ID or control-notification code. You can accept the proposed name, change it, or replace it.

Convention suggests that you name handlers in both categories for the user-interface object they represent. Thus a handler for the Cut command on the Edit menu might be named

afx_msg void OnEditCut();

Because the Cut command is so commonly implemented in applications, the framework predefines the command ID for the Cut command as ID_EDIT_CUT. For a list of all predefined command IDs, see the file AFXRES.H. For more information, see Standard Commands.

In addition, convention suggests a handler for the BN_CLICKED notification message from a button labeled “Use As Default” might be named

afx_msg void OnClickedUseAsDefault();

You might assign this command an ID of IDC_USE_AS_DEFAULT because it is equivalent to an application-specific user-interface object.

Both categories of messages take no arguments and return no value.