Figure 属性

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

此属性仅影响默认菜单，不影响通过 uimenu 命令定义的菜单。

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

Figure 工具栏显示方式，指定为下列值之一：

此属性仅影响默认工具栏。它不影响其他工具栏，例如相机工具栏或绘图编辑工具栏。从图窗视图菜单选择图窗工具栏时，会将此属性设置为 'figure'。

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

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

MATLAB Online™ 不支持设置 DockControls 属性。

背景颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。如果指定 'none'，背景色将在屏幕上显示为黑色，但如果您打印图窗，则会将图窗窗口视为透明而打印背景。

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

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

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

数据类型： double | char

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

模态窗口样式行为

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

模态图窗获得焦点时键入 Ctrl+C 会导致图窗恢复到 'normal' WindowStyle 属性设置。这样用户可以在命令行键入内容。

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

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

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

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

不支持对已停靠的图窗或在 MATLAB Online 中设置 WindowState 属性。

可绘制区域的位置和大小，指定为 [left bottom width height] 形式的向量。此区域不包括图窗边框、标题栏、菜单栏和工具栏。

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

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

图窗停靠时不能指定图窗的 Position 属性。

在 MATLAB Online 中，Position 向量的 bottom 和 left 元素被忽略。

要放置包括边框、标题栏、菜单栏和工具栏在内的整个窗口，请使用 OuterPosition 属性。

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

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

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

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

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

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

外部边界的位置和大小，指定为 [left bottom width height] 形式的向量。此属性定义由图窗的外部边界围起的区域（包括边框、标题栏、菜单栏和工具栏）。

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

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

图窗停靠时不能指定图窗的 OuterPosition 属性。

此属性不会对图窗产生任何影响。

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

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

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

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

MATLAB 按行号访问这些颜色。

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

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

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

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

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

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

此表介绍每个值的作用。

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

用于屏幕显示和打印的渲染器，指定为下列值之一：

MATLAB Online 不支持设置 Renderer 属性。

OpenGL 硬件和软件实现

所有运行 MATLAB 的计算机上都提供 OpenGL，因为 MATLAB 中内置了软件版本的 OpenGL。但是，如果您的图形硬件支持硬件加速版本的 OpenGL，则 MATLAB 会自动使用硬件加速版本来提高性能。

在某些情况下，MATLAB 自动使用软件 OpenGL，即使提供了硬件版本也是如此。例如，如果 MATLAB 检测到图形硬件存在已知的驱动程序问题或您正在 Windows 中使用虚拟机或远程桌面，它将会使用该软件版本。

MATLAB 在找不到可用的 OpenGL 库时会发出警告。

软件 OpenGL 选择

要从硬件切换到软件 OpenGL，请执行以下操作：

可以使用以下软件版本：

确定 OpenGL 库版本

要确定 MATLAB 正在您的系统上使用的 OpenGL 库的版本和供应商，请调用 rendererinfo 函数。例如，此命令将获取当前坐标区的信息并将其存储在名为 info 的结构体中。

info = rendererinfo(gca)

此结构体还在 GraphicsRenderer 字段中提供图形渲染器的名称。例如，如果 MATLAB 使用的是硬件加速 OpenGL，该字段将返回 'OpenGL Hardware'。如果 MATLAB 使用的是软件 OpenGL，该字段将返回 'OpenGL Software'。

XServer 连接中断

使用 Linux 时，如果与 XServer 的连接中断，则 MATLAB 可能会因分段违规而崩溃。如果出现这种情况，请确保系统安装了最新的 XServer。

在 Linux 系统中，还可以尝试升级 OpenGL 驱动程序，或者使用下面的命令通过软件 OpenGL 启动 MATLAB：

 matlab -softwareopengl

渲染器选择，指定为下列项之一：

如果将 Renderer 属性显式设置为 'painters' 或 'opengl'，则 MATLAB 会将 RendererMode 属性设置为 'manual'。

坐标区图形平滑处理，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

平滑处理可减少坐标区图形中的锯齿。如果 GraphicsSmoothing 设为 'on' 并且下列任一条件为 true，则 MATLAB 将对坐标区图形（和坐标区标尺）应用平滑处理技术：

如果坐标区图形主要包含垂直线条或水平线条，请考虑将 GraphicsSmoothing 属性设置为 'on' 并将线条的 AlignVertexCenters 属性设置为 'on'。平滑处理技术会牺牲一些清晰度以获得平滑效果，这一特点在此类图形中可能尤为明显。

MATLAB Online 不支持设置 GraphicsSmoothing 属性。

打印或保存时页面上的图窗大小和位置，指定为 [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 属性设置为相应的页面大小。

保存或打印时的图窗背景颜色，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

指针符号，指定为下表中的值之一，或指定为 '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 对象、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 值以及生成这些值的用户操作。

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

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

只要用户点击图窗中的空白区域，就会执行此回调。

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

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

组件创建函数，指定为下列值之一：

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

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

可在您的 CreateFcn 代码中使用 gcbo 函数获取要创建的组件对象。

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

组件删除函数，指定为下列值之一：

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

DeleteFcn 属性指定要在 MATLAB 删除组件时（例如，当用户关闭窗口时）执行的回调函数。MATLAB 会在销毁组件对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

可在您的 DeleteFcn 代码中使用 gcbo 函数获取要删除的组件对象。

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

当用户按下一个键且图窗或子对象具有焦点时，将执行此回调函数。如果用户在 UIControl 或 Table 组件上按下某个键，回调不会执行，除非 Enable 属性设置为 'off' 或 'inactive'。

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

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

实时编辑器不支持 KeyPressFcn 回调。

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

CurrentCharacter 属性还返回字符信息。

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

当用户按下一个键且图窗或子对象具有焦点时，将执行此回调函数。如果用户在 UIControl 或 Table 组件上释放某个键，回调不会执行，除非 Enable 属性设置为 'off' 或 'inactive'。

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

实时编辑器不支持 KeyReleaseFcn 回调。

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

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

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

用户试图关闭图窗窗口时会执行该回调。例如，您可以显示一个对话框，询问用户确认或取消关闭操作，或者阻止用户关闭含有 UI 的图窗。

基本机制为：

除非关闭请求函数调用 delete 或 close 函数，否则 MATLAB 永远不会关闭图窗。（如果您是用非销毁关闭请求函数创建的窗口，则可以从命令行调用 delete(f)。）

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

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

function my_closereq(src,event)
% Close request function 
% to display a question dialog box 
selection = questdlg('Close This Figure?', ...
    'Close Request Function', ...
    'Yes','No','Yes'); 
switch selection 
    case 'Yes'
        delete(gcf)
    case 'No'
        return 
end
end

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

figure('CloseRequestFcn',@my_closereq)

关闭图窗窗口并显示问题对话框。

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

定义此回调在此容器的大小更改时（例如，当用户调整窗口大小时）自定义 App 布局。

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

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

示例：编辑具有固定高度的字段

使用 SizeChangedFcn 回调来约束 UI 组件的大小。例如，以下代码在窗口顶部创建一个 UI，它具有一个编辑字段。当用户调整窗口大小时，sbar 函数将其高度限制为 20 像素。此函数还将编辑字段的宽度设置为等于图窗的宽度。使用圆点表示法来设置和查询属性。

function myui
f = figure('Visible','off','SizeChangedFcn',@sbar); 
u = uicontrol('Style','edit','Tag','StatusBar');
f.Visible = 'on';

    function sbar(src,event)
       old_units = src.Units;
       src.Units = 'pixels';
       sbar_units = u.Units;
       u.Units = 'pixels';
       fpos = src.Position;
       upos = [1 fpos(4) - 20 fpos(3) 20];
       u.Position = upos;
       u.Units = sbar_units;
       src.Units = old_units;
       u.Visible = 'on';
    end
end

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

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

当用户点击图窗中的任何位置或其子对象之一时，将执行此回调。如果用户点击 UIControl 或 Table 组件，回调不会执行，除非 Enable 属性设置为 'off' 或 'inactive'。

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

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

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

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

示例：简单的绘图 App

以下示例说明如何创建一个使用 WindowButtonMotionFcn 回调的绘图 App。将以下代码复制并粘贴到编辑器中并运行它。然后使用鼠标绘制一组连接的线段：

function drawing_app
figure('WindowButtonDownFcn',@wbdcb)
ah = axes('SortMethod','childorder');
axis ([1 10 1 10])
title('Click and drag')
   function wbdcb(src,event)
     seltype = src.SelectionType;
     if strcmp(seltype,'normal')
        src.Pointer = 'circle';
        cp = ah.CurrentPoint;
        xinit = cp(1,1);
        yinit = cp(1,2);
        hl = line('XData',xinit,'YData',yinit,...
        'Marker','p','color','b');
        src.WindowButtonMotionFcn = @wbmcb;
        src.WindowButtonUpFcn = @wbucb;
     end    
 
        function wbmcb(src,event)
           cp = ah.CurrentPoint;
           xdat = [xinit,cp(1,1)];
           ydat = [yinit,cp(1,2)];
           hl.XData = xdat;
           hl.YData = ydat;
           drawnow
        end
   
        function wbucb(src,event)
           last_seltype = src.SelectionType;
           if strcmp(last_seltype,'alt')
              src.Pointer = 'arrow';
              src.WindowButtonMotionFcn = '';
              src.WindowButtonUpFcn = '';
           else
              return
           end
        end
  end
end

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

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

当用户在图窗中的任何位置或其子对象之一中释放鼠标按键时，将执行此回调。如果用户在 UIControl 或 Table 组件上释放鼠标按键，回调不会执行，除非 Enable 属性设置为 'off' 或 'inactive'。

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

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

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

当用户按下一个键且图窗或子对象具有焦点时，将执行此回调函数。

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

实时编辑器不支持 WindowKeyPressFcn 回调。

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

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

当用户释放键且图窗或子对象具有焦点时，将执行此回调函数。

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

实时编辑器不支持 WindowKeyReleaseFcn 回调。

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

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

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

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

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

实时编辑器不支持 WindowScrollWheelFcn 回调。

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

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

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

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

   function figScroll(src,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;
         x = [0:.1:xd(end)-inc+.1]; % Don't let xd = 0;
         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 组件，第二个参数为回调函数提供事件数据。

大小调整回调函数，指定为下列值之一：

实时编辑器不支持 ResizeFcn 回调。

数据类型： function_handle | cell | char

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

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

每当 MATLAB 调用回调时，回调都会试图中断正在运行的回调（如果存在）。运行中回调所属对象的 Interruptible 属性决定着是否允许中断：

有关演示 Interruptible 和 BusyAction 属性如何影响程序行为的示例，请参阅Interrupt Callback Execution。

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

中断回调的来源的 BusyAction 属性决定 MATLAB 如何处理其执行。BusyAction 属性具有下列值：

无论何时 MATLAB 调用回调，该回调都会试图中断正在执行的回调。运行中回调所属对象的 Interruptible 属性确定是否允许回调。如果 Interruptible 设置为：

有关演示 BusyAction 和 Interruptible 属性如何影响程序行为的示例，请参阅Interrupt Callback Execution。

是否能够成为当前对象，指定为 '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 父级，以根对象的形式返回。

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

不能使用 Children 属性添加或删除子级。使用该属性查看子级列表或对子级重新排序。子级的顺序反映了组件在屏幕上的前后顺序（堆叠顺序）。MATLAB 可能不允许您更改某些对象的顺序。例如，UIControl 和 Legend 对象始终位于 Axes 对象的前面。

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

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

figure 对象的可见性，指定为 'on'、'callback' 或 'off'。

此属性确定 figure 是否在父级（根）的子级列表中。HandleVisibility 可用于防止命令行用户无意中在仅包含用户界面组件（例如对话框）的图窗中绘图，或者意外删除了该图窗。

如果对象不在其父级的子级列表中，则通过搜索对象层次结构或查询属性来查找对象的函数将不能返回该对象。此类函数包括 get、findobj、gca、gcf、gco、newplot、cla、clf 和 close。

使用 'callback' 或 'off' 设置限制 HandleVisibility 属性值时，对象不会显示在其父对象的 Children 属性中，图窗不会显示在根的 CurrentFigure 属性中，对象不会显示在根的 CallbackObject 属性或图窗的 CurrentObject 属性中，而坐标区也不会显示在其父坐标区的 CurrentAxes 属性中。

可以将根的 ShowHiddenHandles 属性设置为 'on' 以使所有对象可见，而不管其 HandleVisibility 设置如何（这不影响 HandleVisibility 属性的值）。

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

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

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

此 属性 为只读。

图窗的编号，以整数或空数组形式返回。您可以使用该值表示图窗。例如，figure(2) 使 Number 属性值为 2 的图窗成为当前图窗。

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

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

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

将此属性设置为 'on' 时，图窗的标题会包含短语 'Figure n'，其中 n 是属性 Number 的值。

NumberTitle 和 IntegerHandle 必须都设置为 'on' 才能显示标题中的编号。

使用整数句柄，指定为 'on' 或 'off'，或者指定为数值或逻辑值 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 使用该属性存储它保存的 UI 布局文件的名称。

示例： figure('FileName','myfile.fig') 将文件名设置为 myfile.fig。

此 属性 为只读。

Figure 对象的类型，以 'figure' 形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象。

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

用户数据，指定为任何数组。指定 UserData 对在 App 内共享数据很有用。有关详细信息，请参阅在回调之间共享数据。