Figure

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

对于自定义颜色，请指定 RGB 三元组或十六进制颜色代码。

此外，还可以按名称指定一些常见的颜色。下表列出了一些命名颜色选项、其等效 RGB 三元组及十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

窗口样式，指定为以下值之一：

指定停靠图窗的位置会自动取消停靠该图窗并将 WindowStyle 属性设置为 'normal'。

模态窗口样式行为

WindowStyle 设为 'modal' 时，图窗窗口将会捕获所有 MATLAB 窗口（只要可见）上的全部键盘和鼠标操作。属于应用程序而非 MATLAB 的窗口不受影响。

当模态图窗具有焦点时按下 Ctrl+C 会将该图窗的 WindowStyle 属性设置为 'normal'。此操作允许用户在命令行中键入内容。

WindowStyle 属性设置为 'modal' 并且 Visible 属性设置为 'off' 的图窗在 MATLAB 使它们变得可见之前不会以模态方式运行。因此，您可以隐藏模态窗口供以后重用，而不用销毁它。

模态图窗不显示菜单子级、内置菜单或工具栏。但是，在模态图窗中创建菜单或在具有菜单子级的图窗上将 WindowStyle 属性设置更改为 'modal' 并不是错误。Menu 对象会存在，而且图窗会保留它们。如果您将图窗的 WindowStyle 属性重置为 'normal'，则会显示菜单。

窗口状态，指定为下列值之一：

在停靠图窗上设置此属性会取消停靠该图窗并将 WindowState 属性设置为 'normal'。

点击操作系统提供的最小化、最大化或还原按钮将对 WindowState 属性进行相应的设置。按下 Ctrl+F11（Windows^® 和 Linux^®）或 Ctrl+Command+F (macOS) 可切换 'fullscreen' 状态。

在 MATLAB Online™ 中设置 WindowState 属性不受支持。

图窗菜单栏显示方式，指定为 'none' 或 'figure'。MenuBar 属性用于在图窗窗口顶部显示或隐藏默认菜单。指定 'figure' 可显示菜单栏。指定 'none' 将其隐藏。

对于使用 figure 函数创建的图窗，将 MenuBar 属性设置为 'figure' 会取消停靠该图窗并从窗口中删除工具条。

此属性仅影响默认菜单，不影响使用 uimenu 函数创建的菜单。

WindowStyle 属性设置为 'modal' 的图窗中，不显示菜单栏。如果一个含有子菜单项的图窗更改为 'modal'，则子菜单项仍然存在于图窗的 Children 属性中。但是，在 WindowStyle 设置为 'modal' 时，这些菜单不会显示出来。

图窗工具栏显示方式，指定为以下值之一：

对于使用 figure 函数创建的图窗，将 ToolBar 属性设置为 'figure' 会取消停靠该图窗并从窗口中删除工具条。

工具栏不在 WindowStyle 属性设置为 'modal' 的图窗中显示。如果一个含有工具栏的图窗变为 'modal'，则工具栏子菜单项仍将存在于图窗的 Children 属性中。但是，在 WindowStyle 设置为 'modal' 时，工具栏不会显示出来。

交互式图窗停靠，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此列表描述每个值的行为。

图形主题，指定为 "light"、"dark" 或 GraphicsTheme 对象，并存储为 GraphicsTheme 对象。

作为设置 Theme 属性的替代方法，您还可以调用 theme 函数。

要确定当前主题是浅色主题还是深色主题，请查询 Theme 属性以获取 GraphicsTheme 对象。然后查询 GraphicsTheme 对象的 BaseColorStyle 属性。后一个查询返回值 'light' 或 'dark'。

f = figure;
gtobject = f.Theme;
figtheme = gtobject.BaseColorStyle

图形主题选择方式，指定为以下值之一：

当您显式设置主题时（例如，通过设置 Theme 属性或调用 theme 函数），ThemeMode 属性会自动更改为 "manual"。

图窗的位置和大小，不包括边框、图窗工具和标题栏，指定为 [left bottom width height] 形式的四元素向量。

此表介绍该向量中的每个元素。

所有测量值都采用 Units 属性指定的单位。

对于停靠在图窗容器中的图窗，设置 Position 属性会取消停靠该图窗并将 WindowStyle 属性设为 'normal'。

要定位包含边框、图窗工具和标题栏的完整窗口，请使用 OuterPosition 属性。

测量单位，指定为下表中的值之一。

MATLAB 从父对象的左下角测量所有单位。

此属性会影响 Position 属性。如果更改 Units 属性，请考虑在完成计算后将其值还原为默认值，以免影响采用默认值的其他函数。

指定 Units 和 Position 属性的顺序具有以下影响：

图窗的位置和大小，不包括边框、图窗工具和标题栏，指定为 [left bottom width height] 形式的四元素向量。所有测量值都采用 Units 属性指定的单位。

此属性值等同于 Position 属性值。

图窗的位置和大小，包括边框、图窗工具和标题栏，指定为 [left bottom width height] 形式的四元素向量。

此表介绍该向量中的每个元素。

所有测量值都采用 Units 属性指定的单位。

对于停靠在图窗容器中的图窗，设置 OuterPosition 属性会取消停靠该图窗并将 WindowStyle 属性设为 'normal'。

可调整大小的图窗，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

当此属性设置为 'on' 时，则可调整图窗大小。否则将无法调整其大小。

对于停靠在图窗容器中的图窗，设置 Resize 属性会取消停靠该图窗并将 WindowStyle 属性设为 'normal'。

自动调整子组件的大小，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

AutoResizeChildren 属性影响容器的直接子组件，而不影响嵌套容器内的子组件。

当 AutoResizeChildren 为 'on' 时，某些子组件不会自动调整大小。例如，仅包含非调整大小组件的标签、按钮和容器不会调整大小。

要自定义调整大小行为，请向容器添加网格布局管理器，或将 AutoResizeChildren 属性设置为 'off' 并为容器创建一个 SizeChangedFcn 回调。有关详细信息，请参阅在 App 设计工具中管理可调整大小的 App。

要禁用 App 的大小调整，请将图窗的 Resize 属性设置为 'off'。

建议仅在以像素为单位进行布局的 App 中将 AutoResizeChildren 指定为 'on'。在不以像素为单位进行布局的 App 中启用自动调整大小可能导致意外行为。

图窗坐标区内容的颜色图，指定为由 RGB（红色、绿色、蓝色）三元组组成的 m×3 数组，这些三元组定义 m 种单独的颜色。

示例: figure('Colormap',[1 0 1; 0 0 1; 1 1 0]) 将颜色图设置为三种颜色：品红色、蓝色和黄色。

MATLAB 按行号访问这些颜色。

颜色图会影响由 surface、image 和 patch 函数创建的对象的渲染，但通常不会影响其他图形对象。

如果您设置了图窗的 Colormap 属性，图窗中的坐标区和图将使用相同的颜色图。

坐标区内容的透明度映射，指定为从 0 到 1 线性递增的有限 alpha 值数组。数组大小可以是 m×1 或 1×m。MATLAB 按 alpha 值在数组中的索引访问它们。Alphamap 可以为任意长度。

Alphamap 会影响由 surface、image 和 patch 函数创建的对象的渲染，但不会影响其他图形对象。

如果您设置了图窗的 Alphamap 属性，图窗中的坐标区和图将使用相同的 alpha 映射。

有关如何添加下一绘图的指令，指定为 'add'、'new'、'replace' 或 'replacechildren'。

仅当图窗可以成为当前图窗时（即，如果图窗的 HandleVisibility 属性是 "on"），此属性才起作用。

下表介绍每个值的作用。

考虑使用 newplot 函数处理 NextPlot 属性。有关详细信息，请参阅坐标区的 NextPlot 属性和为绘图准备图窗和坐标区。

打印或保存时页面上的图窗大小和位置，指定为 [left bottom width height] 形式的四元素向量。

PaperUnits 属性确定 PaperPosition 值的测量单位。考虑将 PaperUnits 属性设置为 'normalized'。该设置使 MATLAB 能够自动改变图窗大小，从而无论页面尺寸如何均以同样的相对量占据打印页面。

示例: figure('PaperPosition',[.25 .25 8 6]) 设置图窗的大小和位置以打印到 [.25 .25 8 6]。

指示在打印或保存时使用显示的图窗大小的指令，指定为 'auto' 或 'manual'。

要生成与显示的图窗具有相同大小和分辨率 (DPI) 的输出，请将图窗的 PaperPositionMode 属性设置为 'auto'，并使用 print 函数与 -r0 选项保存图窗。-r0 选项可确保输出分辨率与显示分辨率相同。如果这两种分辨率不同，则以测量单位（英寸、厘米、磅）计，生成的输出大小与显示的图窗大小一致，但在像素上不一致。例如，如果显示分辨率为 100 DPI，则一个 4×5 英寸图窗有 400×500 个像素。如果输出分辨率为 200 DPI，则以英寸单位计，打印或保存的图窗具有相同大小，但具有 800×1000 个像素。

打印图窗或将其保存为分页格式（PDF 和 PostScript^® 格式）时的自定义页面大小，指定为 [width height] 形式的二元素向量。在美国，默认值为 [8.5 11]。在欧洲和亚洲，默认值为 [21 29.7]。

PaperUnits 属性确定 PaperSize 属性的测量单位。如果 PaperUnits 属性设置为 'normalized'，则您无法设置 PaperSize 属性。试图这样做会抛出错误。

指定 PaperSize 属性会将 PaperType 属性设置为相应的类型（如果存在），否则设置为 'custom'。

用于 PaperSize 和 PaperPosition 的单位，指定为下列值之一：

打印图窗或将其保存为分页格式（PDF 和 PostScript 格式）时的页面方向，指定为下列值之一：

有关详细信息，请参阅 orient 函数。

打印图窗或将其保存为分页格式（PDF 和 PostScript 格式）时的标准页面大小，指定为下表中的值之一。指定 PaperType 属性会将 PaperSize 属性设置为相应的页面大小。

指针符号，指定为下表中的值之一，或指定为 'custom'。符号的外观与操作系统相关。

自定义指针符号

要创建自定义指针符号，请以编程方式将 Pointer 属性设置为 'custom' 并使用 PointerShapeCData 属性定义符号。有关详细信息，请参阅 PointerShapeCData 属性。

限制

Pointer 属性指定的指针符号不会显示在使用 uihtml 函数创建的 HTML UI 组件上。

自定义指针符号，指定为 16×16 矩阵（对于 16×16 像素指针）或指定为 32×32 矩阵（对于 32×32 像素指针）。当您将 Pointer 属性设置为 'custom' 时，图窗将使用此指针符号。

矩阵中的每个元素分别为指针中的 1 个像素定义亮度级别，其中元素可以具有以下值之一：

矩阵的元素 (1,1) 与指针左上角的像素对应。

指针的活动像素，指定为二元素向量。该向量包含 PointerShapeCData 矩阵中特定元素的行和列索引，该元素与所需的活动像素对应。默认值 [1 1] 对应于指针左上角的像素。

如果您指定的值位于 PointerShapeCData 矩阵范围外，则指针将改用默认活动像素 [1 1]。

仅当 Pointer 属性设置为 'custom' 时，此属性才适用。

可见性状态，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

要使您的 App 更快地启动，请将不需要在启动时出现的所有组件的 Visible 属性设置为 'off'。

更改不可见的容器的大小将在该容器变得可见时触发 SizeChangedFcn 回调。

更改容器的 Visible 属性不会改变其子组件的 Visible 属性值。即使隐藏容器会导致子组件隐藏也是如此。

当前图窗中的目标坐标区，指定为 Axes、UIAxes 或 PolarAxes 对象，或图形对象，如 HeatmapChart。

在存在坐标区子级的所有图窗中，始终存在当前坐标区。当前坐标区不必是最顶层的坐标区，并且将坐标区设置为当前坐标区不会将其重新叠放在所有其他坐标区上。如果图窗不包含坐标区，则 get(gcf,'CurrentAxes') 命令返回一个空数组。

查询 CurrentAxes 属性来获取当前坐标区对象，而不强制创建不存在的坐标区。

当前对象，以图窗的子对象形式返回。MATLAB 将 CurrentObject 属性设置为在图窗中点击的最后一个对象。此对象是视图中位于最前面的对象。

子对象的 HitTest 属性控制该对象是否可以成为 CurrentObject。

点击其 HandleVisibility 属性为 'off' 的对象会将 CurrentObject 属性设置为空 GraphicsPlaceholder 数组。为避免在用户点击隐藏对象时返回空数组，请将隐藏对象的 HitTest 属性设置为 'off'。

使用 gco 命令作为获取此属性值的替代方法。

当前点，以二元素向量形式返回。该向量包含鼠标指针的 (x, y) 坐标，从图窗左下角开始测量。值采用 Units 属性指定的单位。如果图窗是可滚动的，则坐标从可滚动区域的左下角开始测量。可滚动区域是由滚动条限定的区域。

执行以下任一操作时坐标都会更新：

如果图窗具有响应鼠标交互的回调，并且您触发该回调的速度比系统执行代码的速度快，则坐标可能不会反映指针的实际位置，而是反映回调开始执行时的位置。

如果您使用 CurrentPoint 属性绘制各点，则坐标值可能包含舍入误差。

当前字符，以按下的最后一个键的字符形式返回。当图窗具有焦点且用户按下某个键时，此属性会更新。

鼠标选择类型，返回为 'normal'、'extend'、'alt' 或 'open'。此属性提供有关图窗中发生的最后一次按下鼠标按键的信息。

下表列出了可能的 SelectionType 值以及生成这些值的用户操作。

滚动能力，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

将此属性设置为 'on' 可以在容器内滚动。但是，还有其他要求：

某些类型的图和坐标区不支持可滚动容器。但是，您可以将图或坐标区放在不可滚动的面板中，然后将该面板放在可滚动的容器中。有关详细信息，请参阅在 App 设计工具中显示图形。

上下文菜单，指定为使用 uicontextmenu 函数创建的 ContextMenu 对象。使用此属性可在您右键点击图窗时显示上下文菜单。

主题更改后执行的回调，指定为下列值之一：

当图窗的主题更改时，将会执行此回调。例如，在所有这些情况下，此回调都会执行：

此回调函数可以访问有关图窗主题更改的特定信息。MATLAB 在 ThemeChangedData 对象中将此信息作为第二个参量传递给回调函数，通常指定为 event。您可以使用圆点表示法查询对象属性。例如，event.Theme 以 GraphicsTheme 对象形式返回新图窗主题。ThemeChangedData 对象不可用于指定为字符向量的回调函数。

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

themeobj = event.Theme;
themeval = themeobj.BaseColorStyle;

themeobj = event.PreviousTheme;
themeval = themeobj.BaseColorStyle;

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

按钮按下回调，指定为下列值之一：

当用户点击图窗的空白区域时，将会执行此回调。

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

使用 SelectionType 属性确定用户是否按下了修改键。

对象创建函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅App 设计工具中的回调。

此属性指定要在 MATLAB 创建对象时执行的回调函数。MATLAB 将在执行 CreateFcn 回调之前初始化所有属性值。如果不指定 CreateFcn 属性，则 MATLAB 执行默认的创建函数。

对现有组件设置 CreateFcn 属性没有任何作用。

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

对象删除函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅App 设计工具中的回调。

此属性指定在 MATLAB 删除对象时要执行的回调函数。MATLAB 在销毁对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

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

按键回调，指定为下列值之一：

当用户按下一个键且图窗具有焦点时，将会执行此回调函数。在接受键盘焦点的 UI 组件（例如编辑字段）上按下一个键时不会执行回调，除非该组件被禁用。您可以通过将 Enable 或 Editable 属性设置为 'off' 来禁用组件。此外，通过将 Enable 属性设置为 'inactive'，可以在不灰显的情况下禁用 Table 或 UIControl 组件。

如果用户几乎在同一时间按下多个键，MATLAB 将检测所有键。

KeyPressFcn 回调可以访问有关用户与键盘交互的特定信息。MATLAB 将 KeyData 对象中的此信息作为第二个参量传递给回调函数。下表列出了 KeyData 对象的属性。

有关指定回调属性值和使用回调参量的详细信息，请参阅Specify a Callback Function。

CurrentCharacter 属性还返回字符信息。

释放键回调，指定为下列值之一：

当用户释放键且图窗或子对象具有焦点时，将会执行此回调函数。在接受键盘焦点的组件（例如编辑字段）上释放一个键时不会执行回调，除非该组件被禁用。您可以通过将 Enable 或 Editable 属性设置为 'off' 来禁用组件。此外，通过将 Enable 属性设置为 'inactive'，可以在不灰显的情况下禁用 Table 或 UIControl 组件。

此回调函数可以访问有关用户与键盘的交互的特定信息。MATLAB 将 KeyData 对象中的此信息作为第二个参量传递给回调函数。下表列出了 KeyData 对象的属性。

有关指定回调属性值和使用回调参量的详细信息，请参阅Specify a Callback Function。

关闭请求回调，指定为下列值之一：

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Specify a Callback Function。

MATLAB 在 App 用户尝试关闭 App 时执行此回调。例如，您可以通过编码让回调例程显示一个对话框，要求 App 用户确认或取消关闭操作。

CloseRequestFcn 回调的默认值 'closereq' 会无条件地删除图窗，从而销毁窗口。

在 CloseRequestFcn 回调中考虑调用 delete 函数以关闭 Figure：

如果 CloseRequestFcn 回调不包含 delete 命令，则 MATLAB 永远不会关闭窗口。您始终可以调用 delete 函数以强制关闭窗口。

示例：用来显示对话框的代码 CloseRequestFcn

此示例说明如何为关闭请求函数编码以显示要求用户确认关闭操作的确认对话框。将该代码保存到您系统上的可写入文件夹中。

function myCloseReq(src,event)
selection = uiconfirm(src,'Close this figure?',...
    'Confirm Close'); 
switch selection 
    case 'OK'
        delete(src)
    case 'Cancel'
        return 
end
end

现在，创建一个图窗，并为 CloseRequestFcn 指定 myCloseReq。请注意，函数句柄不会显式引用任何输入参量，但函数声明中包含两个输入参量。MATLAB 在回调执行时自动传递这些参量。第一个参量是触发回调的 UI 组件，第二个参量为回调函数提供事件数据。

uifigure('CloseRequestFcn',@myCloseReq);

关闭图窗窗口，将出现确认对话框。

大小更改回调，指定为下列值之一：

定义此回调以在图窗大小更改时（例如，当您调整窗口大小时）自定义图窗内容的布局。在回调中，编写代码来调整子组件的 Position 属性。

SizeChangedFcn 回调在下列情况下执行：

定义 SizeChangedFcn 回调时要考虑的其他重要事项：

指定调整大小行为的替代方法是创建 GridLayout 对象或使用 App 设计工具中的自动调整布局选项。这些选项比 SizeChangedFcn 回调更容易使用。然而，与这些选项相比，SizeChangedFcn 回调有一些优势。例如，您可以使用 SizeChangedFcn 回调来实现以下目的：

窗口内按键按下回调，指定为下列值之一：

当用户点击以下任一位置时，将会执行此回调：

例如，点击 Axes 对象将触发 WindowButtonDownFcn 回调。

如果用户点击 Table 组件，回调不会执行，除非表的 Enable 属性设置为 'off' 或 'inactive'。

请参阅特定图形对象的属性的列表，以确定它是否支持 ButtonDownFcn 属性。有关图形对象的属性，请参阅图形对象属性。

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

窗口内按键移动回调，指定为下列值之一：

通常，当用户在图窗内移动指针时，将会执行此回调函数。但是，如果用户点击并按住鼠标按键并且将指针移到图窗之外，则在指针位于图窗之外时将执行 WindowButtonMotionFcn 回调。

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

窗口内按键弹起回调，指定为下列值之一：

当用户在以下任一位置处释放鼠标按键时，将会执行此回调：

例如，在 axes 对象上释放鼠标按键会触发 WindowButtonUpFcn 回调。

如果用户在 Table 组件上释放鼠标按键，回调不会执行，除非表的 Enable 属性设置为 'off' 或 'inactive'。

请参阅特定图形对象的属性的列表，以确定它是否支持 ButtonDownFcn 属性。有关图形对象的属性，请参阅图形对象属性。

按键弹起操作与图窗中的按键按下操作相关联。当按键按下操作发生时，鼠标指针必须位于图窗内部，但在按键弹起操作发生时，它可以在图窗外部。

有关将回调属性值指定为函数句柄、元胞数组或字符向量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

窗口按键回调，指定为下列值之一：

当用户在图窗或子组件具有焦点的情况下按下一个键时，将会执行此回调函数。如果用户几乎在同一时间按下多个键，MATLAB 将检测所有键。

此回调函数可以访问有关用户与键盘的交互的特定信息。MATLAB 将 KeyData 对象中的此信息作为第二个参量传递给回调函数。下表列出了 KeyData 对象的属性。

有关指定回调属性值和使用回调参量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

CurrentCharacter 属性还返回字符信息。

窗口释放键回调，指定为下列值之一：

当用户在图窗或子组件具有焦点的情况下释放一个键时，将会执行此回调函数。

此回调函数可以访问有关用户与键盘的交互的特定信息。MATLAB 将 KeyData 对象中的此信息作为第二个参量传递给回调函数。下表列出了 KeyData 对象的属性。

有关指定回调属性值和使用回调参量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

窗口滚轮回调，指定为下列值之一：

当用户在图窗或其任一子组件具有焦点的情况下移动滚轮时，将会执行此回调。但是，其他对象可以捕获滚轮移动和干扰此回调的执行。

此回调对 CurrentObject 和 SelectionType 属性没有影响。

当用户旋转滚轮时，此回调可以访问特定信息。MATLAB 将 ScrollWheelData 对象中的此信息作为第二个参量传递给回调函数。下表列出了 ScrollWheelData 对象的属性。

有关指定回调属性值和使用回调参量的详细信息，请参阅App 设计工具中的回调或Create Callbacks for Apps Created Programmatically。

示例：用于更改 x 坐标轴范围的 App

以下示例说明如何创建一个用于显示绘图的 App。用户转动鼠标滚轮即可更改 x 轴的范围。将以下代码复制并粘贴到编辑器中并运行它。

function scroll_wheel
% Shows how to use WindowScrollWheelFcn property
%
   f = uifigure('WindowScrollWheelFcn',@figScroll,'Name','Scroll Wheel Demo');
   x = 0:.1:40;
   y = 4.*cos(x)./(x+2);
   a = axes(f); 
   h = plot(a,x,y);
   title(a,'Rotate the scroll wheel')

   function figScroll(~,event)
      if event.VerticalScrollCount > 0 
         xd = h.XData;
         inc = xd(end)/20;
         x = [0:.1:xd(end)+inc];
         re_eval(x)
      elseif event.VerticalScrollCount < 0 
         xd = h.XData;
         inc = xd(end)/20;
         % Don't let xd = 0
         x = [0:.1:xd(end)-inc+.1]; 
         re_eval(x)
      end
   end

   function re_eval(x)
      y = 4.*cos(x)./(x+2);
      h.YData = y;
      h.XData = x;
      a.XLim = [0 x(end)];
      drawnow
   end
end

请注意，figScroll 的函数句柄不会显式引用任何输入参量，但函数声明中包含两个输入参量。MATLAB 在回调执行时自动传递这些参量。第一个参量是触发回调的 UI 组件，第二个参量为回调函数提供事件数据。

回调中断，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑：

每次执行处理回调队列的命令时，MATLAB 都会确定回调中断行为。这些命令包括 drawnow、figure、uifigure、getframe、waitfor 和 pause。

如果运行中回调不包含上述命令之一，则不会发生中断。MATLAB 首先完成执行运行中回调，然后执行中断回调。

如果运行中回调确实包含上述命令之一，则由运行中回调所属对象的 Interruptible 属性来确定是否发生中断：

回调排队，指定为 'queue' 或 'cancel'。BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑：

BusyAction 属性仅在同时满足以下两个条件时才确定回调排队行为：

在这些情况下，由中断回调所属对象的 BusyAction 属性确定 MATLAB 如何处理中断回调。以下是 BusyAction 属性的可能值：

是否能够成为当前对象，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

删除状态，以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

当 DeleteFcn 回调开始执行时，MATLAB 会将 BeingDeleted 属性设置为 'on'。BeingDeleted 属性将一直保持 'on' 设置状态，直到组件对象不再存在为止。

在查询或修改对象之前，请先检查其 BeingDeleted 属性的值，以确认它不是待删除项。

父对象，以根对象形式返回。

Figure 对象的子级，以空 GraphicsPlaceholder 或一维对象数组的形式返回。

不能使用 Children 属性添加或删除子对象。使用该属性查看子级列表或对子级重新排序。子级在该数组中的顺序反映了对象在屏幕上的前后顺序（堆叠顺序）。

要向此列表中添加子级，请将子对象的 Parent 属性设置为 Figure 对象。

其 HandleVisibility 属性设置为 'off' 的对象不会列在 Children 属性中。

图窗对象的可见性，指定为 'off'、'callback' 或 'on'。此属性提供有关 Figure 对象在其父级的子级列表中的可见性的信息。

下表说明设置每个值的作用。

即使对象的 HandleVisibility 属性设置为 'off'，这些对象仍然有效。如果可以访问某个对象，则可以设置和获取其属性，并将其传递给针对对象进行操作的任意函数。

图窗的名称，指定为字符向量或字符串标量。

在使用 figure 函数创建的图窗中，默认名称是 'Figure n'，其中 n 是整数。如果您指定 Name 属性，图窗的标题将变为 'Figure n: name'。如果您希望只显示 Name 值，请将 IntegerHandle 或 NumberTitle 设置为 'off'。

在以编程方式使用 uifigure 函数创建的图窗中，默认名称是 ''。

在 App 设计工具中，默认名称是 'MATLAB App'。

示例: figure("Name","Results") 将图窗的名称设置为 "Results"。

图标源或文件，指定为字符向量、字符串标量或 m×n×3 真彩色图像数组。如果指定文件名，它可以是 MATLAB 路径中的图像文件名或图像文件的完整路径。如果您计划与他人共享某个 App，请将图像文件放在 MATLAB 路径中以便于打包 App。

支持的图像格式包括 JPEG、PNG、GIF 和 m×n×3 真彩色图像数组。有关真彩色图像数组的详细信息，请参阅在 MATLAB 中使用图像类型。动画 GIF 文件只显示第一帧。

如果没有足够的空间显示完整大小的图标，MATLAB 会缩小图像以适应空间。

示例: "icon.png" 指定 MATLAB 路径中的图标文件。

示例: "C:\Documents\icon.png" 指定图像文件的完整路径。

示例: fig = uifigure("Icon","peppers.png") 使用指定的图标图像文件创建一个 UI 图窗。

图窗的编号，以整数或空数组形式返回。

如果 IntegerHandle 属性设置为 'off'，则 Number 属性为空。

如果 IntegerHandle 为 'on'，则 Number 属性是整数。删除该图窗时，MATLAB 会对下一个图窗重用该编号。

带编号的标题，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

当 NumberTitle 和 IntegerHandle 属性都设置为 'on' 时，图窗的标题包括短语 'Figure n'，其中 n 是数字。

使用整数句柄，指定为 'off' 或 'on'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

如果将 IntegerHandle 属性设置为 'on'，则 MATLAB 会查找现有图窗不使用的最小整数值并将 Number 属性设置为该值。如果删除某图窗，MATLAB 可以将原图窗的编号用于新图窗。

如果将 IntegerHandle 属性设置为 'off'，则 MATLAB 不会为图窗分配整数值，而是会将 Number 属性设为空数组。

要显示标题栏中的数字，IntegerHandle 和 NumberTitle 都必须设置为 'on'。

用于保存图窗的文件名，指定为字符向量或字符串标量。使用 GUIDE 创建的 App 使用此属性来存储与该 App 关联的 UI 布局文件的名称。

图形对象的类型，以 'figure' 形式返回。

对象标识符，指定为字符向量或字符串标量。您可以指定唯一的 Tag 值作为对象的标识符。如果需要访问您代码中其他位置的对象，可以使用 findobj 函数基于 Tag 值搜索对象。

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

如果您在 App 设计工具中工作，请在该 App 中创建公共或私有属性以共享数据，而不是使用 UserData 属性。有关详细信息，请参阅在用 App 设计工具创建的 App 内共享数据。