matlab中uicontrol创建用户界面控件

matlab中uicontrol创建用户界面控件

来源：https://ww2.mathworks.cn/help/matlab/ref/uicontrol.html?searchHighlight=uicontrol&s_tid=doc_srchtitle

本页对应的英文页面已更新，但尚未翻译。

若要查看最新内容，请点击此处访问英文页面。

uicontrol

创建用户界面控件

全页折叠

此函数仅用于 GUIDE 或者使用 figure 函数创建的 App。

App 设计工具是构建 App 的推荐环境。

有关详细信息，请参阅将 GUIDE App 迁移到 App 设计工具。

语法 c = uicontrol c = uicontrol(Name,Value) c = uicontrol(parent) c = uicontrol(parent,Name,Value) uicontrol(c)   说明

c = uicontrol 在当前图窗中创建一个普通按钮（默认用户界面控件），并返回 UIControl 对象。

如果图窗不存在，则 MATLAB 调用 figure 函数以创建一个图窗。

示例

c = uicontrol(Name,Value) 创建一个用户界面控件，其中包含使用一个或多个名称-值对组参数指定的属性值。

例如，'Style','checkbox' 会创建一个复选框。

c = uicontrol(parent) 在指定的父容器中创建默认用户界面控件，而不是默认为在当前图窗中。

示例

c = uicontrol(parent,Name,Value) 指定用户界面控件的父容器和一个或多个名称-值对组参数。

示例

uicontrol(c) 将焦点放在一个以前定义的用户界面控件上。

  示例

全部折叠

创建单选按钮

通过将 'Style' 名称-值对组参数指定为 'radiobutton' 来创建单选按钮。

通过指定 'String' 名称-值对组参数的值为单选按钮添加标签。

c = uicontrol('Style','radiobutton','String','Option 1');

在面板内创建滑块

创建一个图窗，其中有一个面板。

然后，通过调用 uicontrol 函数在面板中创建滑块，面板指定为父容器，'Style' 指定为 'slider'。

接下来，将滑块 Value 属性设置为 0.5。

f = figure;

p = uipanel(f,'Position',[0.1 0.1 0.35 0.65]);

c = uicontrol(p,'Style','slider');

c.Value = 0.5;

选择d出式菜单时的代码响应

创建d出式菜单，点击它时会显示选项列表。

使用回调函数确定用户选择的列表项，并在 MATLAB 命令行窗口中显示选择。

将此代码保存为 mytemps.m。

以下代码创建一个图窗窗口，其中包含具有三个列表项的d出式菜单。

然后，它使用回调函数查询d出式菜单的 Value 和 String 属性，并在命令行中显示所选项。

function mytemps

f = figure;

c = uicontrol(f,'Style','popupmenu');

c.Position = [20 75 60 20];

c.String = {'Celsius','Kelvin','Fahrenheit'};

c.Callback = @selection;

    function selection(src,event)

        val = c.Value;

        str = c.String;

        str{val};

        disp(['Selection: ' str{val}]);

    end

end

运行程序以生成图窗及其内容。

mytemps

选择其他菜单项以更改选择。

例如，如果从d出式菜单中选择“Kelvin”，则命令行将显示文本 Selection: Kelvin。

编写响应以下 *** 作的代码：点击按钮

创建普通按钮，点击它时会绘制数据。

将此代码保存为 pushbuttonPlot.m。

以下代码创建一个包含坐标区和普通按钮的图窗窗口。

每次点击该按钮时，回调函数都会执行并绘制五个正态分布随机数的条形图。

function pushbuttonPlot

f = figure;

ax = axes(f);

ax.Units = 'pixels';

ax.Position = [75 75 325 280]

c = uicontrol;

c.String = 'Plot Data';

c.Callback = @plotButtonPushed;

    function plotButtonPushed(src,event)

        bar(randn(1,5));

    end

end

运行 pushbuttonPlot，然后点击普通按钮。

MATLAB 将绘制数据。

使可编辑的文本字段具有焦点

创建一个可编辑的文本字段，并通过将其函数句柄传递给 uicontrol 函数使其具有焦点。

此 *** 作会使光标在可编辑文本字段中变为活动状态并闪烁。

c = uicontrol('Style','edit');

uicontrol(c);

输入参数

全部折叠

parent - 父对象

当前图窗 （默认） | Figure 对象 | Panel 对象 | ButtonGroup 对象 | Tab 对象

父对象，指定为使用 figure 函数创建的 Figure 对象或其子容器之一：Panel、ButtonGroup 或 Tab 对象。

在创建用户界面控件时，使用此参数指定父容器。

c - 用户界面控制对象

UIControl 对象

用户界面控件对象，指定为 UIControl 对象。

使用此参数指定要具有焦点的一个以前定义的用户界面控件。

示例： uicontrol(c)

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。

Name 为参数名称，Value 为对应的值。

Name 必须放在引号中。

您可采用任意顺序指定多个名称-值对组参数，如 Name1,Value1,...,NameN,ValueN 所示。

示例： uicontrol('Style','checkbox') 将复选框指定为用户界面控件的样式。

注意

此处所列的属性只是一部分。

有关完整列表，请参阅 UIControl 属性。

'Style' - UIControl 对象的样式

'pushbutton' （默认） | 'togglebutton' | 'checkbox' | 'radiobutton' | ...

UIControl 对象的样式，指定为下表中的值之一。

样式属性值 示例 说明 'pushbutton' 释放鼠标按键前显示为按下状态的按钮。

'togglebutton'

按钮，它在外观上类似于普通按钮，但在视觉上有状态指示：选中或清除。

'checkbox'

可以单独选择或清除的选项。

'radiobutton'

作为组的一部分的选项，选中它时会清除组中的其他选项。

要为一组单选按钮实现互斥行为，请将它们置于 uibuttongroup 中。

'edit'

可编辑的文本字段。

要启用多行文本，请设置 Max 和 Min 属性以满足 Max-Min > 1。

'text'

静态文本字段。

通常使用静态文本行为其他用户界面控件添加标签，向用户提供信息，或指示与滑块相关联的值。

要使静态文本响应鼠标点击，请将 Enable 属性设置为 'Inactive'，并使用 ButtonDownFcn 回调编写响应代码。

'slider'

用户沿水平或垂直滑动条移动的“滑块”按钮。

按钮沿条形的位置表示指定范围内的值。

'listbox'

用户可从中选择一项或多项的项列表。

与d出式菜单不同，点击列表框时不会展开。

要启用多项选择，请设置 Max 和 Min 属性以满足 Max-Min > 1。

要在可以从一个列表框中选择多项时延迟 *** 作，您可以将完成普通按钮与该列表框相关联。

然后，使用该按钮的回调来计算列表框 Value 属性。

'popupmenu'

d出式菜单（也称为下拉菜单），展开以显示选项列表。

关闭时，d出式菜单指示出当前选项。

如果要提供许多互斥选项，请使用d出式菜单。

'frame' 不推荐使用 'frame' 选项。

使用 uipanel 或 uibuttongroup，而不要使用框架。

在包含框架的 UI 中，GUIDE 继续支持其中的框架，但是在 GUIDE 布局编辑器组件面板中则不显示框架组件。

'String' - 要显示的文本

字符向量 | 字符向量元胞数组 | 字符串数组 | 分类数组 | ...

要显示的文本，指定为字符向量、字符向量元胞数组、字符串数组、分类数组或以管道分隔的行向量。

Style 属性指示您可以使用的数组格式。

样式属性 支持的数组格式 示例 'pushbutton'

字符向量

字符向量元胞数组

字符串数组

分类数组

'Option 1'

{'Option 1'}

"Option 1"

categorical({'Option 1'})

'togglebutton' 'checkbox' 'radiobutton' 'edit' 'text' 'listbox'

字符向量

字符向量元胞数组

字符串数组

分类数组

管道分隔的行向量

'One'

{'One','Two','Three'}

["One" "Two" "Three"]

categorical({'one','two','three'})

'One|Two|Three'

'popupmenu' 注意

如果为普通按钮、切换按钮、复选框或单选按钮指定元胞数组或分类数组，则 MATLAB 仅显示数组中的第一个元素。

'Position' - 位置和大小

[20 20 60 20] （默认） | [left bottom width height]

位置和大小，指定为 [left bottom width height] 形式的四元素向量。

默认测量单位为像素。

下表介绍向量中的每个元素。

元素 说明 left 父容器的内部左边缘与用户界面控件的外部左边缘之间的距离。

bottom 父容器的内部下边缘与用户界面控件的外部下边缘之间的距离。

width 用户界面控件的左右外侧边缘之间的距离。

height 用户界面控件的上下外侧边缘之间的距离。

Position 值相对于父容器的可绘制区域。

可绘制区域是指容器边框内的区域，不包括标题所占的区域。

如果父容器是一个图窗，可绘制区域还不包括菜单栏和工具栏。

'Value' - 当前值

数字

当前值，指定为数字。

用于查询或修改某些用户界面控件的状态。

下表说明与特定 UIControl 样式相关的 Value 属性。

样式属性 值属性的描述 'togglebutton'

• 已选择：Max 属性的值。
  

  
  

• 已清除：Min 属性的值。
  

  
  

'checkbox'

• 已选择：Max 属性的值。
  

  
  

• 已清除：Min 属性的值。
  

  
  

'radiobutton'

• 已选择：Max 属性的值。
  

  
  

• 已清除：Min 属性的值。
  

  
  

'slider' 与滑动条上的滑块位置关联的值。

'listbox' 与列表框中的选定项对应的数组索引。

值 1（默认值）对应于列表中的第一个项。

选择多个项时，Value 属性将行索引存储为一个向量。

'popupmenu' 与d出式菜单中的选定项对应的数组索引。

值 1（默认值）对应于d出式菜单中的第一项。

另请参阅 函数

• figure | uibuttongroup

属性

• UIControl 属性

主题

• 向编程式 App 中添加组件
• 特定组件的回调
• 访问属性值