Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

uiimage

创建图像组件

说明

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 的图像组件。

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/");

输入参数

全部折叠

父容器,指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一:TabPanelButtonGroupGridLayout。如果不指定父容器,MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值参数

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

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

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

注意

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

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

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

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

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

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

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

描述示例放大缩小保持纵横比裁剪图像
原始图像渲染后的图像
'fit'在任意方向缩放以在组件区域内显示图像,并保持纵横比而不进行裁剪。

Rectangular image of an icon

Icon in an image component. The icon is centered vertically and scaled to horizontally fill the component. The space above and below the icon is magenta.

'fill'在任意方向缩放以填充组件区域,保持纵横比并在必要时进行裁剪。

Rectangular image of an icon

Icon in an image component. The icon fills the component area, and is clipped horizontally.

'none'使用图像的实际大小并保持纵横比。如果组件区域小于图像,图像将被裁剪。

Rectangular image of an icon

Icon in an image component. The icon is the same size as the original image. The icon is centered vertically and is clipped horizontally.

'scaledown'

缩小并保持纵横比而不裁剪。


如果原始图像大于组件区域,则图像缩小,呈现效果与 ScaleMethod 设置为 'fit' 一样。如果原始图像小于组件区域,则图像不缩小,呈现效果与 ScaleMethod 设置为 'none' 一样。

Rectangular image of an icon

Icon in an image component. The icon is centered vertically and scaled to horizontally fill the component. The space above and below the icon is magenta.

'scaleup'

放大并保持纵横比而不进行裁剪。


如果原始图像小于组件区域,则图像放大,呈现效果与 ScaleMethod 设置为 'fit' 一样。如果原始图像大于组件区域,则图像不放大,呈现效果与 ScaleMethod 设置为 'none' 一样。

Rectangular image of an icon

Icon in an image component. The icon is the same size as the original image. The icon is centered vertically and is clipped horizontally.

'stretch'在任意方向缩放以填充组件区域,不保持纵横比,也不进行裁剪。

Rectangular image of an icon

Icon in an image component. The full icon is displayed and fills the image component. The icon is compressed horizontally.

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

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

  • 函数句柄。

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

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

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

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

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

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

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

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

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

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

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

提示

  • 如需图像分析和处理,请参阅图形函数 imageimshow

版本历史记录

在 R2019a 中推出

全部展开

另请参阅

函数

属性

工具