DECLARE_DISPATCH_MAP

  • Article

 

If a CCmdTarget-derived class in your program supports OLE Automation, that class must provide a dispatch map to expose its methods and properties.

Syntax

DECLARE_DISPATCH_MAP( )

Remarks

Use the DECLARE_DISPATCH_MAP macro at the end of your class declaration. Then, in the .CPP file that defines the member functions for the class, use the BEGIN_DISPATCH_MAP macro. Then include macro entries for each of your class's exposed methods and properties (DISP_FUNCTION, DISP_PROPERTY, and so on). Finally, use the END_DISPATCH_MAP macro.

Note

If you declare any members after DECLARE_DISPATCH_MAP, you must specify a new access type (public, private, or protected) for them.

The Application Wizard and code wizards assist in creating Automation classes and in maintaining dispatch maps. For more information on dispatch maps, see Automation Servers.

Example

class CMyServerDoc : public COleServerDoc
{
   DECLARE_DISPATCH_MAP()

   // Remainder of class declaration omitted.

Requirements

Header: afxwin.h

See Also

MFC Macros and Globals
Dispatch Maps
BEGIN_DISPATCH_MAP
END_DISPATCH_MAP
DISP_FUNCTION
DISP_PROPERTY
DISP_PROPERTY_EX
DISP_DEFVALUE