来源：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;

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

创建弹出式菜单，点击它时会显示选项列表。使用回调函数确定用户选择的列表项，并在 MATLAB 命令行窗口中显示选择。

将此代码保存为 mytemps.m。以下代码创建一个图窗窗口，其中包含具有三个列表项的弹出式菜单。然后，它使用回调函数查询弹出式菜单的 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

选择其他菜单项以更改选择。例如，如果从弹出式菜单中选择“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\'`		用户可从中选择一项或多项的项列表。与弹出式菜单不同，点击列表框时不会展开。要启用多项选择，请设置 `Max` 和 `Min` 属性以满足 `Max-Min > 1`。要在可以从一个列表框中选择多项时延迟操作，您可以将完成普通按钮与该列表框相关联。然后，使用该按钮的回调来计算列表框 `Value` 属性。
`\'popupmenu\'`		弹出式菜单（也称为下拉菜单），展开以显示选项列表。关闭时，弹出式菜单指示出当前选项。如果要提供许多互斥选项，请使用弹出式菜单。
`\'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\'`	与弹出式菜单中的选定项对应的数组索引。值 `1`（默认值）对应于弹出式菜单中的第一项。

客服电话

电子邮件

matlab中uicontrol创建用户界面控件

uicontrol

语法

说明

示例

创建单选按钮

在面板内创建滑块

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

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

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

输入参数

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

c - 用户界面控制对象UIControl 对象

名称-值对组参数

注意

\'Style\' - UIControl 对象的样式\'pushbutton\' （默认） | \'togglebutton\' | \'checkbox\' | \'radiobutton\' | ...

\'String\' - 要显示的文本字符向量 | 字符向量元胞数组 | 字符串数组 | 分类数组 | ...

注意

\'Position\' - 位置和大小[20 20 60 20] （默认） | [left bottom width height]

\'Value\' - 当前值数字

另请参阅

函数

属性

主题

请发表评论

全部评论

上一篇：

下一篇：

librespeed/speedtest: Self-hosted Speedt

Login &amp; Home Screen by Anton Aheicha

avehtari/BDA_m_demos: Bayesian Data Anal

四维彩超怎么看性别？四维看男孩女孩诀窍

medfreeman/markdown-it-toc-and-anchor: m

剪的笔顺,诠释剪的笔画,认识剪的部首

六六分期app的软件客服如何联系？(六六分期

florent37/ViewAnimator: A fluent Android

florent37/Shrine-MaterialDesign2: implem

CVE-2020-36276

SimpleSoftwareIO/simple-sms: Send and re

关于我们

产品与服务

解决方案