本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

Root 属性

图形环境和状态信息

Root 对象是图形对象树的根。Root 属性包含有关图形环境和图形系统的当前状态的信息。从 R2014b 开始,您可以使用圆点表示法引用特定的对象和属性:

r = groot;
fig = r.Children;

如果您使用的是早期版本,请使用 get 函数查询属性值。

显示信息

全部展开

此属性为只读

显示画面的宽度和高度,以 n×4 矩阵的形式返回,其中 n 是显示画面数。每行对应一个显示画面,并且为 [x y width height] 形式的四元素向量。例如,如果存在两个显示画面,则该矩阵具有以下形式:

[x1 y1 width1 height1
 x2 y2 width2 height2]
每行中的前两个元素指示相对于原点的显示位置。每行中的最后两个元素指示显示画面的大小。原点位于主显示画面的左下角。如果单位为像素,则原点为 (1,1)。对于所有其他单位,原点为 (0,0)Units 属性确定该测量单位。

注意

MATLAB® 在启动时设置此属性的显示信息值。值是静态的。如果您的系统显示设置发生改变,这些值不会更新。要刷新值,需要重新启动 MATLAB。

指针的当前位置,指定为 [x y] 形式的二元素向量。xy 值是从原点测量的指针位置的坐标。原点位于主显示画面的左下角。如果单位为像素,则原点为 (1,1)。对于所有其他单位,原点为 (0,0)Units 属性确定该测量单位。

此属性包含当前指针位置,即使该指针不在 MATLAB 窗口内部也是如此。通过更改此属性的值来移动指针。在 Macintosh 系统上,无法通过设置此属性来更改指针位置。

在回调例程中查询 PointerLocation 属性可在触发该回调时获取不同于指针位置的值。这种差异是由系统资源争用造成的回调执行延迟引起的。

示例: [500 400]

定义每个像素颜色的位数,指定为标量。默认值取决于计算机。当前图形设备上同时显示的颜色的最大数目等于 2 的此属性的值次幂。

此属性为只读

显示分辨率,以标量形式返回(以每英寸像素数为单位)。该值取决于系统。

  • 在 Windows® 系统上,该值是 96 DPI。

  • Macintosh 系统上,该值为 72 DPI。

  • 在 Linux® 系统上,该值由您系统的分辨率确定。

注意

ScreenPixelsPerInch 属性在 R2015b 中变为只读属性。若要更改屏幕上的文本和其他元素的大小,请调整您的操作系统的显示缩放比例。

此属性为只读

主显示画面的大小,以 [left bottom width height] 形式的四元素向量返回。

  • 当以像素为单位时,leftbottom 值都是 1,当使用其他单位时,这些值均为 0

  • widthheight 的值分别为显示的宽度和高度。

注意

在 Windows 系统上,从 R2015b 开始,如果 Units 属性设置为 'pixels',则宽度和高度值可能与操作系统报告的屏幕尺寸不同。MATLAB 报告的值基于一个像素等于 1/96 英寸。在 Macintosh 和 Linux 系统上,值与操作系统报告的尺寸匹配。

使用此属性时有一些重要信息需要考虑:

  • 由于存在 UI(例如 Microsoft® Windows 任务栏),值可能不表示可用的显示画面大小。

  • MATLAB 在启动时设置此属性的显示大小值。值是静态的。如果您的系统显示设置发生改变,显示大小值不会更新。要刷新值,需要重新启动 MATLAB。

等宽字体的字体名称,指定为包含系统支持的字体名称的字符向量或字符串。此属性确定坐标区、文本以及 FontName 属性设置为 'FixedWidth' 的 uicontrol 的字体。默认值取决于系统。'Courier New' 是使用拉丁字符的系统中的默认值。

如果指定了 FixedWidthFontName 属性,则无需在 MATLAB 应用程序中对字体名称进行硬编码。MATLAB 会尝试将 FixedWidthFontName 属性设置为系统的正确值。

如果您是 MATLAB 应用程序开发者并且想要使用等宽字体,请将坐标区、文本和 uicontrol 对象的 FontName 属性设置为 'FixedWidth' 而不是设置此根属性。如果应用程序用户不想使用预选的值,可以设置根属性。

示例: 'Courier New'

MonitorPositionsScreenSizePointerLocation 属性的单位,指定为下表中所示的值之一。

Units说明
'pixels'(默认值)

像素。

从 R2015b 开始,以像素为单位的距离不再依赖 Windows 和 Macintosh 系统上的系统分辨率:

  • 在 Windows 系统上,一个像素是 1/96 英寸。

  • Macintosh 系统上,一个像素是 1/72 英寸。

在 Linux 系统上,一个像素的大小由系统分辨率确定。

'inches'英寸。
'centimeters'厘米。
'points'磅。一磅等于 1/72 英寸。
'normalized' 相对于显示画面进行归一化。显示画面的左下角映射到 (0,0),右上角映射到 (1,1)
'characters'

基于默认系统字体的字符大小。

  • 字符宽度 = 字母 x 的宽度。

  • 字符高度 = 两个文本行的基线之间的距离。

所有单位都是从主显示画面左下角进行测量的。如果单位为像素,则左下角映射到 (1,1)。对所有其他单位,左下角映射到 (0,0)

如果您更改这些单位,则比较好的做法是在完成运算后将其恢复为默认值,以便不影响其他假定 Units 属性设置为默认值的函数。

标识符

全部展开

此属性为只读

正在执行其回调的对象,以图形对象的形式返回。有关详细信息,请参阅 gcbo 命令。

当前图窗,指定为图窗对象。当前图窗通常是最近创建、点击或通过调用 figure 函数设为当前对象的图窗。设置此属性会将图窗设为当前图窗,但不会在显示屏上将其显示于其他图窗前面。但是,如果使用 figure 函数将一个图窗设为当前图窗,会将该图窗排列到显示内容的前面。要成为当前图窗,图窗的 HandleVisibility 属性必须设置为 'on'

如果不存在图窗,此属性返回一个空的 GraphicsPlaceholder 数组。但是,gcf 命令始终返回一个图窗对象。如果没有任何图窗对象,则 gcf 会创建一个。

此属性为只读

图形对象的类型,以 'root' 形式返回。使用 groot 函数时,Root 对象句柄始终可见。

要与根关联的标记,指定为字符向量或字符串。只有一个 Root 对象,始终可以使用 groot 函数访问该对象。

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

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

父级/子级

全部展开

Root 对象没有父级。此属性始终为空 GraphicsPlaceholder

子级,指定为由具有可见句柄的图窗对象组成的数组。图窗的 HandleVisibility 属性确定句柄是否可见。此属性不包含具有隐藏句柄的图窗。

更改子级的顺序,从而更改显示时的图窗排列顺序。

此属性不会产生任何影响。使用 groot 函数时,Root 对象句柄始终可见。

隐藏句柄的显示,指定为下列值之一:

  • 'off' - 不显示隐藏的对象句柄。对象的 HandleVisibility 属性确定句柄是否可见。

  • 'on' - 显示所有对象句柄,而不管 HandleVisibility 属性是什么。

在 R2006a 之前推出