uiimage

创建图像组件

自 R2019a 起

全页折叠

语法

im = uiimage

im = uiimage(parent)

im = uiimage(___,Name,Value)

说明

im = uiimage 在新图窗中创建一个图像组件并返回 Image 对象。MATLAB^® 调用 uifigure 函数来创建新图窗。使用 uiimage 在您的 App 中显示图片、图标或徽标。

示例

im = uiimage(parent) 在指定的父容器中创建一个图像组件。父容器可以是使用 uifigure 函数创建的图窗或其子容器之一。

示例

im = uiimage(___,Name,Value) 使用一个或多个 Name,Value 参数指定 Image 属性。可将此选项与上述语法中的任何输入参数组合一起使用。

示例

全部折叠

显示图片

打开实时脚本

在图窗中创建一个图像组件。将显示默认图像。

fig = uifigure;
im = uiimage(fig);

Figure contains an object of type uiimage.

现在，向图像组件添加一个图片。

im.ImageSource = "peppers.png";

Figure contains an object of type uiimage.

以宽银幕形式显示动画 GIF

打开实时脚本

使用图像的实际大小创建一个显示动画 GIF 的图像组件。

fig = uifigure;
im = uiimage(fig,"ImageSource","questions.gif");
im.ScaleMethod = "none";

Figure contains an object of type uiimage.

现在，缩放图像，使其适应默认组件区域，保持纵横比而不进行裁剪。然后，应用黑色背景以创建宽银幕式外观（图像上方和下方具有黑色条形）。

im.ScaleMethod = "scaledown";
im.BackgroundColor = "black";

Figure contains an object of type uiimage.

将图像配置为点击时打开链接

创建一个图像并指定 URL，当您点击该图像时，该 URL 将在新浏览器标签页中打开。指定在指向图像时出现的工具提示。

fig = uifigure;
im = uiimage(fig);
im.ImageSource = "ngc6543a.jpg";
im.URL = "https://www.mathworks.com/";
im.Tooltip = "Go to www.mathworks.com";

Image UI component with an image of a nebula in a UI figure window and a tooltip that reads "Go to www.mathworks.com"

在 R2022b 之前：使用 ImageClickedFcn 属性而不是 URL 属性，并使用函数句柄创建回调。

im.ImageClickedFcn = @(src,event)web("https://www.mathworks.com/");

输入参数

全部折叠

`parent` — 父容器
`Figure` 对象（默认） | `Tab` 对象 | `Panel` 对象 | `ButtonGroup` 对象 | `GridLayout` 对象

父容器，指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一：Tab、Panel、ButtonGroup 或 GridLayout。如果不指定父容器，MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： im = uiimage('ScaleMethod','none')

注意

此处所列的属性只是一部分。有关完整列表，请参阅 Image 属性。

`ImageSource` — 图像源或文件
' ' （默认） | 文件路径 | `m`×`n`×3 真彩色图像数组

图像源或文件，指定为文件路径或 m×n×3 真彩色图像数组。支持的图像格式包括 JPEG、PNG、GIF、SVG 或 m×n×3 真彩色图像数组。

有关真彩色图像数组的详细信息，请参阅图像类型。

示例： im = uiimage('ImageSource','peppers.png');

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

`ScaleMethod` — 图像缩放方法
`'fit'` （默认） | `'fill'` | `'none'` | `'scaledown'` | `'scaleup'` | `'stretch'`

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

该表使用示例图像演示了每种缩放方法。在渲染后的图像示例中，图像组件的 BackgroundColor 属性已设置为 'magenta'。SVG 图像文件的缩放行为可能会根据文件的定义而有所不同。

值	描述	示例		放大	缩小	保持纵横比	裁剪图像
值	描述	原始图像	渲染后的图像	放大	缩小	保持纵横比	裁剪图像
`'fit'`	在任意方向缩放以在组件区域内显示图像，并保持纵横比而不进行裁剪。			是	是	是	否
`'fill'`	在任意方向缩放以填充组件区域，保持纵横比并在必要时进行裁剪。			是	是	是	是
`'none'`	使用图像的实际大小并保持纵横比。如果组件区域小于图像，图像将被裁剪。			否	否	是	是
`'scaledown'`	缩小并保持纵横比而不裁剪。如果原始图像大于组件区域，则图像缩小，呈现效果与 `ScaleMethod` 设置为 `'fit'` 一样。如果原始图像小于组件区域，则图像不缩小，呈现效果与 `ScaleMethod` 设置为 `'none'` 一样。			否	是	是	否
`'scaleup'`	放大并保持纵横比而不进行裁剪。如果原始图像小于组件区域，则图像放大，呈现效果与 `ScaleMethod` 设置为 `'fit'` 一样。如果原始图像大于组件区域，则图像不放大，呈现效果与 `ScaleMethod` 设置为 `'none'` 一样。			是	否	是	是
`'stretch'`	在任意方向缩放以填充组件区域，不保持纵横比，也不进行裁剪。			是	是	否	否

`URL` — 图像超链接 URL
`''` （默认） | 字符向量 | 字符串标量

图像超链接 URL，指定为字符向量或字符串标量。当用户点击图像时，由 URL 指定的 Web 地址将在新浏览器标签页中打开。如果用户使用 MATLAB Online™ 在浏览器中运行该 App，或将其作为 Web App 运行，新标签页将在当前浏览器中打开。否则，新标签页将在用户系统的默认浏览器中打开。

`ImageClickedFcn` — 点击图像后执行的回调
' ' （默认） | 函数句柄 | 元胞数组 | 字符向量

点击图像后执行的回调，指定为下列值之一：

函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。
包含有效 MATLAB 表达式的字符向量（不推荐）。MATLAB 在基础工作区计算此表达式。

当用户点击 App 中的图像时，将执行此回调。如果使用 URL 属性指定要打开的链接，则回调将在该链接打开后执行。

此回调函数可以访问有关用户与图像的交互的特定信息。MATLAB 将 ImageClickedData 对象中的此信息作为第二个参数传递给回调函数。在 App 设计工具中，该参数名为 event。您可以使用圆点表示法查询对象属性。例如，event.Source 返回用户正在与之交互的 Image 对象以触发回调。ImageClickedData 对象不可用于指定为字符向量的回调函数。

下表列出了 ImageClickedData 对象的属性。

属性	值
`EventName`	`'ImageClicked'`
`Source`	执行回调的组件

有关编写回调的详细信息，请参阅App 设计工具中的回调。

`Position` — 图像组件的位置和大小
`[100 100 100 100]` （默认） | `[left bottom width height]`

图像组件相对于父组件的位置和大小，指定为 [left bottom width height] 形式的四元素向量。此表介绍该向量中的每个元素。

元素	描述
`left`	父容器的内部左边缘与图像组件的外部左边缘之间的距离
`bottom`	父容器的内部下边缘与图像组件的外部下边缘之间的距离
`width`	图像组件的左右外部边缘之间的距离
`height`	图像组件的上下外部边缘之间的距离

Position 值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域，不包括装饰元素（如菜单栏或标题）所占的区域。

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

提示

如需图像分析和处理，请参阅图形函数 image 和 imshow。

版本历史记录

在 R2019a 中推出

全部展开

R2023a: 指定图像替换文本

指定 AltText 属性以提供图像的描述。当 App 用户浏览您的 App 时，屏幕阅读器使用此文本来描述图像。

R2022b: 使用 `URL` 属性创建一个图像超链接

要在用户点击 App 中的图像时打开 Web 地址，请指定图像的 URL 属性。

另请参阅

uiimage

语法

说明

示例

显示图片

以宽银幕形式显示动画 GIF

将图像配置为点击时打开链接

输入参数

parent — 父容器 Figure 对象 （默认） | Tab 对象 | Panel 对象 | ButtonGroup 对象 | GridLayout 对象

名称-值参数

ImageSource — 图像源或文件 ' ' （默认） | 文件路径 | m×n×3 真彩色图像数组

ScaleMethod — 图像缩放方法 'fit' （默认） | 'fill' | 'none' | 'scaledown' | 'scaleup' | 'stretch'

URL — 图像超链接 URL '' （默认） | 字符向量 | 字符串标量

ImageClickedFcn — 点击图像后执行的回调 ' ' （默认） | 函数句柄 | 元胞数组 | 字符向量

Position — 图像组件的位置和大小 [100 100 100 100] （默认） | [left bottom width height]

提示

版本历史记录

R2023a: 指定图像替换文本

R2022b: 使用 URL 属性创建一个图像超链接

另请参阅

函数

属性

工具

WeChat

`parent` — 父容器
`Figure` 对象（默认） | `Tab` 对象 | `Panel` 对象 | `ButtonGroup` 对象 | `GridLayout` 对象

`ImageSource` — 图像源或文件
' ' （默认） | 文件路径 | `m`×`n`×3 真彩色图像数组

`ScaleMethod` — 图像缩放方法
`'fit'` （默认） | `'fill'` | `'none'` | `'scaledown'` | `'scaleup'` | `'stretch'`

`URL` — 图像超链接 URL
`''` （默认） | 字符向量 | 字符串标量

`ImageClickedFcn` — 点击图像后执行的回调
' ' （默认） | 函数句柄 | 元胞数组 | 字符向量

`Position` — 图像组件的位置和大小
`[100 100 100 100]` （默认） | `[left bottom width height]`

R2022b: 使用 `URL` 属性创建一个图像超链接