主要内容

图像属性

控制图像组件的外观和行为

图像是允许您在应用程序中显示图片(如图标或徽标)的UI组件。图像属性控制图像的外观和行为。使用点符号来引用特定的对象和属性。

无花果= uifigure;我=用户界面图像(图);即时通讯。ImageSource =“peppers.png”;

图像

全部展开

图像源或文件,指定为字符向量、字符串标量或M-借-N-by-3真彩色图像数组。如果指定文件名,则可以是MATLAB中的图像文件名®图像文件的路径或完整路径。如果您计划与其他人共享应用程序,请将图像文件放在MATLAB路径上,以便于应用程序打包。

金宝app支持的图像格式包括JPEG、PNG、GIF、SVG或M-借-N-by-3 truecolor图像阵列。有关truecolor图像阵列的更多信息,请参阅图像类型

例子:im=uiimage('ImageSource','peppers.png');

例子:im.ImageSource='C:\TEMP\ngc6543a.jpg';

渲染图像在图像组件区域内的水平对齐,指定为“中心”,“左”“对”. 水平对齐相对于图像组件的内边框。当比例法属性值设置为“伸展”

例如,该表显示了每个对象的渲染图像HorizontalAlignment值,其中比例法属性值设置为“没有”VerticalAlignment属性具有默认值,“中心”. 您可以实现此处未显示的许多其他组合。

水平对齐值 描述 渲染图像
“中心” 图像的左边缘和右边缘分别与图像组件的左内边界和右内边界等距。

“左” 图像的左边缘与图像组件的左内边框对齐。

“对” 图像的右边缘与图像组件的右内边界对齐。

渲染图像在图像组件区域内的垂直对齐,指定为“中心”,“左”“对”。垂直对齐相对于图像组件的内边框。当比例法属性值设置为“伸展”

例如,该表显示了每个对象的渲染图像VerticalAlignment值,其中比例法属性值设置为“没有”HorizontalAlignment属性具有默认值,“中心”. 您可以实现此处未显示的许多其他组合。

垂直对齐值 描述 渲染图像
“中心” 图像的上边缘和下边缘分别与图像组件的内部上边缘和内部下边缘等距。

“顶级” 图像的上边缘与图像组件的内部上边缘对齐。

“底部” 图像的底部边缘与图像组件的内部底部边界对齐。

图像缩放方法,指定为表中列出的值之一。使用此名称-值对参数指定图像在组件区域内的渲染方式。

该表还通过一个示例图像演示了每个缩放方法背景颜色图像组件的属性已设置为“洋红”. 这个scaling behavior of SVG image files may vary based on how the file is defined.

价值 描述 例子 放大 尺度下 保持纵横比 剪辑图像
原始图像 渲染图像
“适合” 在任意方向缩放以显示组件区域内的图像,并保持纵横比而不进行剪裁。

“填充” 在任何方向缩放填充组件区域,保持长宽比和裁剪如果必要。

“没有” 使用图像的实际大小并保持纵横比。如果组件面积小于图像,则剪裁图像。

“scaledown”

缩小和保持长宽比没有剪辑。


如果原始图像大于组件区域,则图像将缩小并渲染,就像比例法被设置为“适合”。如果原始图像小于组件区域,则图像不会缩小并渲染为比例法被设置为“没有”

“scaleup”

通过剪裁放大并保持纵横比。


如果原始图像小于组件区域,则图像将放大并渲染,就像比例法被设置为“适合”。如果原始图像大于组件区域,则图像不会放大,并呈现为比例法被设置为“没有”

“伸展” 在任何方向上缩放以填充组件区域,而不保持纵横比和剪裁。

颜色

全部展开

背景色,指定为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] “#00FF00”

绿色样品

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

样品的颜色是蓝色的

“青色” “c” [0 1 1] “#00FFFF”

青色样品

“洋红” “我是 [1 0 1] “#FF00FF”

品红色样品

“黄色” “y” [1 1 0] “# FFFF00”

黄色样品

“黑色” “k” [0 0 0] '#000000'

黑色样品

“白色” ' w ' [1 1 1] “# FFFFFF”

样品的颜色为白色

“没有” 不适用 不适用 不适用 没有颜色

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

RGB三重态 十六进制色码 外观
[0 0.4470 0.7410] “#0072BD”

RGB三重态样本[0.4470 0.7410],显示为深蓝色

(0.8500 0.3250 0.0980) "D95319"

RGB三联体样品[0.8500 0.3250 0.0980],呈深橙色

(0.9290 0.6940 0.1250) “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈深黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560],呈深紫色

(0.4660 0.6740 0.1880) "77AC30"

RGB三联体样品[0.4660 0.6740 0.1880],呈中绿色

[0.3010 0.7450 0.9330] “#4DBEEE”

RGB三联体样品[0.3010.7450 0.9330],显示为浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],显示为深红色

互动性

全部展开

可见性状态,指定为“开”“关”,或作为数字或逻辑1.(符合事实的)或0().的值“开”相当于符合事实的“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “开”-显示对象。

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

要使应用程序启动更快,请设置看得见的财产“关”适用于启动时不需要显示的所有UI组件。

操作状态,指定为“开”“关”,或作为数字或逻辑1.(符合事实的)或0().的值“开”相当于符合事实的“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • 如果将此属性设置为“开”,应用程序用户可以与组件交互。

  • 如果将此属性设置为“关”,组件显示为灰色,表示应用程序用户无法与其交互,并且不会触发回调。

工具提示,指定为字符向量、字符向量单元格数组、字符串数组或一维分类数组。当用户在运行时将指针悬停在组件上时,使用此属性可显示消息。即使组件被禁用,工具提示也会显示。若要显示多行文本,请指定字符向量单元格数组TOR或字符串数组。数组中的每个元素都成为单独的文本行。如果将此属性指定为分类数组,则MATLAB使用数组中的值,而不是整个类别集。

上下文菜单,指定为上下文菜单使用uicontextmenu作用使用此属性在组件上单击鼠标右键时显示关联菜单。

位置

全部展开

图像组件相对于父组件的位置和大小,指定为表单的四个元素向量[左下宽高].此表描述了向量中的每个元素。

要素 描述
左边 从父容器的左内边缘到图像组件的左外边缘的距离
底部 从父容器的内部底部边缘到图像组件的外部底部边缘的距离
宽度 图像组件的左右外边缘之间的距离
身高 图像组件的上下外边缘之间的距离

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

所有测量值均以像素为单位。

图像组件的内部位置和大小,指定为表单的四元素向量[左下宽高]. 所有测量值均以像素为单位。此属性值与位置所有物

此属性是只读的。

图像组件的外部位置和大小,作为表单的四元素向量返回[左下宽高]. 所有测量值均以像素为单位。此属性值与位置所有物

布局选项,指定为网格布局自动选项对象。此属性为网格布局容器的子组件指定选项。如果该组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空且无效。但是,如果组件是网格布局容器的子级,则可以通过设置一行上的属性网格布局自动选项对象

例如,这段代码将图像组件放置在其父网格的第三行和第二列。

g=uigridlayout([4 3]);im=uiimage(g);图像源=“peppers.png”;im.ScaleMethod=“填充”; im.Layout.Row=3;im.Layout.Column=2;

要使图像跨越多行或多列,请指定一行属性作为两元素向量。例如,此图像跨越列2.通过3.

im.Layout.Column=[23];

回调

全部展开

图像单击回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户单击应用程序中的图像时,将执行此回调。

这个回调函数可以访问用户与图像交互的特定信息图像单击数据对象作为回调函数的第二个参数。在应用程序设计器中,调用该参数事件。您可以使用点表示法查询对象的属性。例如,事件源返回图像用户与之交互以触发回调的对象。这个图像单击数据对象不可用于指定为字符向量的回调函数。

下表列出了图像单击数据对象

财产 价值
EventName “单击图像”
来源 执行回调的组件

有关编写回调的更多信息,请参阅在应用程序设计器中编写回调

对象创建函数,指定为以下值之一:

  • 函数句柄。

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

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

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

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行创建FCN回拨。如果未指定创建FCN属性,然后MATLAB执行默认的创建函数。

设定创建FCN现有组件上的属性无效。

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

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

  • 函数句柄。

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

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

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

此属性指定MATLAB删除对象时要执行的回调函数。MATLAB执行删除FCN在销毁对象属性之前进行回调。如果未指定删除FCN属性,然后MATLAB执行默认的删除函数。

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

回调执行控制

全部展开

回调中断,指定为“开”“关”,或作为数字或逻辑1.(符合事实的)或0().的值“开”相当于符合事实的“关”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

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

  • 这个跑步callback是当前正在执行的回调。

  • 这个打断callback是试图中断正在运行的回调的回调。

MATLAB在执行处理回调队列的命令时确定回调中断行为drawnow,图形,uifigure,getframe,等待暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后执行中断回调。

如果正在运行的回调确实包含这些命令之一,则可中断拥有运行回调的对象的属性确定是否发生中断:

  • 如果可中断“关”,则不发生中断。相反,巴士行动拥有中断回调的对象的属性确定是放弃中断回调还是将其添加到回调队列。

  • 如果可中断“开”,则中断发生。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB将继续执行正在运行的回调。

笔记

回调中断和执行在以下情况下表现不同:

  • 如果中断回调是删除FCN,关闭请求FCNSizeChangedFcn回调,则中断发生不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待函数,则无论可中断属性值。

  • 如果中断回调由计时器对象,则回调将根据计划执行,而与可中断属性值。

笔记

当发生中断时,MATLAB不会保存属性或显示的状态gcagcf命令可能在执行另一个回调时更改。

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

  • 这个跑步callback是当前正在执行的回调。

  • 这个打断callback是试图中断正在运行的回调的回调。

这个巴士行动属性仅在满足以下两个条件时确定回调队列行为:

在这种情况下巴士行动拥有中断回调的对象的属性确定MATLAB如何处理中断回调巴士行动财产:

  • “队列”-在正在运行的回调完成执行后,将中断回调放入要处理的队列中。

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

此属性是只读的。

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

MATLAB设置被删除财产“开”删除FCN回调开始执行被删除属性仍然设置为“开”直到组件对象不再存在。

检查被删除属性,以验证在查询或修改对象之前不会删除该对象。

父母/子女

全部展开

父容器,指定为图形使用uifigure函数或其子容器之一:标签,面板,按钮组GridLayout.如果没有指定容器,则MATLAB调用uifigure函数创建一个新的图形对象,该对象用作父容器。

对象句柄的可见性,指定为“开”,“回调”“关”

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

可处理性值 描述
“开” 对象始终可见。
“回调” 对象在回调或由回调调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行中访问对象,但允许回调函数访问它。
“关” 对象始终不可见。此选项有助于防止其他函数对UI进行意外更改。设置可操作性“关”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

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

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

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

如果您在应用程序设计器中工作,请在应用程序中创建公共或私有属性以共享数据,而不是使用用户数据属性。有关详细信息,请参阅在应用程序设计器应用程序中共享数据

在R2019a中引入