---

35.3 UI元素¶

ui*系列函数与qtgraphictoolkit,尽管有一些函数可用于fltk工具包。没有对的支持gnuplot工具包。

 

:h= ui图形 ()¶

:h= ui图形 ("属性",value, …)¶

为应用程序创建一个新的地物窗口。

可以为地物对象指定多个属性值对,但它们必须成对出现。

返回值h是已创建地物对象的图形句柄。

编程说明:属性的完整列表记录在图属性。此函数不同于图形因为创建的图形是为应用程序开发而优化的,而不是绘图。这意味着菜单栏和工具栏等函数将被关闭。

详见: ui面板,uibutton组.

 

:hui= ui面板 ()¶

:hui= ui面板 (属性,value, …)¶

:hui= ui面板 (父级对象亲)¶

:hui= ui面板 (父级对象亲,属性,value, …)¶

创建uipanel对象。

uipanels用作容器来对其他uicontrol对象进行分组。

如果父级对象亲则会创建当前图形的uipanel。如果没有可用地物,将首先创建一个新地物。

如果父级对象亲则给出一个相对于的uipanel父级对象亲创建。

任何提供的属性值对都将覆盖已创建的uipanel对象的默认值。

完整的属性清单记录在UI面板属性.

可选返回值hui是createduipanel对象的图形句柄。

示例:

##在itf上创建图形和面板;p=uipanel(“title”,“Panel title”,“position”,[.25.25.5.5]);##将两个按钮添加到面板b1=uicontrol(“父”,p,“字符串”,“A按钮”,…“位置”,[18 10 150 36]);b2=uicontrol(“父”,p,“字符串”,“另一个按钮”,…“位置”,[18 60 150 36]);

详见: 图形,uicontrol.

 

:hui= uibutton组 ()¶

:hui= uibutton组 (属性,value, …)¶

:hui= uibutton组 (父级对象亲)¶

:hui= uibutton组 (父级对象亲,属性,value, …)¶

:uibutton组 (h)¶

创建一个uibuttongroup对象并返回其句柄。

uibuttongroup用于对uicontrol对象进行分组。

如果父级对象亲则为当前地物创建一个uibutton组。如果没有可用地物,将首先创建一个新地物。

如果父级对象亲则给出一个相对于的uibuttongroup父级对象亲已创建。

任何提供的属性值对都将覆盖已创建的uibuttongroup对象的默认值。

完整的属性清单记录在按钮组属性(U).

示例:

##在itf上创建图形和面板=figure;##创建按钮组gp=uibuttongroup(f,“Position”,[0 0.5 1 1])##在组b1=uicontrol中创建按钮(gp,“style”,“radiobutton”,…“string”,“Choice 1”,…”Position“,[10 150 100 50]);b2=uicontrol(gp,“样式”,“单选按钮”,…“字符串”,“参数2”,…”位置“,[10 50 100 30]);##创建不在组b3=uicontrol中的按钮(f,“样式”,“单选按钮”,…“字符串”,“不在组中”,…”位置“,[10 50 100 50]);

使用单个参数调用时h是现有uibuttongroup对象的句柄,将焦点切换到指定的uibuttongroup。此函数目前尚未实现。

详见: 图形,ui面板.

 

:hui= uicontrol ()¶

:hui= uicontrol (属性,value, …)¶

:hui= uicontrol (父级对象亲)¶

:hui= uicontrol (父级对象亲,属性,value, …)¶

:uicontrol (h)¶

创建uicontrol对象并向其返回句柄。

uicontrol对象用于创建简单的交互式控件,如按钮、复选框、编辑和列表控件。

如果父级对象亲则为当前图形创建uicontrol。如果没有可用地物,将首先创建一个新地物。

如果父级对象亲则给出一个uicontrol相对于父级对象亲已创建。

任何提供的属性值对都将覆盖创建的uicontrol对象的默认值。

完整的属性清单记录在控件属性.

创建的uicontrol类型从指定风格属性如果没有提供样式属性,将创建一个按钮。

uicontrol的有效样式为:

“复选框”

创建允许用户打开/关闭选择的复选框控件。

编辑

创建一个编辑控件,允许用户输入单行或多行文本。

“列表框”

创建一个列表框控件,该控件显示项目列表,并允许用户选择单个或多个项目。

“弹出菜单”

创建一个弹出菜单控件,显示用户单击该控件时可以选择的参数列表。

“按钮”

创建一个按钮控件,允许用户按下以进行操作。

“单选按钮”

创建一个单选按钮控件,用于在一组单选按钮控件中互斥输入。

“滑块”

创建一个滑块控件,允许用户通过滑动控件上的旋钮从一系列值中进行选择。

文本

创建一个静态文本控件以显示单行或多行文本。

“切换按钮”

创建一个看起来像按钮的切换按钮控件,但允许用户在两种状态之间进行选择。

注意:对于编辑和“列表框”样式,单个或多个行/选择行为从“最小值”和“最大值”属性,当值设置为最大值-最小值>1.

示例:

##在itf上创建图形和面板=figure;##创建按钮(默认样式)b1=uicontrol(f,“字符串”,“a按钮”,…“位置”,[10 10 150 40]);##创建编辑控件1=uicontrol(f,“样式”,“编辑”,“字符串”,“可编辑文本”,…“位置”,[10 60 300 40]);##创建checkboxc1=uicontrol(f,“样式”、“复选框”、“字符串”、“一个复选框”,…“位置”,[10 120 150 40]);

使用单个参数调用时h是现有图标控制对象的句柄,将键盘焦点切换到指定的图标控制。因此,uicontrol对象将接收可以使用处理的键盘事件“keypressfcn”回调。

详见: 图形,ui面板.

 

:hui= 合适的 (属性,value, …)¶

:hui= 合适的 (父级对象亲,属性,value, …)¶

创建一个uitable对象并返回一个句柄。

uitable对象用于在图形窗口中显示数据表。

如果父级对象亲则创建适用于当前图形的图形。如果没有可用地物,将首先创建一个新地物。

如果父级对象亲则给出了一个uitable相对于父级对象亲已创建。

任何提供的属性值对都将覆盖创建的合适对象的默认值。

完整的属性清单记录在表格属性.

示例:

##创建图并在itf=图()上放置一个表;m=魔术(8);t=uitable(f,“Data”,m,“ColumnWidth”,{40});

##创建一个带有标签行和列的表sf=figure();d=整形(1:9,[3,3]);row_names={“Row1”、“Row2”、“Row3”};col_names={“Col1”、“Col2”、“Col3”};t=uitable(f,“Data”,d,…“RowName”,row_names,“ColumnName”,col_names);p=get(t,“位置”);e=get(t,“Extent”);p(3:4)=e(3:4;set(t,“位置”,p);

##带回调函数uitable_demo()的长演示f=图(“名称”、“uitable demo”、“菜单”、“none”、…“位置”、[10 10 1000 680]);##一个基本示例d={“char”,“A string”;“double”,12.3456789;“complex”,1+2i;“bool”,true;“single”,single(12.3456 789);“int8”,int8(-128);“uint8”,uint8(128);“int 16”,int16(-32768);“uint16”,uint16(32768);“int32”,int32(-2147483648);;“uint64”,uint64(2147843649)};popup_options={“A”、“B”、“C”、“D”、“E”};columnformat_options={“[]”,“char”,“popular”,“numerical”,…“short”,“short e”,“short eng”,…”short g“,”long“,”long e“,…”long eng“,“long g”,”bank“,”+“,…“rat”,”logic“};columnformat_values=列格式参数;columnformat_values{1}=“”;columnformat_values{3}=弹出参数;default_data=repmat(d(:,2),1,列(columnformat_options));b_add=uicontrol(f,“位置”,[285 630 600 50],…“用户数据”,[行(d),1]。。。“样式”,“按钮”。。。“字符串”,“将所选点的数据设置为所选数据类型”);l_type_table=uicontrol(f,“位置”,[0 603 120 25],…“字符串”,“数据类型表:”,…“样式”,“文本”);t_type_table=uitable(f,“位置”,[0 530 1000 70],…“数据”,转置(d(:,2))。。。“ColumnName”,转置(d(:,1))。。。“RowName”,“Value”。。。“CellSelectionCallback”@(x,y)集合(b_add,“UserData”,y.Indices));l_point_table=uicontrol(f,“位置”,[0 640 60 25],…“字符串”,“点:”,…“样式”,“文本”);t_point_table=uitable(f,“Position”,[80 630 160 42],…“RowName”,[],…“ColumnName”,{“x”,“y”},…“Data”,[1,1],…“ColumnEditable”,true);l_editable_table=uicontrol(f,“位置”,[0 502 200 25],…“样式”,“文本”,…“字符串”,“设置数据列可编辑:”);t_editable_table=。。。uitable(f,“位置”,[0 434 1000 65],…“数据”,repmat(false,1,columns(default_Data))。。。“ColumnEditable”,true);l_format_table=uicontrol(f,“位置”,[0 406 200 25],…“样式”,“文本”,…“字符串”,“设置数据列格式:”);t_format_table=。。。uitable(f,“位置”,[0 338 1000 65],…“数据”,columnformat_options,…“可编辑列”,true,…“列格式”,arrayfun(@(x){columnformal_options}。。。1:列(columnformat_options));l_data_table=uicontrol(f,“样式”,“文本”,…“字符串”,“数据:”,…”位置“,[0 310 60 25]);t_data_table=uitable(f,“Position”,[0 15 1000 290],…“data”,default_data,…“ColumnFormat”,ColumnFormat_values);set(t_format_table,…“CellEditCallback”,…@(x,y)update_column_format(y.NewData,y.Indices,…t_data_table,popup_options));set(t_point_table,“CellEditCallback”,…@(x,y)validate_point_table(x,y,t_data_table));set(t_editable_table,“CellEditCallback”,…@(x,y)set(t_data_table,…“ColumnEditable”,get(t_edittable_table,”data“));set(b_add,…“回调”,@(x,y)update_data(b_add、t_point_table、…t_type_table、t_data_table));set(t_data_table,“CellSelectionCallback”,…@(x,y)update_point_table(y.Indices,t_point_table));结束函数

函数validate_point_table(h,dat,t_data_table)如果(！(dat.NewData>0&&…dat.NewData＜size(get(t_data_tble,“data”),dat。指数(1,1)+1))d=get(h,“数据”);d(数据指数)=1;集合(h,“数据”,d);endifend函数

函数update_column_format(格式,索引,t_data_table,…popup_options)cf=get(t_data_tble,“ColumnFormat”);if(strcmp(format,“[]”)format=“”;elseif(strcmp(format,“popup”))format=popup_options;endif cf{indexes(1,2)}=格式;set(t_data_table,“列格式”,cf);结束函数

函数update_point_table(indexes,t_point_table),如果(isempty(indexes))indexs=[1,1];endif集(t_point_table,“Data”,index(1,:));结束函数

函数update_data(b_add,t_point_table,t_type_table,…t_data_table)索引=get(b_add、“UserData”);如果(isempty(indexes))indexes=[1,1];endif d=get(t_data_table,“data”);t_type_table_data=get(t_type_table,“数据”);p=获取(t_point_table,“数据”);d(p(1,2),p(1,1))=t_type_table_data(index(1,2,2));set(t_data_table,“数据”,d);结束函数

详见: 图形,uicontrol.

 

:hui= ui菜单 (属性,value, …)¶

:hui= ui菜单 (h,属性,value, …)¶

创建一个uimenu对象并返回其句柄。

如果h则创建当前地物的顶级菜单。如果h然后给出一个子菜单h创建。

ui菜单对象具有以下特定属性:

加速器

包含键和CTRL的字符串,用于执行此菜单项(例如。,“x”用于CTRL+x)。

“已检查”

可以设置on或关。在此菜单项处设置符号。

使可能

可以设置on或关。如果禁用,则无法选择菜单项,并且菜单项变灰。

“前景色”

菜单项文本的颜色值。

“menuselected.cn”

执行此菜单项时调用的函数。它可以是函数串(例如。,“myfcn”),函数句柄(例如@myfcn)或包含回调函数的函数句柄和参数的元胞数组(例如{@myfcn,arg1,arg2})。

位置

包含相对菜单位置的标量值。第一个位置的值为1,将是左侧或顶部,具体取决于ui菜单的方向。

“分隔符”

可以设置on或关。如果启用,则在当前位置上方绘制一条分隔线。对于顶层条目,此属性将被忽略。

文本

包含此菜单项的文本的字符串。A."&"-符号可用于符号加速器字符(例如。,“退出(&X)”).

完整的属性清单记录在U菜单属性.

示例:

f=uimenu(“文本”、“&File”、“加速器”、“f”);e=uimenu(“文本”、“编辑(&e)”、“加速器”、“e”);ui菜单(f,“text”,“Close”,“accelerator”,“q”,…“menuselectedfcn”,“Close(gcf)”);uimenu(e,“text”,“Toggle&Grid”,“accelerator”,“g”,…“menuselectedfcn”,“Grid(gca)”);

详见: 图形.

 

:hui= ui上下文菜单 (属性,value, …)¶

:hui= ui上下文菜单 (h,属性,value, …)¶

创建一个uicontextmenu对象并返回其句柄。

如果h则创建当前图形的uicontextmenu。如果没有可用地物,将首先创建一个新地物。

如果h则给出一个相对于的uicontextmenuh创建。

任何提供的属性值对都将覆盖已创建的uicontextmenu对象的默认值。

完整的属性清单记录在上下文菜单属性.

示例:

##create figure和uicontextmanuf=figure();c=上下文菜单(f);##在上下文中创建菜单menum1=uimenu(“parent”,c,“label”,“Menu item 1”,…“callback”,“disp('Menu item1')”);m2=uimenu(“parent”,c,“label”,“Menu item 2”,…“callback”,“disp('Menu item2')”);##设置图形集的上下文菜单(f,“uicontextmenu”,c);

详见: 图形,ui菜单.

 

:hui= uitoolbar ()¶

:hui= uitoolbar (属性,value, …)¶

:hui= uitoolbar (父级对象亲)¶

:hui= uitoolbar (父级对象亲,属性,value, …)¶

创建一个uitoolbar对象。uitoolbar显示uioggletool和uipushtool按钮。

如果父级对象亲则为当前图形创建一个uitoolbar。如果没有可用地物,将首先创建一个新地物。

如果父级对象亲则给出一个相对于的uitoolbar父级对象亲已创建。

任何提供的属性值对都将覆盖已创建的uitoolbar对象的默认值。

完整的属性清单记录在工具栏属性.

可选返回值hui是createduitoolbar对象的图形句柄。

示例:

%创建不带默认工具栏的地物f=地物(“toolbar”,“none”);%create empty toolbart=uitoolbar(f);

详见: 图形,uitoggletol,uipushtool.

 

:hui= uipushtool ()¶

:hui= uipushtool (属性,value, …)¶

:hui= uipushtool (父级对象亲)¶

:hui= uipushtool (父级对象亲,属性,value, …)¶

创建uipushtool对象。

uipushtools是显示在地物工具栏上的按钮。创建的按钮带有一个边框,当用户将鼠标悬停在按钮上时会显示该边框。可以使用cdata属性设置图像。

如果父级对象亲则为当前图形创建一个uipushtool。如果没有可用地物,将首先创建一个新地物。如果图形可用,但不包含uitoolbar,则将创建uitoolbar。

如果父级对象亲则在上创建一个uipushtool父级对象亲uitoolbar。

任何提供的属性值对都将覆盖已创建的uipushtool对象的默认值。

完整的属性清单记录在按动开关属性.

可选返回值hui是createduipushtool对象的图形句柄。

示例:

%创建不带默认工具栏的地物f=地物(“toolbar”,“none”);%创建空工具栏=uitoolbar(f);%创建一个19x19x3的黑色正方形,mg=零(19,19,3);%将pushtool按钮添加到toolbarb=uipushtool(t,“cdata”,img);

详见: 图形,uitoolbar,uitoggletol.

 

:hui= uitoggletol ()¶

:hui= uitoggletol (属性,value, …)¶

:hui= uitoggletol (父级对象亲)¶

:hui= uitoggletol (父级对象亲,属性,value, …)¶

创建一个uitoggletol对象。

uitoggletol是显示在图形工具栏上的切换按钮。该按钮创建时带有一个边框,当用户将鼠标悬停在该按钮上方时会显示该边框。可以使用cdata属性设置图像。

如果父级对象亲则为当前图形创建一个uitoggletol。如果没有可用地物,将首先创建一个新地物。如果图形可用,但不包含uitoolbar,则将创建uitoolbar。

如果父级对象亲则在上创建uitoggletol父级对象亲uitoolbar。

任何提供的属性值对都将覆盖已创建的uitoggletool对象的默认值。

完整的属性清单记录在拨动开关属性.

可选返回值hui是createduitoggletool对象的图形句柄。

示例:

%创建不带默认工具栏的地物f=地物(“toolbar”,“none”);%创建空工具栏=uitoolbar(f);%创建一个19x19x3的黑色正方形,mg=零(19,19,3);%将uitoggletol按钮添加到toolbarb=uitoggletool(t,“cdata”,img);

详见: 图形,uitoolbar,uipushtool.