共用方式為


CCmdTarget Class

The base class for the Microsoft Foundation Class Library message-map architecture.

class CCmdTarget : public CObject

Members

Public Constructors

Name

Description

CCmdTarget::CCmdTarget

Constructs a CCmdTarget object.

Public Methods

Name

Description

CCmdTarget::BeginWaitCursor

Displays the cursor as an hourglass cursor.

CCmdTarget::DoOleVerb

Causes an action specified by an OLE verb to be performed.

CCmdTarget::EnableAutomation

Allows OLE automation for the CCmdTarget object.

CCmdTarget::EnableConnections

Enables event firing over connection points.

CCmdTarget::EnableTypeLib

Enables an object's type library.

CCmdTarget::EndWaitCursor

Returns to the previous cursor.

CCmdTarget::EnumOleVerbs

Enumerates an object's OLE verbs.

CCmdTarget::FromIDispatch

Returns a pointer to the CCmdTarget object associated with the IDispatch pointer.

CCmdTarget::GetDispatchIID

Gets the primary dispatch interface ID.

CCmdTarget::GetIDispatch

Returns a pointer to the IDispatch object associated with the CCmdTarget object.

CCmdTarget::GetTypeInfoCount

Retrieves the number of type information interfaces that an object provides.

CCmdTarget::GetTypeInfoOfGuid

Retrieves the type description that corresponds to the specified GUID.

CCmdTarget::GetTypeLib

Gets a pointer to a type library.

CCmdTarget::GetTypeLibCache

Gets the type library cache.

CCmdTarget::IsInvokeAllowed

Enables automation method invocation.

CCmdTarget::IsResultExpected

Returns nonzero if an automation function should return a value.

CCmdTarget::OnCmdMsg

Routes and dispatches command messages.

CCmdTarget::OnFinalRelease

Cleans up after the last OLE reference is released.

CCmdTarget::RestoreWaitCursor

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

CObject

CCmdTarget

Requirements

Header: afxwin.h

See Also

Reference

CObject Class

Hierarchy Chart

CCmdUI Class

CDocument Class

CDocTemplate Class

CWinApp Class

CWnd Class

CView Class

CFrameWnd Class

COleDispatchDriver Class

Concepts

MFC Sample ACDUAL