MFC ActiveX Controls: Adding Stock Events to an ActiveX Control

MFC ActiveX Controls: Adding Stock ...

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

MFC Library Reference

MFC ActiveX Controls: Adding Stock Events to an ActiveX Control

Stock events differ from custom events in that they are automatically fired by class COleControl. COleControl contains predefined member functions that fire events resulting from common actions. Some common actions implemented by COleControl include single- and double-clicks on the control, keyboard events, and changes in the state of the mouse buttons. Event map entries for stock events are always preceded by the EVENT_STOCK prefix.

Stock Events Supported by the Add Event Wizard

The COleControl class provides ten stock events, listed in the following table. You can specify the events you want in your control using the Add Event Wizard.

Stock Events

Event	Firing function	Comments
Click	void FireClick( )	Fired when the control captures the mouse, any BUTTONUP (left, middle, or right) message is received, and the button is released over the control. The stock MouseDown and MouseUp events occur before this event. Event map entry: EVENT_STOCK_CLICK( )
DblClick	void FireDblClick( )	Similar to Click but fired when a BUTTONDBLCLK message is received. Event map entry: EVENT_STOCK_DBLCLICK( )
Error	void FireError( SCODE scode, LPCSTR lpszDescription, UINT nHelpID = 0 )	Fired when an error occurs within your ActiveX control outside of the scope of a method call or property access. Event map entry: EVENT_STOCK_ERROREVENT( )
KeyDown	void FireKeyDown( short nChar, short nShiftState )	Fired when a WM_SYSKEYDOWN or WM_KEYDOWN message is received. Event map entry: EVENT_STOCK_KEYDOWN( )
KeyPress	void FireKeyPress( short* pnChar )	Fired when a WM_CHAR message is received. Event map entry: EVENT_STOCK_KEYPRESS( )
KeyUp	void FireKeyUp( short nChar, short nShiftState )	Fired when a WM_SYSKEYUP or WM_KEYUP message is received. Event map entry: EVENT_STOCK_KEYUP( )
MouseDown	void FireMouseDown( short nButton, short nShiftState, float x, float y )	Fired if any BUTTONDOWN (left, middle, or right) is received. The mouse is captured immediately before this event is fired. Event map entry: EVENT_STOCK_MOUSEDOWN( )
MouseMove	void FireMouseMove( short nButton, short nShiftState, float x, float y )	Fired when a WM_MOUSEMOVE message is received. Event map entry: EVENT_STOCK_MOUSEMOVE( )
MouseUp	void FireMouseUp( short nButton, short nShiftState, float x, float y )	Fired if any BUTTONUP (left, middle, or right) is received. The mouse capture is released before this event is fired. Event map entry: EVENT_STOCK_MOUSEUP( )
ReadyStateChange	void FireReadyStateChange( )	Fired when a control transitions to the next ready state due to the amount of data received. Event map entry: EVENT_STOCK_READYSTATECHANGE( )

Adding a Stock Event Using the Add Event Wizard

Adding stock events requires less work than adding custom events because the firing of the actual event is handled automatically by the base class, COleControl. The following procedure adds a stock event to a control that was developed using MFC ActiveX Control Wizard. The event, called KeyPress, fires when a key is pressed and the control is active. This procedure can also be used to add other stock events. Substitute the selected stock event name for KeyPress.

To add the KeyPress stock event using the Add Event Wizard

Load your control's project.
In Class View, right-click your ActiveX control class to open the shortcut menu.
From the shortcut menu, click Add and then click Add Event.
This opens the Add Event Wizard.
In the Event Name drop-down list, select KeyPress.
Click Finish.

Add Event Wizard Changes for Stock Events

Because stock events are handled by the control's base class, the Add Event Wizard does not change your class declaration in any way. It adds the event to the control's event map and makes an entry in its .IDL file. The following line is added to the control's event map, located in the control class implementation (.CPP) file:

Visual C++

EVENT_STOCK_KEYPRESS()

Adding this code fires a KeyPress event when a WM_CHAR message is received and the control is active. The KeyPress event can be fired at other times by calling its firing function (for example, FireKeyPress) from within the control code.

The Add Event Wizard adds the following line of code to the control's .IDL file:

Visual C++

[id(DISPID_KEYPRESS)] void KeyPress(SHORT* KeyAscii);

This line associates the KeyPress event with its standard dispatch ID and allows the container to anticipate the KeyPress event.

Concepts

MFC ActiveX Controls

MFC ActiveX Controls: Methods

Reference

COleControl Class