第三讲 面板类操作函数

MessagePopup 函数的功能是显示一个消息对话框，等待用户选择“0K”按钮。如图 3.1 所示。
图 3.1 MessagePopup 弹出式面板 该函数原形为： int status = MessagePopup ( char title [ ] , char message [ ]); 参数 char title [ ]为对话框的标题；char message [ ]为对话框中显示的消息内容，如果要显示 多行内容， 在消息的字符串中插入“\n”的换行标志。 函数程序举例：
MessagePopup ( “出错”，“用户词库错误! ”）； 调用函数后，弹出一个名称为“出错”的对话框，内容为“用户词库错误!” （4）确认框 ConfirmPopup ()函数
ConfirmPopup 函数的功能是显示一个即时的消息对话框，显示文本消息并且输入布尔值， 对话框中有两个按钮。等待用户选择“Yes”或 “No”按钮，来使用户对某一行为进行确认。
第三讲 面板类操作函数（续）
3.1 用户界面管理类函数
用户界面管理类函数（User Interface Management)
1. RunUserInterface 函数
RunUserInterface 函数的功能是运行用户接口界面。该函数原形为：
int status = RunUserInterface (void);
图 3.4 Generic Message Popup 弹出面板 在弹出式面板中显示一个设定的信息，同时面板上还有一个字符串文本框接收响应的字 符串。 函数原型为： int Generic Message Popup (char title[ ], char message[ ], char buttonLabel1[ ], char buttonLabeI2[ ], char buttonLabel3[ ], char responseBuffer[ ], int maxResponseLength, int buttonAlignment, int activeControl, int enterButton, int escapeButton); • Title[ ]：对话框的标题。 • Message[ ]：对话框里显示的提示信息。 • buttonLabel1[ ]：按钮 1 的标题。 • buttonLabel2[ ]：按钮 2 的标题。如果不需要显示按钮 2 和按钮 3,可以输入 0。 • buttonLabel3[]：按钮 3 如标题。如果不需要显示按钮 3，可以输入 0。 • maxResponseLength：向文本框中输入的最大字节数。 • responseBuffer[ ]：为用户输入的字符串。其存储空间要大于 maxResponseLength 设置的 数值，再加上 ASCII 码结束符（NULL)。如果不需要显示文本框，输入 0。 • buttonAlignment：按钮的位置。如果值为 0，则将按钮放置在下方；如果输入的是一个不 为 0 的数值，则将按钮放置在对话框的右侧。 • activeControl：弹出面板后在对话框中被激活的控件。四个控件的常量名分别为： VAL_GENERIC_POPUP_BTN1：按钮 1。 VAL_GENERIC_POPUP_BTN2：按钮 2。 VAL_GENERIC_POPUP_BTN3：按钮 3。 VAL_GENERIC_POPUP_INPUT_STRING：在弹出面板上供用户输入字符的文本框。 • enterButton：确定以 Enter 键作为快捷键的按钮。如取消按钮以 Enter 键作为快捷键，则 可以输入常量名 VAL_GENERIC_POPUP_NO_CTRL。 • escapeButton：确定以 Esc 键作为快捷键的按钮。如取消按钮以 Esc 键作为快捷键，则可 以输入常量名 VAL_GENERIC_POPUP_NO_CTRL。 （7）文件选择框 FileSelect Popup 函数 文件选择框用来选择文件。等待用户选择一个文件或退出，显示的是用户选择的磁盘上 所存储的文件名和路径名。一个文件路径弹出式面板如图 3.5 所示。
表 3. 1 buttonLabel 的可选值
值
显示标签
VAL_OK_BUTTON
OK
VAL_SAVE_BUTTON
Save
VAL_SELECT_BUTTON Select
VAL_LOAD_BUTTON Load • restrictDirectory：用于限定路径，如果设置的数值不为 0，用户不能改变文件路径和驱动器。
（6） 通用消息框 Generic Message Popup 函数 通用消息框可以实现包含以上三者的功能，Generic Message Popup 弹出面板通用消息框
可以包含三个按钮和一个输入框，可输入信息字符串， 并且最多可设置三个按钮。一个简 单的输入信息弹出式面板如图。如图 3.4 所示
函数程序举例说明：
如在上一讲主函数中的应用：
int main (int argc, char *argv[])
{
if (InitCVIRTE (0, argv, 0) == 0)
return -1; /* out of memory */
if ((parent = LoadPanel (0, "pc.uir", PARENT)) < 0)
如：在关闭 LabWindows/CVI 程序时，系统会弹出一 个是否真的退出 LabWindows/CVI 的对话框，这样的设计可以减少用户的误操作。一个简单的确认信息弹出式面板如图 3.2 所 示
图 3.2 Confirm Popup 弹出式面板 该函数原形为： int status = ConfirmPopup ( char title [ ] , char message [ ]); 参数 char title [ ]为对话框的标题；char message [ ]为对话框中显示的消息内容，如果要显示 多行内容， 在消息的字符串中插入“\n”的换行标志，返回代码为 1 时，表示选择“Yes”，返 回代码 为 0 时，表示选择“No”。 函数程序举例：
函数程序举例说明：
如在上一讲 QuitCB 回调函数中的应用：
int CVICALLBACK QuitCB (int panel, int control, int event,
void *callbackData, int eventData1, int eventData2)
{ switch (event)
在文件列表中初始显示所有以.c 为扩展名的 文件。 • FileTypeList[ ]：文件类型列表。当 restrictExtension 设置为“FALSE”（0）时，能够包含在 文件类型列表 “File Type List” 选择框的字符串，不同类型之间用分号（；）分开，分割文件 类型字符串，例如，“*.c；*.h”允许用户从“File Type List”中 选择“*.c” 或“*.h”类型； 在程序运行时，输入的类型将在文件类型列表下拉框中出现。允许用户从文件类型列表中选 择“*.c ”或“*.h”； 输入“*.*”则表示可以选择所有文件。文件列表可输入的最大长度为 255 字节。 • title[ ]：对话框的标题。 • buttonLable：为文件选择按钮的标签，有如下选择值：
InstallPopup 函数的功能是显示并激活一个弹出面板。
该函数原形为：
int status = InstallPopup (int panelHandle);
（2）RemovePopup 函数 RemovePopup 函数的功能是删除弹出面板。 该函数原形为： int status = RemovePopup (int removePopup); 其中，参数 removePopup 决定是否删除所有的弹出面板（设置为 1），还是只删除激活面板 (设置为 0)。 （3）消息框 MessagePopup()函数
return -1;
child=LoadPanel(parent,"pc.uir",CHILD);/*加载子面板到内存，并将子面板的句柄赋值给
child 变量*/
DisplayPanel (parent);
RunUserInterface ();//调用该函数后，运行用户界面。
DiscardPanel(parent);
对话框是常用的一种界面元素，可以不必编辑面板，利用简单的参数来实现一个交互式 界面。对话框通常有一个或多个控件及一些文本，其中文本用来解释程序需要提供什么样的 信息。在 LabWindows/CVI 的用户界面库中提供了 11 种对话框（面板）函数。利用这些函 数可以生成常用的对话框。本讲主要内容是学会如何调用用户界面库中的函数，来生成各种 类型的对话框。这些对话框函数包括： （1）InstallPopup 函数
显示一个提示信息等待用户进行输入信息操作。提示式信息弹出面板要求用户进行输入 操作，如图 3.3 所示。
图 3.3 Prompt Popup 弹出面板 该函数原形为： int PromptPopup (char title[ ], char message[ ], char responseBuffer[ ], int maxResponseLength); Title[ ]：对话框的标题。 Message[ ]：在对话框里显示的信息。 responseBuffer[ ]：为用户输入的字符串。 maxResponseLength：允许用户输入的最大字节数。
return 0;
}
2、QuitUser Interface () 函数
QuitUserInterface ()函数的功能是退出用户接口界面。该函数原形为：
ini status = QuitUserInterface () (int returnCode);
其中，参数 returnCode 为调用 RunUserInterface 函数返回的值，传递参数大于或等于 0。