ui*系列函数全部在qt环境中起最佳效果,即便有一部分函数基于fltk工具包实现。完全不支持gnuplot工具包。
h= uifigure ()¶
h= uifigure ("property",value, …)¶
为应用程序创建一个新的图形对象窗口。
可以为图形对象对象指定多个属性值对,但它们必须成对出现。
返回值h是已创建图形对象对象的图形句柄。
编程说明:属性的完整列表详见图形属性。此函数不同于figure因为创建的图形是为应用程序开发而优化的,而不是绘图。这意味着菜单栏和工具栏等函数将被关闭。
这种方式不能完美替代MATLAB的uifigure对象，因为"AutoResizeChildren", "Icon"和"Scrollable"属性未使用。
详见: uipanel,uibuttongroup.
hui= uipanel ()¶
hui= uipanel (property,value, …)¶
hui= uipanel (parent)¶
hui= uipanel (parent,property,value, …)¶
创建uipanel对象。
uipanels用作容器来对其他uicontrol对象进行分组。
如果指定parent，则会创建当前图形的uipanel。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定parent，则创建相对于parent的一个uipanel。
任何提供的属性值对都将覆盖已创建的uipanel对象的默认值。
完整的属性清单详见Uipanel Properties.
可选返回值hui是创建的uipanel对象的图形句柄。
示例:
## create figure and panel on it
f = figure;
p = uipanel ("title", "Panel Title", "position", [.25 .25 .5 .5]);
## add two buttons to the panel
b1 = uicontrol ("parent", p, "string", "A Button", ...
"position", [18 10 150 36]);
b2 = uicontrol ("parent", p, "string", "Another Button", ...
"position",[18 60 150 36]);
hui= uibuttongroup ()¶
hui= uibuttongroup (property,value, …)¶
hui= uibuttongroup (parent)¶
hui= uibuttongroup (parent,property,value, …)¶
(h)¶
创建一个uibuttongroup对象并返回其句柄。
uibuttongroup用于对uicontrol对象进行分组。
如果指定parent，则为当前图形对象创建一个uibuttongroup。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定parent，则创建一个相对于parent的一个uibuttongroup。
任何提供的属性值对都将覆盖已创建的uibuttongroup对象的默认值。
完整的属性清单详见Uibuttongroup Properties.
示例:
## Create figure and panel on it
f = figure;
## Create a button group
gp = uibuttongroup (f, "Position", [ 0 0.5 1 1])
## Create a buttons in the group
b1 = uicontrol (gp, "style", "radiobutton", ...
"string", "Choice 1", ...
"Position", [ 10 150 100 50 ]);
b2 = uicontrol (gp, "style", "radiobutton", ...
"string", "Choice 2", ...
"Position", [ 10 50 100 30 ]);
## Create a button not in the group
b3 = uicontrol (f, "style", "radiobutton", ...
"string", "Not in the group", ...
"Position", [ 10 50 100 50 ]);
使用单个参数调用时h是现有uibuttongroup对象的句柄,将焦点切换到指定的uibuttongroup。此函数目前尚未实现。
hui= uicontrol ()¶
hui= uicontrol (property,value, …)¶
hui= uicontrol (parent)¶
hui= uicontrol (parent,property,value, …)¶
(h)¶
创建uicontrol对象并向其返回句柄。
uicontrol对象用于创建简单的交互式控件,如按钮、复选框、编辑和列表控件。
如果指定parent，则为当前图形创建uicontrol。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定parent，则创建相对于parent的一个uicontrol。
任何提供的属性值对都将覆盖创建的uicontrol对象的默认值。
完整的属性清单详见Uicontrol Properties.
创建的uicontrol类型从指定style属性如果没有提供样式属性,将创建一个按钮。
uicontrol的有效样式为:
"checkbox"创建允许用户打开/关闭选择的复选框控件。
"edit"创建一个编辑控件,允许用户输入单行或多行文本。
"listbox"创建一个列表框控件,该控件显示项目列表,并允许用户选择单个或多个项目。
"popupmenu"创建一个弹出菜单控件,显示用户单击该控件时可以选择的参数列表。
"pushbutton"创建一个按钮控件,允许用户按下以进行操作。
"radiobutton"创建一个单选按钮控件,用于在一组单选按钮控件中互斥输入。
"slider"创建一个滑块控件,允许用户通过滑动控件上的旋钮从一系列值中进行选择。
"text"创建一个静态文本控件以显示单行或多行文本。
"togglebutton"创建一个看起来像按钮的切换按钮控件,但允许用户在两种状态之间进行选择。
注意:对于"edit"和"listbox"样式,如果指定了Max - Min > 1 ,那么"Min"和"Max"属性用于选择单行或多行.
示例:
## Create figure and panel on it
f = figure;
## Create a button (default style)
b1 = uicontrol (f, "string", "A Button", ...
"position", [10 10 150 40]);
## Create an edit control
e1 = uicontrol (f, "style", "edit", "string", "editable text", ...
"position", [10 60 300 40]);
## Create a checkbox
c1 = uicontrol (f, "style", "checkbox", "string", "a checkbox", ...
"position", [10 120 150 40]);
使用单个参数调用时h是现有图标控制对象的句柄,将键盘焦点切换到指定的图标控制。因此,uicontrol对象将接收可以使用处理的键盘事件"keypressfcn"回调。
hui= uitable (property,value, …)¶
hui= uitable (parent,property,value, …)¶
创建一个uitable对象并返回一个句柄。
uitable对象用于在图形窗口中显示数据表。
如果指定parent，则创建适用于当前图形的图形。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定parent，则创建相对于parent一个uitable。
任何提供的属性值对都将覆盖创建的合适对象的默认值。
完整的属性清单详见Uitable Properties.
示例:
## Create figure and place a table on it
f = figure ();
m = magic (8);
t = uitable (f, "Data", m, "ColumnWidth", { 40 });
## Create a table with labeled rows and columns
f = figure ();
d = reshape (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, "Position");
e = get (t, "Extent");
p(3:4) = e(3:4);
set (t, "Position", p);
## Long demo with callbacks
function uitable_demo ()
f = figure ("Name", "uitable Demo", "Menu", "none", ...
"Position", [10 10 1000 680]);
## A basic example
d = { "char" , "A string";
"double" , 12.3456789;
"complex", 1+2i;
"bool" , true;
"single" , single(12.3456789);
"int8" , int8(-128);
"uint8" , uint8(128);
"int16" , int16(-32768);
"uint16" , uint16(32768);
"int32" , int32(-2147483648);
"uint32" , uint32(2147483648);
"int64" , int64(-2147483649);
"uint64" , uint64(2147843649)};
popup_options = {"A", "B", "C", "D", "E"};
columnformat_options = { "[]", "char", "pop-up", "numeric", ...
"short", "short e", "short eng", ...
"short g", "long", "long e", ...
"long eng", "long g", "bank", "+", ...
"rat", "logical"};
columnformat_values = columnformat_options;
columnformat_values{1} = "";
columnformat_values{3} = popup_options;
default_data = repmat (d(:,2), 1, columns (columnformat_options));
b_add = uicontrol (f, "Position", [285 630 600 50], ...
"UserData", [rows(d), 1], ...
"Style", "pushbutton", ...
"String", "Set data at selected point to selected datatype");
l_type_table = uicontrol (f, "Position", [ 0 603 120 25 ], ...
"String", "Datatype Table:", ...
"Style", "text");
t_type_table = uitable (f, "Position", [ 0 530 1000 70 ], ...
"Data", transpose (d(:, 2)), ...
"ColumnName", transpose (d(:, 1)), ...
"RowName", "Value", ...
"CellSelectionCallback", ...
@(x, y) set (b_add, "UserData", y.Indices ));
l_point_table = uicontrol (f, "Position", [ 0 640 60 25 ], ...
"String", "Point:", ...
"Style", "text");
t_point_table = uitable (f, "Position", [ 80 630 160 42 ], ...
"RowName", [], ...
"ColumnName", {"x", "y"}, ...
"Data", [ 1, 1 ], ...
"ColumnEditable", true);
l_editable_table = uicontrol (f, "Position", [ 0 502 200 25 ], ...
"Style", "text", ...
"String", "Set Data Columns Editable:");
t_editable_table = ...
uitable (f, "Position", [ 0 434 1000 65 ], ...
"Data", repmat (false, 1, columns (default_data)), ...
"ColumnEditable", true);
l_format_table = uicontrol (f, "Position", [ 0 406 200 25 ], ...
"Style", "text", ...
"String", "Set Data Column Format:");
t_format_table = ...
uitable (f, "Position", [ 0 338 1000 65 ], ...
"Data", columnformat_options, ...
"ColumnEditable", true, ...
"ColumnFormat", arrayfun (@(x) {columnformat_options}, ...
1:columns (columnformat_options)));
l_data_table = uicontrol (f, "Style", "text", ...
"String", "Data:", ...
"Position", [ 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_editable_table, "Data")));
set (b_add, ...
"Callback", @(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));
endfunction
function validate_point_table (h, dat, t_data_table)
if (! (dat.NewData > 0 && ...
dat.NewData < size (get (t_data_table, "Data"), dat.Indices(1, 1)) + 1))
d = get (h, "Data");
d(dat.Indices) = 1;
set (h, "Data", d);
endif
endfunction
function update_column_format (format, indices, t_data_table, ...
popup_options)
cf = get (t_data_table, "ColumnFormat");
if (strcmp (format, "[]"))
format = "";
elseif (strcmp (format, "pop-up"))
format = popup_options;
endif
cf{indices(1,2)} = format;
set (t_data_table, "ColumnFormat", cf);
endfunction
function update_point_table (indices, t_point_table)
if (isempty (indices))
indices = [1, 1];
endif
set (t_point_table, "Data", indices(1,:));
endfunction
function update_data (b_add, t_point_table, t_type_table, ...
t_data_table)
indices = get (b_add, "UserData");
if (isempty (indices))
indices = [1, 1];
endif
d = get (t_data_table, "Data");
t_type_table_data = get (t_type_table, "Data");
p = get (t_point_table, "Data");
d(p(1,2), p(1,1)) = t_type_table_data(indices(1,2));
set (t_data_table, "Data", d);
endfunction
创建一个uimenu对象并返回其句柄。
如果指定h，则创建当前图形对象的顶级菜单。如果指定h，那么创建h的一个子菜单。
ui菜单对象具有以下特定属性:
"accelerator"包含键+CTRL的字符串,用于执行此菜单项(例如"x"用于CTRL+x)。
"checked"可以设置"on"或"off"。在此菜单项处设置对号。
"enable"可以设置"on"或"off"。如果禁用,则无法选择菜单项,并且菜单项变灰。
"foregroundcolor"菜单项文本的颜色值。
"menuselectedfcn"执行此菜单项时调用的函数。它可以是函数串(例如"myfcn"),函数句柄(例如@myfcn)或包含回调函数的函数句柄和参数的元胞数组(例如{@myfcn,arg1,arg2})。
"position"包含相对菜单位置的标量值。第一个位置的值为1,代表左侧或顶部,具体取决于ui菜单的方向。
"separator"可以设置"on"或"off"。如果启用,则在当前位置上方绘制一条分隔线。对于最上面的分量,此属性将被忽略。
"text"包含此菜单项的文本的字符串。一个"&"符号可用于符号"accelerator"字符(例如"E&xit").
完整的属性清单详见Uimenu Properties.
示例:
f = uimenu ("text", "&File", "accelerator", "f");
e = uimenu ("text", "&Edit", "accelerator", "e");
uimenu (f, "text", "Close", "accelerator", "q", ...
"menuselectedfcn", "close (gcf)");
uimenu (e, "text", "Toggle &Grid", "accelerator", "g", ...
"menuselectedfcn", "grid (gca)");
详见: figure.
创建一个uicontextmenu对象并返回其句柄。
如果指定h，则创建当前图形的uicontextmenu。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定h，则创建相对于h的一个uicontextmenu。
任何提供的属性值对都将覆盖已创建的uicontextmenu对象的默认值。
完整的属性清单详见Uicontextmenu Properties.
示例:
## create figure and uicontextmenu
f = figure ();
c = uicontextmenu (f);
## create menus in the context menu
m1 = uimenu ("parent", c, "label", "Menu item 1", ...
"callback", "disp('menu item 1')");
m2 = uimenu ("parent", c, "label", "Menu item 2", ...
"callback", "disp('menu item 2')");
## set the context menu for the figure
set (f, "uicontextmenu", c);
hui= uitoolbar ()¶
hui= uitoolbar (property,value, …)¶
hui= uitoolbar (parent)¶
hui= uitoolbar (parent,property,value, …)¶
创建一个uitoolbar对象。uitoolbar显示uioggletool和uipushtool按钮。
如果指定parent，则为当前图形创建一个uitoolbar。如果没有可用图形对象,将首先创建一个新图形对象。
如果指定parent，则创建相对于parent的一个uitoolbar。
任何提供的属性值对都将覆盖已创建的uitoolbar对象的默认值。
完整的属性清单详见Uitoolbar Properties.
可选返回值hui是创建的uitoolbar对象的图形句柄。
示例:
% create figure without a default toolbar
f = figure ("toolbar", "none");
% create empty toolbar
t = uitoolbar (f);
详见: figure,uitoggletool,uipushtool.
hui= uipushtool ()¶
hui= uipushtool (property,value, …)¶
hui= uipushtool (parent)¶
hui= uipushtool (parent,property,value, …)¶
创建uipushtool对象。
uipushtools是显示在图形对象工具栏上的按钮。创建的按钮带有一个边框,当用户将鼠标悬停在按钮上时会显示该边框。可以使用cdata属性设置图像。
如果指定parent，则为当前图形创建一个uipushtool。如果没有可用图形对象,将首先创建一个新图形对象。如果图形可用,但不包含uitoolbar,则将创建uitoolbar。
如果指定parent，则在parent uitoolbar上创建一个uipushtool。
任何提供的属性值对都将覆盖已创建的uipushtool对象的默认值。
完整的属性清单详见Uipushtool Properties.
可选返回值hui是创建的uipushtool对象的图形句柄。
示例:
% create figure without a default toolbar
f = figure ("toolbar", "none");
% create empty toolbar
t = uitoolbar (f);
% create a 19x19x3 black square
img=zeros(19,19,3);
% add pushtool button to toolbar
b = uipushtool (t, "cdata", img);
详见: figure,uitoolbar,uitoggletool.
hui= uitoggletool ()¶
hui= uitoggletool (property,value, …)¶
hui= uitoggletool (parent)¶
hui= uitoggletool (parent,property,value, …)¶
创建一个uitoggletol对象。
uitoggletol是显示在图形工具栏上的切换按钮。该按钮创建时带有一个边框,当用户将鼠标悬停在该按钮上方时会显示该边框。可以使用cdata属性设置图像。
如果指定parent，则为当前图形创建一个uitoggletol。如果没有可用图形对象,将首先创建一个新图形对象。如果图形可用,但不包含uitoolbar,则将创建uitoolbar。
如果指定parent，则在parent uitoolbar上创建uitoggletol。
任何提供的属性值对都将覆盖已创建的uitoggletool对象的默认值。
完整的属性清单详见Uitoggletool Properties.
可选返回值hui是创建的uitoggletool对象的图形句柄。
示例:
% create figure without a default toolbar
f = figure ("toolbar", "none");
% create empty toolbar
t = uitoolbar (f);
% create a 19x19x3 black square
img=zeros(19,19,3);
% add uitoggletool button to toolbar
b = uitoggletool (t, "cdata", img);
详见: figure,uitoolbar,uipushtool.
版权所有 © 2024-2025 Octave中文网
ICP备案/许可证号：黑ICP备2024030411号-2