添加自定义事件

文章目录

添加自定义事件

前言
通过添加事件向导添加的自定义事件

使用“添加事件向导”添加ClickIn自定义事件
添加自定义事件的事件向导更改
调用FireClickIn

使用“添加事件向导”添加消息处理程序

具有常用名称的自定义事件

使用常用事件名称添加自定义事件

前言

自定义事件与常用事件的不同之处在于它们不会被类COleControl自动触发。自定义事件将由控件开发人员确定的特定操作识别为事件。自定义事件的事件映射条目由EVENT_CUSTOM宏表示。以下部分实现了使用ActiveX控件向导创建的ActiveX控件项目的自定义事件。

通过添加事件向导添加的自定义事件

以下过程添加特定的自定义事件，ClickIn。您可以使用此过程添加其他自定义事件。替换ClickIn事件名称和参数的自定义事件名称及其参数。

使用“添加事件向导”添加ClickIn自定义事件

加载你的控件工程。
在“类视图”中，右键单击ActiveX控件类以打开快捷菜单。
从快捷菜单中，单击“添加”，然后单击“添加事件”。
这将打开“添加事件向导”。
在“事件名称”框中，首先选择任何现有事件，然后单击“自定义”单选按钮，然后键入ClickIn。
在“内部名称”框中，键入事件的触发功能的名称。对于此示例，请使用“添加事件向导”（FireClickIn）提供的默认值。
使用“参数名称”和“参数类型”控件添加一个名为xCoord的参数（类型为OLE_XPOS_PIXELS）。
添加第二个参数，称为yCoord（类型为OLE_YPOS_PIXELS）。
单击“完成”以创建事件。

添加自定义事件的事件向导更改

添加自定义事件时，“添加事件向导”会对控件类.H，.CPP和.IDL文件进行更改。以下代码示例特定于ClickIn事件。

以下行添加到控件类的标题（.H）文件中：

void FireClickIn(OLE_XPOS_PIXELS xCoord, OLE_YPOS_PIXELS yCoord)
	{
		FireEvent(eventidClickIn, EVENT_PARAM(VTS_XPOS_PIXELS VTS_YPOS_PIXELS), xCoord, yCoord);
	}

.h文件
此代码声明了一个名为FireClickIn的内联函数，通过使用“添加事件向导”定义的ClickIn事件和参数调用COleControl :: FireEvent。

此外，以下行添加到控件的事件映射中，位于控件类的实现（.CPP）文件中：

EVENT_CUSTOM_ID("ClickIn", eventidClickIn, FireClickIn, VTS_XPOS_PIXELS VTS_YPOS_PIXELS)

.cpp
此代码将事件ClickIn映射到内联函数FireClickIn，并使用“添加事件向导”传递您定义的参数。

最后，以下行添加到控件的.IDL文件中：

[id(1)] void ClickIn(OLE_XPOS_PIXELS xCoord, OLE_YPOS_PIXELS yCoord);

.idl
此行为ClickIn事件分配一个特定的ID号，该ID号取自事件在“添加事件向导”事件列表中的位置。事件列表中的条目允许容器预测事件。例如，它可能提供在触发事件时要执行的处理程序代码。

调用FireClickIn

现在您已使用“添加事件向导”添加了ClickIn自定义事件，您必须决定何时触发此事件。您可以通过在发生相应操作时调用FireClickIn来执行此操作。对于此讨论，当用户在圆形或椭圆形区域内单击时，控件使用WM_LBUTTONDOWN消息处理程序内的InCircle函数来触发ClickIn事件。以下过程添加WM_LBUTTONDOWN处理程序。

使用“添加事件向导”添加消息处理程序

加载您的控件的项目。
在“类视图”中，选择ActiveX控件类。
在“属性”窗口中，单击“消息”按钮。
“属性”窗口显示可由ActiveX控件处理的消息列表。以粗体显示的任何消息都已分配了一个处理函数。
从“属性”窗口中，选择要处理的消息。对于此示例，请选择WM_LBUTTONDOWN。
从右侧的下拉列表框中，选择 OnLButtonDown。
双击“类视图”中的新处理程序函数，跳转到ActiveX控件的实现（.CPP）文件中的消息处理程序代码。

每次在控制窗口中单击鼠标左键时，以下代码示例都会调用InCircle函数。此示例可以在Circ示例摘要中的WM_LBUTTONDOWN处理函数OnLButtonDown中找到。

void CCreateOcxDemoCtrl::OnLButtonDown(UINT nFlags, CPoint point)
{
	// TODO: 在此添加消息处理程序代码和/或调用默认值
	if (InCircle(point))
		FireClickIn(point.x, point.y);

	COleControl::OnLButtonDown(nFlags, point);
}

注意当“添加事件向导”为鼠标按钮操作创建消息处理程序时，将自动添加对基类的同一消息处理程序的调用。请勿删除此电话。如果您的控件使用任何常用鼠标消息，则必须调用基类中的消息处理程序以确保正确处理鼠标捕获。

在以下示例中，仅当单击发生在控件内的圆形或椭圆形区域内时，才会触发事件。要实现此行为，可以将InCircle函数放在控件的实现（.CPP）文件中：

VARIANT_BOOL CCreateOcxDemoCtrl::InCircle(CPoint& point)
{
    CRect rc;
    GetClientRect(rc);
    // Determine radii
    double a = (rc.right - rc.left) / 2;
    double b = (rc.bottom - rc.top) / 2;
    
    // Determine x, y
    double x = point.x - (rc.left + rc.right) / 2;
    double y = point.y - (rc.top + rc.bottom) / 2;
    
    // Apply ellipse formula
    return ((x * x) / (a * a) + (y * y) / (b * b) <= 1);
}

您还需要将以下InCircle函数声明添加到控件的标题（.H）文件中：

VARIANT_BOOL InCircle(CPoint& point);

具有常用名称的自定义事件

您可以创建与常用事件同名的自定义事件，但是您无法在同一控件中实现这两个事件。例如，您可能希望创建一个名为Click的自定义事件，当通常触发常用事件Click时，该事件不会触发。然后，您可以通过调用其触发功能随时触发Click事件。

以下过程添加自定义Click事件。

使用常用事件名称添加自定义事件

加载您的控件的项目。
在“类视图”中，右键单击ActiveX控件类以打开快捷菜单。
从快捷菜单中，单击“添加”，然后单击“添加事件”。
这将打开“添加事件向导”。
在“事件名称”下拉列表中，选择常用事件名称。对于此示例，请选择“单击”。
对于事件类型，选择自定义。
单击“完成”以创建事件。
在代码中的适当位置调用FireClick。

vs2017开发ActiveX(主讲OCX)(六)、添加自定义事件