This macro maps a command message to a member function.

ON_COMMAND(id, memberFxn )

Parameters

id

The command ID.

memberFxn

The name of the message-handler function to which the command is mapped.

Remarks

It indicates which function will handle a command message from a command user-interface object such as a menu item or toolbar button.

When a command-target object receives a Windows WM_COMMAND message with the specified ID, ON_COMMAND will call the member function memberFxn to handle the message.

Use ON_COMMAND to map a single command to a member function. Use ON_COMMAND_RANGE to map a range of command ids to one member function. Only one message-map entry can match a given command id. That is, you can't map a command to more than one handler. For more information and examples, see Message Handling and Mapping Topics.

Example

// example for ON_COMMAND
BEGIN_MESSAGE_MAP( CMyDoc, CDocument )
    ON_COMMAND( ID_MYCMD, OnMyCommand )
    // ... More entries to handle additional commands
END_MESSAGE_MAP( )

See Also

MFC Macros and Globals | ON_UPDATE_COMMAND_UI