《基本函数库》由会员分享，可在线阅读，更多相关《基本函数库（79页珍藏版）》请在金锄头文库上搜索。
1、第第3章章 基本函数库基本函数库3.1.1面板操作类函数（面板操作类函数（Panels） lLoadPanel函数函数功能是将面板装载到内存中。参数1：父面板句柄,若该参数设置为0， 则装载的面板为最顶层面板；参数2：装载面板的 .uir文件名，字符串变量；参数3：面板大写常量名。“=”左边为返回值，表示得到面板句柄变量panelHandle=LoadPanel(0,“book.uir”,MAINPANEL);childpanelHandle=LoadPanel(panelHandle,“book.uir”,CHILDPANEL);DisplayPanel函数函数 功能：显示面板。 函数原形：
2、intstatus=DisplayPanel(intpanelHandle);PanelHandle面板句柄，整形变量，为正整数值，专指已经在内存中存在的面板，可以利用LoadPanel,NewPanel,或DuplicatePanel（复制面板）等函数得到该句柄。函数程序举例：DisplayPanel(mainpanel);调用该函数后，显示句柄为mainpanel的面板。DiscardPanel函数功能：删除面板，将面板从内存中移去。函数原形为：intstatus=DiscardPanel(intpanelHandle);函数程序举例：DiscardPanel(mainpanel);调用该
3、函数后，删除句柄为mainpanel的面板。HidePanel函数函数功能：隐藏面板，面板仍装载在内存中。函数原形：intstatus=HidePanel(intpanelHandle);函数程序举例：HidePanel(mainpanel)调用该函数后，隐藏句柄为mainpanel的面板。3.1.2菜单结构（菜单结构（Menu Structures） 1.菜单的设计在用户编辑界面文件（*.uir）的创建菜单（Creat）中选择MenuBar选项，进入菜单编辑界面。2.菜单结构函数MenuBars：菜单条Menus：菜单 MenuItems：菜单项1）Menu Bars菜单条菜单条（1）Loa
4、dMenuBar函数函数功能：在内存中装载菜单条。函数原形为：intmenuBarHandle=LoadMenuBar(intdestinationPanelHandle,char,intmenuBarResourceID);destinationPanelHandle为放置菜单条的面板的句柄，整形变量；为装载菜单条的用户界面文件名，字符串变量；menuBarResourceID为用户编辑器给菜单条定义的常量值。MenuBarHandle菜单条句柄，在其他函数中调用该值来指定菜单条，为正整数值，负值表示调用函数出错。函数程序举例：intmenuBarHandlemenuBarHandle=Lo
5、adMenuBar(mainpanel,”book.uir”,MENUBAR);调用该函数后，将菜单条MENUBAR装载到内存中，返回菜单句柄。（2）NewMenuBar函数函数功能：在指定面板上创建菜单条。函数原形：lintmenuBarHandle=NewMenuBar(intdestinationPanelHandle);参数destinationPanelHandle为放置菜单条的面板的句柄，整形变量；函数程序举例：intmenuBarHandlemenuBarHandle=NewMenuBar(mainpanel);调用该函数后，在面板mainpanel中创建菜单条，返回菜单句柄。（
6、3）DiscardMenuBar函数函数功能：在从内存和面板中删除菜单条。函数原形：intstatus=DiscardMenuBar(intmenuBarHandle);函数程序举例：DiscardMenuBar(menuBarHandle);调用该函数后，删除menuBarHandle菜单条。（4）SetPanelMenuBar函数函数功能：面板指定菜单条，一个面板只能有一个菜单条，多个面板可以共同使用一个菜单条。函数原形：intstatus=SetPanelMenuBar(intpanelHandle,intmenuBarHandle);函数程序举例：SetPanelMenuBar(mai
7、npanel,menuBarHandle);调用该函数后，将菜单条放置到mainpane面板中。（5）GetPanelMenuBar函数函数功能：返回指定面板关联的菜单条的句柄。函数原形：intmenuBarHandle=GetPanelMenuBar(intpanelHandle);函数程序举例：GetPanelMenuBar(mainpanel);调用该函数后，得到mainpanel面板关联的菜单条句柄。2）Menus菜单菜单（1）NewMenu函数功能：在菜单条中加入菜单并返回菜单ID号。函数原形：intmenuID=NewMenu(intmenuBarHandle,charmenuNa
8、me,intbeforeMenuID);参数menuBarHandle为菜单条句柄；menuName为加入到菜单条中的菜单名称，字符串变量；beforeMenuID为菜单的ID号，在此菜单之前插入新菜单，若新菜单放置在菜单条的末尾，传递参数为-1。menuID为返回值，菜单条中给菜单定义的常量值，在函数调用时指定该菜单。函数程序举例：intmenuIDmenuID=NewMenu(menuBarHandle,“帮助”,-1);调用该函数后，在菜单条的末尾放置“帮助”菜单，并返回菜单标识。（2）DiscardMenu函数功能：从菜单条中删除菜单、子菜单和菜单项。函数原形为intstatus=Di
9、scardMenu(intmenuBarHandle,intmenuID);参数menuBarHandle为菜单条句柄；menuID菜单条中给菜单定义的常量值。函数程序举例：DiscardMenu(menuBarHandle,menuID);调用该函数后，删除菜单。（3）NewSubMenu函数功能：创建子菜单并返回子菜单的ID号函数原形：intsubMenuID=NewSubMenu(intmenuBarHandle,intmenuItemID);SubMenuID为子菜单的ID号，在其他函数中调用该值来指定子菜单，为正整数值，负值表示调用函数出错。函数程序举例：intsubMenuIDsu
10、bMenuID=NewSubMenu(menuBarHandle,menuItemID);调用该函数后，创建一个子菜单。（4）DiscardSubMenu函数功能：从菜单条和内存中删除子菜单函数原形为intstatus=DiscardSubMenu(intmenuBarHandle,intsubMenuID);函数程序举例：DiscardSubMenu(menuBarHandle,subMenuID);调用该函数后，删除子菜单。3）Menu Items菜单项菜单项（1）NewMenuItem函数功能：给菜单创建菜单项并返回菜单项的ID号。函数原形：intmenuItemID=NewMenuIt
11、em(intmenuBarHandle,intmenuID,charitemName,intbeforeMenuItemID,intshortCutKey,MenuCallbackPtreventFunction,void*callbackData);（2）DiscardMenuItem函数功能：从菜单和内存中删除菜单项。函数原形：intstatus=DiscardMenuItem(intmenuBarHandle,intmenuItemID);函数程序举例：DiscardMenuItem(menuBarHandle,menuItemID);调用该函数后，删除菜单项。控件操作类函数控件操作类函
12、数 l1.GeneralFunctions(一般函数)(1)GetCtrlVal(1)GetCtrlVal函数函数功能：从面板上获得控件参数值intstatus=GetCtrlVal(intpanelHandle,intcontrolID,void*value);Value为输出变量，放置返回的参数，以地址形式表示，如：&value。intchannelGetCtrlVal(panelHandle,PANEL_Channel,&channel);（2）GetCtrlAttribute函数函数 l功能是获得控件的属性。intstatus=GetCtrlAttribute(intpanelHand
13、le,intcontrolID,intcontrolAttribute,void*attributeValue);如：intctrlAttrGetCtrlAttribute(mainpanel,MIANPANEL_QUIT,ATTR_CMD_BOTTON_COLOR,&ctrlAttr);（3）SetCtrlVal函数函数 l将源程序中某个变量的值显示到面板上。intstatus=SetCtrlVal(intpanelHandle,intcontrolID,.);例如：SetCtrlVal(panelHandle,PANEL_VOLTAGE,5.0);（4）SetCtrlAttribute函数
14、函数 l功能是设置控件的属性值intstatus=SetCtrlAttribute(intpanelHandle,intcontrolID,intcontrolAttribute,.);attributeValue为控件的属性值，其类型由控件类型决定。2.List Controls（列表控件）（列表控件） l（1）InsertListItem函数功能是向列表控件和循环控件添加内容。intstatus=InsertListItem(intpanelHandle,intcontrolID,intitemIndex,charitemLabel,.);itemIndex为放置内容的位置索引号，（从0开
15、始，如果设置为-1，则放置在控件的末尾）；itemLabel与itemValue相关的标签；itemValue与itemLabel相关的数值，数据类型与控件的数据类型相同。例如：InsertListItem(mainpanel,MAINPANEL_LISTBOX,-1,equation,0);调用该函数后，在面板的列表控件“Listbox”的末尾添加“equation”项。（2）ReplaceListItem函数函数 l功能是替换列表控件中的内容。intstatus=ReplaceListItem(intpanelHandle,intcontrolID,intitemIndex,charite
16、mLabel,.);itemIndex为要替换内容的位置索引号；itemLabel为与新数据值相关的标签，如果是0，就使用原有的标签；itemValue为与新标签相关的数据值，数据类型与控件数据类型相同。例如：ReplaceListItem(mainpanel,MAINPANEL_LISTBOX,1，help,0);调用该函数后，替换面板的列表控件“Listbox”中位置索引号为1的项为“help”。（3） DeleteListItem函数函数 l功能是删除列表控件中的一项或多项内容。intstatus=DeleteListItem(intpanelHandle,intcontrolID,intitemIndex,intnumberOfItems);itemIndex为删除的第一条内容的索引号；numberOfItems为要删除的内容的项数，如果删除从itemIndex到结尾的全部内容，则参数设置为-1。函数程序举例：DeleteListItem(mainpanel,MAINPANEL_LISTBOX,0,-1);调用该函数后，删除列表控件中的所有内容。3Text Boxes（文本框控
