uicontrol

创建用户界面控制

使用此功能只与指南,或使用创建的应用程序数字功能。应用程序设计是建设Apps的建议环境。欲了解更多信息,请参阅指南迁移策略

描述

C = uicontrol创建在当前图中的按钮(默认用户界面控制),并返回UIControl宾语。如果这个数字不存在,那么MATLAB®调用数字函数来创建一个。

C = uicontrol(名称,值创建具有使用一个或多个名称值对参数指定的属性值的用户界面控件。例如,“风格”,“复选框”创建一个复选框。

C = uicontrol(创建的,而不是默认为当前图中指定的父默认的用户界面控制,。

C = uicontrol(名称,值指定用于用户接口控制和一个或多个名称值对参数的父。

uicontrol(C给集中到一个先前定义的用户接口控制。

例子

全部收缩

通过指定创建一个单选按钮'样式'名称 - 值对参数作为'单选按钮'。通过指定一个值标签的单选按钮'串'名称 - 值对的参数。

C = uicontrol('样式''单选按钮''串''选项1');

创建人物并定位在它的面板。然后,通过调用创建面板中的滑块uicontrol与面板功能指定为亲和'样式'指定为“滑块”。接下来,设置滑块属性0.5

F =图。P = uipanel(F,'位置'[0.1 0.1 0.35 0.65]);C = uicontrol(P,'样式'“滑块”);c.Value = 0.5;

创建显示的选项列表点击后弹出菜单。使用一个回调函数,以确定由用户选择的列表项,并显示在MATLAB命令窗口中选择。

这段代码保存为mytemps.m。这段代码创建包含三个列表项的弹出菜单中的图形窗口。然后,它使用一个回调函数来查询弹出菜单和显示在命令行所选择的项的属性。

功能mytemps F =图。C = uicontrol(F,'样式''弹出菜单');c.Position = [20 75 60 20];c.String = {“摄氏”“开尔文”“飞轮海”};c.Callback = @selection;功能选择(SRC,事件)VAL = c.Value;STR = c.String;STR {VAL};DISP([“选择:”STR {VAL}]);结束结束

运行程序产生的数字,它的内容。

mytemps

选择不同的菜单项来更改选择。例如,如果您从弹出菜单中选择“开”,在命令行,然后显示文本选择:开尔文

创建一个按钮,情节数据,当您点击它。

这段代码保存为pushbuttonPlot.m。此代码创建一个包含轴和按钮的图形窗口。每次单击该按钮时,回调函数执行和图5张正态分布随机数的柱状图。

功能pushbuttonPlot F =图。AX =轴线(F);ax.Units ='像素';ax.Position = [75 75 325 280 C = uicontrol;c.String =“图数据”;c.Callback = @plotButtonPushed;功能plotButtonPushed(SRC,事件)巴(randn(1,5));结束结束

pushbuttonPlot,然后单击按钮。MATLAB绘制数据。

创建一个可编辑的文本字段,并通过将其功能手柄插入使其焦点uicontrol功能。此操作会导致光标变得活跃,并且闪烁,可编辑的文本字段内。

C = uicontrol('样式''编辑');uicontrol(C);

输入参数

全部收缩

父对象,指定为数字对象使用所创建的数字功能,或作为其子容器中的一种:面板ButtonGroup中, 要么标签宾语。使用此参数创建用户界面控件时指定的父容器。

用户接口控制对象,指定为UIControl宾语。使用此参数指定预先定义的用户界面控件,您希望把成为关注的焦点。

例:uicontrol(c)中

名称 - 值对参数

指定可选的用逗号分隔的对名称,值参数。名称是参数的名称和是对应的值。名称必须出现引号内。您可以按照任何顺序指定多个名称和值对参数名1,值1,...,NameN,值N

例:uicontrol( '风格', '复选框')指定复选框中的用户界面控件的样式。

注意

这里列出的属性是唯一的一个子集。有关完整列表,请参阅UIControl属性

风格UIControl对象,指定为从下表中的值。

样式属性值 描述
“按钮” 按钮时出现压低,直到你松开鼠标按钮。
“切换按钮”


按钮看起来像一个按钮,但在视觉上表示它的状态:选中或清除。
“复选框”


选项可被选择或清除独立。
'单选按钮'


选项,旨在形成一个基团的一部分,例如在被选择时,它清除该组中的其他选项。


要实现一组单选按钮互斥的行为,将它们放置内uibuttongroup

'编辑'

可编辑的文本字段。


要启用多行文本,设置马克斯属性,以便最大 - 最小> 1

'文本'

静态文本字段。使用静态文本标记其他用户界面控件,提供信息给用户,或指示与滑块相关的值。


为了让静态文本响应鼠标点击,设置启用属性“无效”并与码的响应ButtonDownFcn打回来。

“滑块”

“拇指”按钮,用户沿水平或垂直条移动。沿着杆的按钮的位置表示在指定的范围内的值。

'列表框'

从中用户可以选择一个或多个项目的产品清单。不同于弹出菜单,点击后列表框不扩大。


为了使项目的多重选择,设定马克斯属性,以便最大 - 最小> 1。推迟采取行动时,多个项目可以从列表框中选择,可以关联一个完成与列表框按钮。然后,使用回调该按钮来评估列表框中属性。

'弹出菜单'

弹出菜单(也称为下拉菜单),展开后会显示一个选择列表。当关闭时,弹出菜单指示当前的选择。当你想提供一些互相排斥的选择使用弹出式菜单。

'帧' '帧'不建议选择。采用uipanel要么uibuttongroup而不是帧数。GUIDE继续支持包含它们的用户界面框万博1manbetx架,但框架组件不会出现在手册布局编辑器组件面板。

要显示的文本,指定为字符向量,特征向量的单元阵列中,字符串数组,分类阵列或管道分隔行向量。该样式属性使然,你可以使用数组格式。

Style属性 万博1manbetx支持的阵列格式 例子
“按钮”

特征向量


字符向量的单元阵列


String数组


分类数组

'选项1'


{'选项1'}


“选项1”


分类({ '选项1'})

“切换按钮”
“复选框”
'单选按钮'
'编辑'
'文本'
'列表框'

特征向量


字符向量的单元阵列


String数组


分类数组


竖线分隔行向量

'一'


{'一二三'}


[“一二三”]


分类({ '一个', '2', '3'})


“一|二|三”

'弹出菜单'

注意

如果指定了阵列中的单元阵列或用于按钮,切换按钮,复选框或单选按钮类别阵列,MATLAB仅显示第一个元素。

位置和大小,指定为以下形式的四元素矢量[左底部宽度高度]。默认测量单位是像素。该表描述了在向量中的每个元素。

元件 描述
剩下 从父容器的所述用户接口控制的外部左侧边缘内左边缘的距离。
底部 从父容器的所述用户接口控制的外部底边缘的内底边缘的距离。
宽度 右侧和用户接口控制的左外边缘之间的距离。
高度 顶部和用户接口控制的底部外边缘之间的距离。

位置值是相对父容器的绘制区域。该绘制区域是容器的边框内的区域,不包括由标题所占用的面积。如果父容器是图中,绘制区域也排除了菜单栏和工具栏。

电流值,指定为数字。用于查询或修改某些用户界面控件的状态。表描述了相对于特定的属性UIControl样式。

Style属性 Value属性的说明
“切换按钮”
  • 选择:价值马克斯属性。

  • 清除:价值属性。

“复选框”
  • 选择:价值马克斯属性。

  • 清除:价值属性。

'单选按钮'
  • 选择:价值马克斯属性。

  • 清除:价值属性。

“滑块” 沿滑杆拇指位置相关联的价值。
'列表框' 对应于列表框中选择的项目数组索引。的价值1(默认),对应于列表中的第一项。当选择多个项目时,属性存储行的索引作为载体。
'弹出菜单' 对应于弹出菜单的选择项数组索引。的价值1(默认),对应于弹出菜单中的第一项。

R2006a前推出