ON_EVENT_RANGE的使用方法

关注

转载最新推荐文章于 2026-10-25 13:20:29 发布 3k 阅读 AI 写同款· GEO 优化 ›

Python多线程编程：用Event、Condition等同步原语替代time.sleep 在多线程编程中，线程同步是协调多个线程执行顺序、避免数据竞争的核心机制。其原理是通过锁、条件变量等同步原语，控制线程对共享资源的访问，确保线程安全。这一技术价值在于提升程序并发效率、降低资源消耗，并避免因竞态条件导致的数据不一致问题。应用场景广泛，包括生产者-消费者模型、线程池任务调度、资源池限流等并发控制场景。本文聚焦于Python的threading模块，深入探讨如何用Event、Condition等高级同步原语替代低效的time.sleep轮询，解决线程阻塞与响应延迟问题，实现更优雅的线程间协作。阅读详情

var kba = new KBAlertz { "Launch Date" = "October 30th, 2013" }

Article ID: 183080 - View products that this article applies to.

This article was previously published under Q183080

If you are a Small Business customer, find additional troubleshooting and learning resources at the Support for Small Business site.

Show all | Hide all

SUMMARY

The following is copied from the Visual C++ online documentation regarding the usage of the ON_EVENT_RANGE macro:

PfnHandler Pointer to a member function that handles the event. This function should have a BOOL return type, a first parameter of type UINT (for the control ID), and additional parameter types that match the event's parameters (see vtsParams). The function should return TRUE to indicate the event was handled; otherwise FALSE.

VtsParams A sequence of VTS_ constants that specifies the types of the parameters for the event. The first constant should be of type VTS_I4, for the control ID. These are the same constants that are used in dispatch map entries such as DISP_FUNCTION.

The vtsParams argument is a space-separated list of values from the VTS_ constants. One or more of these values separated by spaces (not commas) specifies the function's parameter list. For example:

VTS_I2 VTS_BOOL specifies a list containing a short integer followed by a BOOL.

According to this specification, the pfnHandler should have at least one parameter. In addition, the first parameter must be a UINT data type for the control ID. Therefore, the first VTS_ constant for vtsParams must be VTS_I4 (UINT data type).

If pfnHandler has some additional parameters besides the UINT of the control ID, then each VTS_ constant for vtsParams after VTS_I4 must match the data types of these additional parameters of pfnHandler.

To better illustrate the usage of the ON_EVENT_RANGE macro, a simple sample is shown below.

MORE INFORMATION

The sample code below illustrates the use of the ON_EVENT_RANGE() macro in an MFC dialog-based application. CTestDlg is a CDialog-derived class. In the sample code below, TestOnProblem is the pfnHandler and it has two parameters: a control ID of type UINT and an additional parameter of type short. Thus, vtsParams should be:

   VTS_I4 VTS_I2

VTS_I4 and VTS_I2 match the data type of the first and second parameters of TestOnProblem(), respectively.

For instance, the function prototype for pfnHandler is below:

   BOOL CTestDlg::TestOnProblem(UINT CtrlID, short Param)
   {
      TRACE("control id = %u, Second parameter = %d\n", CtrlID, Param);
      return TRUE;  // returns TRUE to indicate the event was handled;
   }

Then, the event map should look similar to the following:

   BEGIN_EVENTSINK_MAP(CTestDlg, CDialog)
       //{{AFX_EVENTSINK_MAP(CTestDlg)
       //}}AFX_EVENTSINK_MAP
       ON_EVENT_RANGE(
           CTestDlg,      // Class to which this event sink map belongs.
           IDC_FIRSTCTRL, // ID of the first control in the range.
           IDC_LASTCTRL,  // ID of the last control in the range.
           1,             // Dispatch ID of event fired by the control.
           TestOnProblem, // Function for handling events.
           VTS_I4 VTS_I2) // VTS_I4 and VTS_I2 are the first and second
                          // parameters of TestOnProblem() function.
   END_EVENTSINK_MAP()

It is important to note that ON_EVENT_RANGE must be added outside of ClassWizard's comment ("//") lines. Otherwise, ClassWizard will give you an error message box whenever you open the dialog box resource template. This is because ClassWizard doesn't recognize the syntax of the ON_EVENT_RANGE macro.

Also, make sure the controls whose events are being handled have IDs within the contiguous range of IDs listed in ON_EVENT_RANGE. Check the Ids by clicking View on the Resource Symbols toolbar in Visual C++ 5.0. Note that the IDs of the controls may be different than expected, depending on the order in which they were created on the dialog box template.

Although one can't create an ON_EVENT_RANGE handler using ClassWizard, it is possible to create an ON_EVENT handler using ClassWizard. Please be aware that in creating an ON_EVENT handler using ClassWizard, the return type of the handler created may be void. This is a bug in ClassWizard. The documentation for both ON_EVENT and ON_EVENT_RANGE is still correct when it says "This function should have a BOOL return type." Returning void usually works correctly, however, so this is not a big problem.

(c) Microsoft Corporation 1998, All Rights Reserved. Contributions by Yeong- Kah Tam, Microsoft Corporation.