主要内容

面板属性

控制面板外观uifigure的应用程序

面板是用于将UI组件分组的容器。属性控制面板的外观和行为。使用点表示法指示特定对象和属性。

图= Uifigure;p = UIPanel('父',图);p.title ='显示选项';

此处列出的属性对于App Designer中的面板有效,或在创建的应用程序中uifigure函数。用于指南中使用的面板,或使用数字功能,参见面板属性

标题

展开全部

标题,指定为字符向量、字符串标量或分类数组。如果你指定这个属性为分类数组,MATLAB®只显示数组中的第一个元素。

MATLAB不会解释垂直斜杠(“|”)字符作为换行符,它在标题中显示为垂直斜杠。

如果要指定Unicode®字符,将Unicode十进制码传递给char函数。例如,['多重' char(960)]显示为倍数π

标题的位置,指定为'左撇子''Centertop',或“righttop”

颜色和样式

展开全部

标题颜色,指定为RGB三重态,十六进制颜色代码或表中列出的颜色选项之一。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0F.这些值不区分大小写。因此,颜色是代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 简称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

“绿色” 'G' [0 1 0] “# 00 ff00”

'蓝色的' “b” [0 0 1] “# 0000 ff”

“青色” 'C' [0 1 1] '#00ffff'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色' “y” (1 1 0) “# FFFF00”

'黑色的' 'K' [0 0 0] '#000000'

“白色” ' w ' (1 1 1) “# FFFFFF”

以下是RGB三元组和十六进制颜色代码,用于默认颜色MATLAB在许多类型的图中使用。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) '#0072bd'

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

(0.4660 0.6740 0.1880) '#77ac30'

[0.3010 0.7450 0.9330] '#4dbeee'

(0.6350 0.0780 0.1840) “# A2142F”

背景颜色,指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0F.这些值不区分大小写。因此,颜色是代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 简称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

“绿色” 'G' [0 1 0] “# 00 ff00”

'蓝色的' “b” [0 0 1] “# 0000 ff”

“青色” 'C' [0 1 1] '#00ffff'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色' “y” (1 1 0) “# FFFF00”

'黑色的' 'K' [0 0 0] '#000000'

“白色” ' w ' (1 1 1) “# FFFFFF”

以下是RGB三元组和十六进制颜色代码,用于默认颜色MATLAB在许多类型的图中使用。

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) '#0072bd'

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

[0.4940 0.1840 0.5560] “# 7 e2f8e”

(0.4660 0.6740 0.1880) '#77ac30'

[0.3010 0.7450 0.9330] '#4dbeee'

(0.6350 0.0780 0.1840) “# A2142F”

面板边框,指定为“行”“没有”

字体

展开全部

字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和地区。

如果指定的字体不可用,则Matlab使用应用程序正在运行的系统上可用的字体之间的最佳匹配。

例子:'arial'

字体大小,指定为正数。度量单位是像素。默认字体大小取决于特定的操作系统和地区。

例子:14

字体重量,指定为其中一个值:

  • “正常”-由特定字体定义的默认权重

  • “大胆”- 比较厚的字符概述“正常”

并不是所有的字体都有粗体字体。因此,指定粗体字体权重可能导致正常字体权重。

字体角度,指定为“正常”“斜体”.将此属性设置为斜体选择倾斜的字体版本,如果它是可用的应用程序用户的系统。

字体测量单位,指定为“像素”.在Windows上,像素距离与系统分辨率无关®和麦金塔系统:

  • 在Windows系统中,像素是1/96英寸。

  • 在麦金塔系统中,像素是1/72英寸。

  • 在Linux上®在系统中,一个像素的大小是由你的系统分辨率决定的。

交互性

展开全部

可见性状态,指定为“上”'离开',或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnoffSwitchState.

  • “上”—显示对象。

  • '离开'-隐藏对象而不删除它。您仍然可以访问不可见的UI组件的属性。

要使你的应用程序启动得更快,请设置可见的财产'离开'对于所有不需要在启动时出现的组件。

更改无形集装箱的大小触发了SizeChangedFcn当它变得可见时回调。

改变这一点可见的容器的财产不是的值可见的子组件的属性。即使隐藏容器导致要隐藏的子组件,也是如此。

滚动能力,指定为'离开'“上”,或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnoffSwitchState.

将此属性设置为“上”启用容器内滚动。然而,还有其他要求:

  • 容器中的子组件必须占用比容器一次可以显示的更大的区域。

  • 不能装入容器的组件必须位于容器上方或右侧。不能滚动到容器下方或左侧的组件。

某些类型的图表和轴不支持可滚动容器。金宝app但是,您可以将图表或轴放置在不可滚动的面板中,然后将面板放置在可滚动的容器中。有关更多信息,请参见在App Designer中显示图形

操作状态,指定为“上”'离开',或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnoffSwitchState.

  • 如果将此属性设置为“上”,App用户可以与组件交互。

  • 如果将此属性设置为'离开',组件显示为灰色,表明应用程序用户不能与它交互,并且它将不会触发回调。

的值启用属性为面板不是的值启用属性用于该面板中包含的UI组件。

工具提示,指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。当用户在运行时将指针悬停在组件上时,使用此属性显示消息。若要显示多行文本,请指定字符向量单元格数组或字符串数组。数组中的每个元素变成一行单独的文本。如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是全部类别集合。

上下文菜单,指定为上下文菜单使用的对象UIContextMenu.函数。右键单击组件时,请使用此属性显示上下文菜单。

位置

展开全部

面板的位置和大小,包括边界和标题,指定为表格的四元素矢量[左下宽度].该表描述了向量中的每个元素。

元素 描述
父容器的左内边缘到面板的左外边缘的距离
底部 从父容器的内底边缘到面板的外底边缘的距离
宽度 面板右侧和左左侧边缘之间的距离
高度 面板上外侧与下外侧之间的距离

所有测量的单位均由单位财产。

位置值是相对于可拉的区域父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

此属性是只读的。

面板的位置和大小,不包括边框和标题,作为表单的四元素向量返回[左下宽度].该表描述了向量中的每个元素。

价值 描述
从父容器的内左边缘到面板内左边缘的距离。
底部 从父容器的内底边缘到面板的内底边缘的距离。
宽度 面板左右边框的内边缘之间的距离。
高度 面板上边框和下边框的内边框之间的距离。这个距离排除了标题(如果标题存在)。

所有测量的单位均由单位财产。

请注意

这些是使用the时需要考虑的一些要点内在属性:

  • 内在值会受到标题、字体特征和BorderType

  • 内在值是相对于父容器的可拉的区域.绘制区域是容器边界内的区域,不包括标题所占据的区域。

面板的位置和大小,包括边界和标题,指定为表格的四元素矢量[左下宽度].所有测量的单位均由单位财产。

此属性值与此属性相同位置属性值。

测量单位,指定为“像素”

自动调整子节点的大小,指定为“上”'离开',或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnoffSwitchState.

  • “上”-子组件会在容器大小调整时自动调整大小。

  • '离开'- 子组件不调整大小。

autolesizechildren.属性影响容器的直接子容器,而不是嵌套容器中的子容器。

要自定义调整大小行为,请设置autolesizechildren.财产'离开'并创建一个SizeChangedFcn容器的回调。有关更多信息,请参见在应用设计器中管理可调整大小的应用程序

要禁用调整应用程序大小,请设置调整图形的属性'离开'

布局选项,指定为GridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,不起作用。但是,如果组件是网格布局容器的子组件,则可以通过设置柱子属性GridLayoutOptions对象。

例如,此代码将面板放在其父网格的第三行和第二列中。

g = uigrivlayout([4 3]);p = UIPanel(g);p.layout.row = 3;p.layout.column = 2;

要使面板跨越多行或列,请指定柱子属性为二元素向量。例如,这个面板跨列2通过3.

p.Layout.Column = [2 3];

回调

展开全部

大小改变回调,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

当容器的大小发生变化时(例如,当用户调整窗口的大小),定义这个回调函数来定制应用程序的布局。在其中,编写代码来调整位置子组件的属性。

请注意

SizeChangedFcn回调不会执行,除非autolesizechildren.此容器的属性设置为'离开'.在App Designer中,你可以SizeChangedFcn通过选择容器并清除autolesizechildren.复选框检查员选项卡组件浏览器

SizeChangedFcn回调执行时间:

  • 这个容器第一次变得可见。

  • 在其尺寸变化时,此容器可见。

  • 该容器在其尺寸变化后第一次可见。当容器是不可见的尺寸更改时,会发生这种情况,然后稍后会看到它。

定义a时需要考虑的其他要点SizeChangedFcn回调函数:

  • 考虑延迟这个容器的显示,直到在所有变量之后SizeChangedFcn使用定义。这种做法可以防止SizeChangedFcn从返回错误回调。若要延迟显示容器,请设置其可见的财产'离开'.然后,设置可见的财产“上”定义您的变量后SizeChangedFcn回调使用。

  • 如果你的应用程序包含嵌套容器,它们会从内到外调整大小。

  • 控件内访问正在调整大小的容器SizeChangedFcn,请参阅源对象(回调中的第一个输入参数)或使用gcbo函数。

指定调整大小行为的另一种方法是创建GridLayout对象或使用App Designer中的自动回流选项。这些选项比SizeChangedFcn回调。但是,有一些优势SizeChangedFcn回调有这些选项。例如:

  • 将组件调整为最小或最大大小为您定义的。

  • 实现非线性的调整大小行为,例如根据父容器的大小更改组件的大小。

按下回调函数,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅如何指定回调属性值

buttondownfcn.回调是在用户单击容器内的鼠标按钮时执行的函数。

对象创建函数,指定为其中一个值:

  • 函数处理。

  • 其中第一元素是函数手柄的单元阵列。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

此属性指定MATLAB创建对象时执行的回调函数。方法之前,MATLAB初始化所有属性值CreateFcn.打回来。如果不指定CreateFcn.属性,然后matlab执行默认的创建功能。

设置CreateFcn.属性对现有组件没有影响。

如果将此属性指定为函数句柄或单元格数组,则可以访问使用回调函数的第一个参数创建的对象。否则,使用gcbo访问对象的函数。

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 其中第一元素是函数手柄的单元阵列。cell数组中的后续元素是要传递给回调函数的参数。

  • 字符向量包含有效的MATLAB表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

此属性指定当MATLAB删除对象时执行的回调函数。MATLAB执行deletefcn.在销毁对象的属性之前回调。如果不指定deletefcn.属性,然后matlab执行默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问要删除的对象。否则,使用gcbo访问对象的函数。

回调执行控制

展开全部

回调中断,指定为“上”'离开',或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnoffSwitchState.

此属性确定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 中断回调是一个回调,它试图中断运行的回调。

每当matlab调用回调时,回调尝试中断运行的回调(如果存在)。的可中断属性决定是否允许中断。

  • 的值“上”允许其他回调中断对象的回调。中断发生在matlab处理队列的下一个点,例如何时存在drawnow数字uifiguregetframe等待,或暂停命令。

    • 如果正在运行的回调函数包含其中一个命令,那么MATLAB将在此时停止回调函数的执行,并执行中断回调函数。当中断回调完成时,MATLAB继续执行正在运行的回调。

    • 如果正在运行的回调函数不包含这些命令之一,那么MATLAB将在不中断的情况下完成回调函数的执行。

  • 的值'离开'阻止所有中断尝试。的BusyAction拥有中断回调的对象的属性决定中断回调是否被丢弃或放入队列中。

请注意

在这些情况下,回调中断和执行的行为是不同的:

  • 如果中断回调为deletefcn.CloseEquestfcn.SizeChangedFcn回调,则中断发生不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待功能,无论的内容都会发生中断可中断属性值。

  • 计时器无论如何,对象根据计划执行可中断属性值。

发生中断时,MATLAB不保存属性或显示状态。例如,由此返回的对象GCA.GCF.命令可能在执行另一个回调时更改。

回调排队,指定为'队列''取消'.的BusyAction属性决定了MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的回调。

  • 中断回调是一个回调,它试图中断运行的回调。

当MATLAB调用回调时,回调试图中断正在运行的回调。的可中断拥有运行回调的对象的属性确定是否允许中断。如果不允许中断,那么BusyAction拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。这些是可能的值BusyAction属性:

  • '队列'—将中断回调放入正在运行的回调执行完成后待处理的队列中。

  • '取消'—不执行中断回呼。

此属性是只读的。

删除状态,返回类型为开/关逻辑值matlab.lang.OnoffSwitchState.

MATLAB设置呈扭曲财产“上”当。。。的时候deletefcn.回调开始执行。的呈扭曲属性仍然设置为“上”直到组件对象不再存在。

检查该值呈扭曲属性来验证对象在查询或修改之前不会被删除。

父母/孩子

展开全部

父容器,指定为数字使用的对象uifigure功能,或其中一个子容器:标签面板buttongroup.,或GridLayout.如果没有指定容器,则MATLAB调用uifigure函数创建一个新的数字作为父容器的对象。

面板子对象,返回为空GraphicsPlaceholder或组件对象的一维数组。他的孩子面板可以是任何组件对象,包括另一个面板

您无法使用中删除或删除子组件孩子们财产。使用此属性可查看子列表或对子列表重新排序。这个数组中的子对象的顺序反映了屏幕上组件的前后堆叠顺序。

要将子对象添加到此列表,请设置父母儿童对象的财产面板对象。

对象句柄的可见性,指定为“上”“回调”,或'离开'

此属性控制对象在其父的子列表中的可见性。当一个对象在其父的子列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数不会返回该对象。这些功能包括得到findobjclf,关闭.即使它们不可见,对象也有效。如果可以访问对象,则可以设置和获取其属性,并将其传递给对象上运行的任何功能。

Hupplvisibility价值 描述
“上” 物体总是可见的。
“回调” 对象在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行中访问对象,但允许回调函数访问它。
'离开' 对象始终是不可见的。此选项对于防止其他函数对UI的意外更改非常有用。设定HandleVisibility'离开'在函数执行期间暂时隐藏对象。

标识符

展开全部

此属性是只读的。

图形对象的类型,返回为“uipanel”

对象标识符,指定为字符向量或字符串标量。您可以指定一个唯一的标签作为对象的标识符的值。当您需要访问代码中其他地方的对象时,可以使用findobj函数搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

如果你在应用程序设计器中工作,在应用程序中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参见在App Designer应用程序中共享数据

另请参阅

功能

介绍了R2016a