Windows CVI用户事件及其意义.doc

三、用户事件及其意义用回调函数法处理用户事件，程序可以识别界面上发生的事件并调用相应的处理代码来响应事件。表3-1 列出了图形用户界面可能产生的所有事件。表 3-1 用户事件EVENT_CLOSE EVENT_LEFT_DOUBLE_CLICKEVENT_COMMIT EVENT_LOST_FOCUSEVENT_DISCARD EVENT_PANEL_MOVEEVENT_END_TASK EVENT_PANEL_SIZEEVENT_GOT_FOCUS EVENT_RIGHT_CLICKEVENT_IDLE EVENT_RIGHT_DOUBLE_CLICKEVENT_KEYPRESS EVENT_TIMER_TICKEVENT_LEFT_CLICK EVENT_VAL_CHANGED各种用户事件的具体介绍如下：1. EVENT_CLOSE应用于面板对象。当用户从系统菜单执行关闭命令或点击窗口右上角的关闭按钮时产生此事件。回调函数中的事件数据无意义。2. EVENT_COMMIT应用于菜单、数值控件、颜色选择数值控件（color numeric）、数值滑动条（numericslide）、字符串、文本框、命令按钮、图形按钮（picture button）、文本按钮（text button）、单选控件（radio button）、指示灯（LED）、二值开关、下拉列表（ring）、滑动列表（ring slide）、虚拟仪器软件开发环境LabWindows/CVI 6.0 编程指南56图片列表（picture ring）、列表框、曲线图和表格控件。当用户在界面上提交一项操作时会产生此事件，如选择菜单项或在输入框中输入数值后按。LabWindows/CVI 除了将COMMIT 事件传递给控件回调函数外，还将其加入到GetUserEvent 事件队列，除非此事件被忽略。当选择菜单项产生 COMMIT 事件时，传递给主回调函数的事件数据eventData1 为产生事件的面板或菜单条的标识，eventData2 为被选择的菜单项的回调函数产生的数据（callbackData）。控件回调函数和主回调函数的关系将在下一节介绍。当表格控件产生 COMMIT 事件时，事件数据eventData1 为产生事件的表格单元的行号，eventData2 为列号。如果事件涉及了多个表格单元，例如对多个单元排序或粘贴数据，eventData1 和eventData2 都会是0。3. EVENT_DISCARD应用于面板和各种控件。当面板或控件被从内存中放弃的时候产生此事件。回调函数中的事件数据无意义。4. EVENT_END_TASK当 windows 要退出程序时，LabWindows/CVI 将此事件传递给主回调函数。忽略此事件可以避免windows 退出程序。回调函数中的事件数据无意义。5. EVENT_GOT_FOCUS应用于面板、数值控件、颜色选择数值控件、数值滑动条、字符串、文本框、命令按钮、图形按钮、双值按钮、文本按钮、单选控件、指示灯、二值开关、下拉列表、滑动列表、图形列表、列表框、曲线图、画布和表格控件。当控件并非当前激活控件（active control），而用户通过鼠标点击、按或键使之成为激活控件时将产生此事件。事件数据 eventData1 为前一个激活控件。6. EVENT_IDLE只要 LabWindows/CVI 处理事件，这个事件就会定期传递给主回调函数,可以通过SetIdleEventRate 函数设定此事件产生的频率。这个事件已经废弃，建议使用定时器控件。回调函数中的事件数据无意义。7. EVENT_KEYPRESS应用于面板、数值控件、颜色选择数值控件、数值滑动条、字符串、文本框、命令按钮、图形按钮、双值按钮、文本按钮、单选控件、指示灯、二值开关、下拉列表、滑动列表、图形列表、列表框、曲线图、画布和表格控件。按键事件被传递给当前激活控件对应的回调函数。如果忽略此事件，LabWindows/CVI不对此事件进行进一步处理。如果用户在控件中输入了双字节字符，回调函数会接收到两次EVENT_KEYPRESS事件，在这种情况下应该忽略第一次事件，可以用函数KeyPressEventIsLeadByte来判断接收到的是否是双字节字符的第一个字节。当接收到第二次事件时，KeyPressEventIsTrailByte函数返回值为真（TRUE），这时可以用GetKeyPressEventCharacter函数来获取完整的双字虚拟仪器软件开发环境LabWindows/CVI 6.0 编程指南57节字符。事件数据 eventData1 为键码，eventData2 为指向键码的指针。8. EVENT_LEFT_CLICK应用于面板和各种控件。当用户在面板上任何地方点击鼠标左键的时候，将产生此事件，它被传递到面板的回调函数和被点击控件的回调函数。事件数据 eventData1 为鼠标垂直坐标，eventData2 为鼠标水平坐标。9. EVENT_LEFT_DOUBLE_CLICK应用于面板和各种控件。当用户在面板上任何地方双击鼠标左键的时候，将产生此事件，它被传递到面板的回调函数和被点击控件的回调函数。事件数据 eventData1 为鼠标垂直坐标，eventData2 为鼠标水平坐标。10. EVENT_LOST_FOCUS应用于面板、数值控件、颜色选择数值控件、数值滑动条、字符串、文本框、命令按钮、图形按钮、双值按钮、文本按钮、单选控件、指示灯、二值开关、下拉列表、滑动列表、图形列表、列表框、曲线图、画布和表格控件。当控件是当前激活控件（active control），而用户通过鼠标点击、按或键使之不再成为激活控件时将产生此事件。事件数据 eventData1 为下一个激活控件。11. EVENT_PANEL_MOVE应用于面板对象。当用户移动面板时产生此事件，它被传递给面板的回调函数。回调函数中的事件数据无意义。12. EVENT_PANEL_SIZE应用于面板对象。当用户改变面板大小时产生此事件，它被传递给面板的回调函数。回调函数中的事件数据无意义。13. EVENT_RIGHT_CLICK应用于面板和各种控件。当用户在面板上任何地方点击鼠标右键的时候，将产生此事件，它被传递到面板的回调函数和被点击控件的回调函数。事件数据 eventData1 为鼠标垂直坐标，eventData2 为鼠标水平坐标。14. EVENT_RIGHT_DOUBLE_CLICK应用于面板和各种控件。当用户在面板上任何地方双击鼠标右键的时候，将产生此事件，它被传递到面板的回调函数和被点击控件的回调函数。事件数据 eventData1 为鼠标垂直坐标，eventData2 为鼠标水平坐标。15. EVENT_TIMER_TICK应用于定时器控件。虚拟仪器软件开发环境LabWindows/CVI 6.0 编程指南58定时器控件每隔一定时间间隔（可以通过定时器属性来设定）就会产生此事件，请参考第2 章定时器控件编程部分。事件数据 eventData1 为指向当前时间的指针，eventData2 为一个指针，其指向的数据为从该控件上次接收到此事件到当前一共经历的时间。16. EVENT_VAL_CHANGED应用于数值控件、颜色选择数值控件、数值滑动条、字符串、文本框、图形按钮、双值按钮、文本按钮、单选控件、指示灯、二值开关、下拉列表、滑动列表、图形列表、列表框、曲线图和表格控件。当用户连续动作，使控件的值连续发生变化时，此事件也将连续产生。这样的动作包括：操作数值控件