LabWindows/CVI虚拟仪器设计技术场景与游戏设计之： 打蜜蜂

（3） 程序注释

① sndPlaySound 函数播放指定音频文件。此函数为PlaySound 函数的子集，主要是为保持向后兼容而设置。文件声明在mmsystem.h 中，导入库为winmm.lib 。函数原型为：

BOOL sndPlaySound(LPCSTR lpszSound, UINT fuSound); 

lpszSound ：指定播放音频文件名，该参数可以是WAVE 文件名或是在系统注册表WIN.INI 

中定义的系统事件音频文件。如果该参数设置为NULL 则停止正在播放的音频文件。fuSound：播放标志。

播放标志说明如表4-10 所示。

表4-10 播放标志说明

返回值：成功返回True ，否则返回False 。

② GetAsyncKeyState 函数判断按键是处于按下状态，还是处于弹起状态。函数原型为：

SHORT GetAsyncKeyState(int vKey);

vKey：虚拟键值。

返回值：返回指定键是否处于按下状态，若为1，则键被按下，否则为弹起状态。

③ GetKeyPressEventVirtualKey 函数当回调函数响应EVENT_KEYPRESS 事件时，调用GetKeyPressEventVirtualKey 函数获得虚拟键值。如果回调函数eventData1 参数包含字符而非虚拟键时，函数返回0 值。函数原型为：

int GetKeyPressEventVirtualKey (int eventData2); eventData2 ：面板或控件回调函数的eventData2 参数。

返回值：返回虚拟键值，如有非虚拟键按下，返回0。

④ GetKeyPressEventCharacter 函数当回调函数响应EVENT_KEYPRESS 事件时，调用GetKeyPressEventCharacter 函数获得按键字符。如果回调函数eventData1 参数包含虚拟键而非字符时，函数返回0 值。函数原型为：

int GetKeyPressEventCharacter (int eventData2); 

eventData2 ：面板或控件回调函数eventData2 参数。

返回值：返回字符值，如有非字符按下，返回0。

⑤ InstallPopup 函数显示模态对话框。函数原型为：

int InstallPopup (int Panel_Handle); 

一般来说，在Windows 应用程序中，对话框分为模态对话框和非模态对话框两种。二者的区别在于当对话框打开时，是否允许用户进行其他对象的操作。模态对话框（Modal Dialogue Box， 又称模式对话框），是指在用户要操作对话框以外的窗口时，必须首先响应该对话框，如单击确定或取消按钮等关闭对话框。非模态对话框（Nonmodal Dialogue Box ，又称无模式对话框），与模态对话框不同，当用户打开非模态对话框时，依