Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
ON_COMMAND
TRY
Collapse the table of content
Expand the table of content

ON_COMMAND 

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.

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 for ON_COMMAND
BEGIN_MESSAGE_MAP( CMyDoc, CDocument )
    ON_COMMAND( ID_MYCMD, OnMyCommand )
    // ... More entries to handle additional commands
END_MESSAGE_MAP( )

Community Additions

ADD
Show:
© 2015 Microsoft