添加自定义事件
前言
自定义事件与常用事件的不同之处在于它们不会被类COleControl自动触发。 自定义事件将由控件开发人员确定的特定操作识别为事件。 自定义事件的事件映射条目由EVENT_CUSTOM宏表示。 以下部分实现了使用ActiveX控件向导创建的ActiveX控件项目的自定义事件。
通过添加事件向导添加的自定义事件
以下过程添加特定的自定义事件，ClickIn。您可以使用此过程添加其他自定义事件。替换ClickIn事件名称和参数的自定义事件名称及其参数。
使用“添加事件向导”添加ClickIn自定义事件
-
加载你的控件工程。
-
在“类视图”中，右键单击ActiveX控件类以打开快捷菜单。
-
从快捷菜单中，单击“添加”，然后单击“添加事件”。
添加事件
-
这将打开“添加事件向导”。
打开向导
-
在“事件名称”框中，首先选择任何现有事件，然后单击“自定义”单选按钮，然后键入ClickIn。
添加ClickIn
-
在“内部名称”框中，键入事件的触发功能的名称。对于此示例，请使用“添加事件向导”（FireClickIn）提供的默认值。
添加FireClickIn
-
使用“参数名称”和“参数类型”控件添加一个名为xCoord的参数（类型为OLE_XPOS_PIXELS）。
添加xCoord
-
添加第二个参数，称为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。
-
从右侧的下拉列表框中，选择<Add> 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。
备注：添加事件的自定义事件的方法不止上面这种也可通过其他方式添加，这里不多说。
网友评论