Main Content

Root 属性

图形环境和状态信息

全页展开

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

r = groot;
fig = r.Children;

显示信息

全部展开

此 属性 为只读。

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

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

注意

MATLAB® 在启动时设置此属性的显示信息值。值是静态的。如果您的系统显示设置发生变化，例如，如果您插入了新监视器，则这些值不会更新。要刷新值，需要重新启动 MATLAB。

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

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

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

示例: [500 400]

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

此 属性 为只读。

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

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

  • 在 Macintosh 系统上，该值为 72 DPI。

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

注意

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

此 属性 为只读。

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

  • 当以像素为单位时，left 和 bottom 值都是 1，当使用其他单位时，这些值均为 0。

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

注意

在 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'

MonitorPositions、ScreenSize 和PointerLocation 属性的单位，指定为下表中所示的值之一。

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 对象句柄始终可见。

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

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

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

版本历史记录

在 R2006a 之前推出

另请参阅

主题