SAMPLE: Deriving an OLE Control from a Base ControlID: Q138411
|
The SHAPES sample illustrates how to derive an OLE control from a base
control thus allowing the derived control to take advantage of the base
control's methods, properties, and events.
The following file is available for download from the Microsoft Software
Library:
Shapes2.exeFor more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:
Q119591 How to Obtain Microsoft Support Files from Online Services
The Shapes2 sample implements a base control class called CBaseShapeCtrl and two derived control classes called CCircleCtrl and CRectangleCtrl. CCircleCtrl and CRectangleCtrl draw themselves using the properties provided by the base CBaseShapeCtrl class. CCircleCtrl and CRectangleCtrl also allow access to the methods and events implemented in the base CBaseShapeCtrl class.
Name Type Use
FillColor Property An OLE_COLOR value that represents the color
used to fill the shape.
LineColor Property An OLE_COLOR value that represents the color
used for the shape's outline.
LineWidth Property A short value that represents the line width
in pixels of the shape's outline.
BaseMethod1 Method A test method that, when invoked, fires the
BaseEvent1 event. Takes a single parameter of
type long.
BaseMethod2 Method A test method that, when invoked, fires the
BaseEvent2 event. Takes a single parameter of
type BSTR.
BaseEvent1 Event A test event. Returns a long.
BaseEvent2 Event A test event. Returns a BSTR.
Name Type Use
CircleShape Property A boolean value. If TRUE, the control draws
itself as a circle. If FALSE, it draws itself
as an ellipse.
CircleOffset Property A short value that represents the number of
pixels offset from the center of the bounding
rectangle where the control will draw itself.
CircleMethod1 Method A test method that, when invoked, fires the
CircleEvent1 event. Takes a single parameter
of type long.
CircleMethod2 Method A test method that, when invoked, fires the
CircleEvent2 event. Takes a single parameter
of type long.
CircleEvent1 Event A test event. Returns a long.
CircleEvent2 Event A test event. Returns a long.
Name Type Use
RoundedCorners Property A boolean value. If TRUE, the control draws
itself with rounded corners. If FALSE, it
draws itself with square corners.
RectangleInset Property A short value that represents the number of
pixels inside the control's bounding
rectangle where the control will inset itself.
RectMethod1 Method A test method that, when invoked, fires the
RectEvent1 event. Takes no parameters.
RectMethod2 Method A test method that, when invoked, fires the
RectEvent2 event. Takes no parameters.
RectEvent1 Event A test event. Returns void.
RectEvent2 Event A test event. Returns void.
BEGIN_MESSAGE_MAP(CBaseShapeCtrl, COleControl)
//{{AFX_MSG_MAP(CBaseShapeCtrl)
//}}AFX_MSG_MAP
//ON_OLEVERB(AFX_IDS_VERB_PROPERTIES, OnProperties)
END_MESSAGE_MAP()
BOOL CBaseShapeCtrl::CBaseShapeCtrlFactory::UpdateRegistry(
BOOL bRegister)
{
return TRUE;
}
BOOL CBaseShapePropPage::CBaseShapePropPageFactory::UpdateRegistry(
BOOL bRegister)
{
return TRUE;
}
CBaseShapeCtrl::CBaseShapeCtrl()
{
//InitializeIIDs(&IID_DBaseShape, &IID_DBaseShapeEvents);
// TODO: Initialize your control's instance data here.
}
void CBaseShapeCtrl::DoPropExchange(CPropExchange* pPX)
{
// ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
COleControl::DoPropExchange(pPX);
...
}
void CCircleCtrl::DoPropExchange(CPropExchange* pPX)
{
ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
CBaseShapeCtrl::DoPropExchange(pPX);
...
}
// Primary dispatch interface for CCircleCtrl
[ uuid(A7EC6760-BFED-11CE-8250-524153480001),
helpstring("Dispatch interface for sample Circle Control"), hidden ]
dispinterface _DCircle
{
properties:
// NOTE - ClassWizard will maintain property information here.
// Use extreme caution when editing this section.
//{{AFX_ODL_PROP(CCircleCtrl)
[id(0x10001)] OLE_COLOR FillColor;
[id(0x10002)] OLE_COLOR LineColor;
[id(0x10003)] short LineWidth;
[id(1)] boolean CircleShape;
[id(2)] short CircleOffset;
//}}AFX_ODL_PROP
...
[ uuid(A7EC6761-BFED-11CE-8250-524153480001),
helpstring("Event interface for sample Circle Control") ]
dispinterface _DCircleEvents
{
properties:
// Event interface has no properties
methods:
// NOTE - ClassWizard will maintain event information here.
// Use extreme caution when editing this section.
//{{AFX_ODL_EVENT(CCircleCtrl)
[id(1)] void BaseEvent1(long lParam);
[id(2)] void BaseEvent2(BSTR pszString);
[id(3)] void CircleEvent1(long lParam);
[id(4)] void CircleEvent2(long lParam);
//}}AFX_ODL_EVENT
};
class CCircleCtrl : public CBaseShapeCtrl
{
...
// Dispatch and event IDs
public:
enum {
//{{AFX_DISP_ID(CCircleCtrl)
//dispidFillColor = 65537L,
//dispidLineColor = 65538L,
//dispidLineWidth = 65539L,
//dispidBaseMethod1 = 65540L,
//dispidBaseMethod2 = 65541L,
dispidCircleShape = 1L,
dispidCircleOffset = 2L,
dispidCircleMethod1 = 3L,
dispidCircleMethod2 = 4L,
//eventidBaseEvent1 = 1L,
//eventidBaseEvent2 = 2L,
eventidCircleEvent1 = 3L,
eventidCircleEvent2 = 4L,
//}}AFX_DISP_ID
};
Shapes.odl -
Shows the modified DISPIDs used by the derived control classes.
Basectl.cpp -
Provides the implementation of the base CBaseShapeCtrl class.
Circctl.cpp -
Provides the implementation of the derived CCircleCtrl class.
Rectctl.cpp -
Provides the implementation of the derived CRectangleCtrl class. MFC Technical Note #39.
Additional query words: 2.00 2.10 2.20 2.50 2.51 2.52 3.00 3.10 3.20 shapes32
Keywords :
Version : 1.0 1.1 1.2
Platform :
Issue type : Last Reviewed: August 5, 1999