CCmdTarget Class
The base class for the Microsoft Foundation Class Library message-map architecture.
class CCmdTarget : public CObject
Members
Public Constructors
Name |
Description |
|---|---|
Constructs a CCmdTarget object. |
Public Methods
Name |
Description |
|---|---|
Displays the cursor as an hourglass cursor. |
|
Causes an action specified by an OLE verb to be performed. |
|
Allows OLE automation for the CCmdTarget object. |
|
Enables event firing over connection points. |
|
Enables an object's type library. |
|
Returns to the previous cursor. |
|
Enumerates an object's OLE verbs. |
|
Returns a pointer to the CCmdTarget object associated with the IDispatch pointer. |
|
Gets the primary dispatch interface ID. |
|
Returns a pointer to the IDispatch object associated with the CCmdTarget object. |
|
Retrieves the number of type information interfaces that an object provides. |
|
Retrieves the type description that corresponds to the specified GUID. |
|
Gets a pointer to a type library. |
|
Gets the type library cache. |
|
Enables automation method invocation. |
|
Returns nonzero if an automation function should return a value. |
|
Routes and dispatches command messages. |
|
Cleans up after the last OLE reference is released. |
|
Restores the hourglass cursor. |
Remarks
A message map routes commands or messages to the member functions you write to handle them. (A command is a message from a menu item, command button, or accelerator key.)
Key framework classes derived from CCmdTarget include CView, CWinApp, CDocument, CWnd, and CFrameWnd. If you intend for a new class to handle messages, derive the class from one of these CCmdTarget-derived classes. You will rarely derive a class from CCmdTarget directly.
For an overview of command targets and OnCmdMsg routing, see Command Targets, Command Routing, and Mapping Messages.
CCmdTarget includes member functions that handle the display of an hourglass cursor. Display the hourglass cursor when you expect a command to take a noticeable time interval to execute.
Dispatch maps, similar to message maps, are used to expose OLE automation IDispatch functionality. By exposing this interface, other applications (such as Visual Basic) can call into your application.
Inheritance Hierarchy
CCmdTarget
Requirements
Header: afxwin.h