主要内容

TiledChartLayout属性

平铺图表布局外观和行为

平铺图布局是用于在图形中显示平铺图的容器。每个tile可以包含一个用于显示图形的axis对象。通过更改属性值,可以修改布局的某些方面。

T = tiledlayout(2,2);t. tilespcing = 'compact';

布局

全部展开

网格大小,指定为窗体的矢量(mn),在那里行数是和吗n是列数。只有当布局中的所有磁贴都为空时,才能设置此属性。当你设置这个属性时,MATLAB®设置TileArrangement财产“固定”

属性的值可能会自动更改TileArrangement属性设置为“流”.例如,如果父容器调整大小或布局中的轴数发生变化,网格大小将更新以适应这些变化。

此属性是只读的。

平铺排列,作为以下值之一返回:

  • “固定”—布局具有固定的行数和列数GridSize财产。一个——- - - - - -n布局用这种平铺排列可以显示到m * n情节。

  • “流”-布局有可变数量的行和列,可以显示任意数量的情节。每次你打来电话nexttile,布局根据需要重新调整,以适应新轴,同时为所有瓷砖保持大约4:3的纵横比。

MATLAB将此属性的值设置为“固定”如果您手动设置GridSize财产。

瓷砖间距,指定为“宽松”“紧凑”“紧”“没有”.使用此属性可控制瓷砖之间的间距。

属性的外观如何受到每个值的影响2——- - - - - -2布局。

价值 外观

“宽松”

“松散”瓷砖间距的平铺图表布局。

“紧凑”

具有“紧凑”瓷砖间距的平铺图表布局。

“紧”

平铺图布局与“紧”平铺间距。

“没有”

平铺图布局与“无”平铺间距。

布局周边的填充,指定为“宽松”“紧凑”,或“紧”.布局为所有装饰(如轴标签)提供空间,而不考虑此属性的值。

属性的外观如何受到每个值的影响2——- - - - - -2布局。

价值 外观

“宽松”

平铺图表布局与“松散”填充。

“紧凑”

平铺图表布局与“紧凑”填充。

“紧”

平铺图表布局与“紧”填充。

瓷砖索引方案,指定为表中的值。的nexttile函数根据此索引方案填充磁贴。如果更改填充布局的磁贴索引方案,磁贴位置将更改以匹配新方案。索引方案还会影响调用时MATLAB返回的轴对象nexttile获取特定贴图中的坐标轴对象。

价值 描述
“rowmajor”

从左到右,每一行的瓦数都在增加。例如,这张图片显示了2 × 2布局的行主平铺索引。

“columnmajor”

瓦数沿列递增。例如,这张图片显示了2 × 2布局的列主平铺索引。

标签

全部展开

文本对象用于共享标题。若要添加共享标题,请设置字符串的属性文本对象。若要更改标题外观,如字体样式或颜色,请设置其他属性。例如,为具有粗体权重的2 × 2布局创建共享标题。

T = tiledlayout(2,2);t.Title.String =“我的名字”;t.Title.FontWeight =“大胆”

或者,传递TiledChartLayout对象的标题函数。

标题(t)“我的名字”“FontWeight”“正常”

有关可指定的属性的完整列表,请参见文本属性

请注意

文本对象中没有包含孩子们属性返回,因此它不能由findobj函数。

共享子标题的文本对象。要添加字幕,请设置字符串文本对象的属性。要更改其外观,如字体角度,请设置其他属性。有关完整列表,请参见文本属性

T = tiledlayout(2,2);t.Subtitle.String =“一个深刻的副标题”;t.Subtitle.FontAngle =“斜体”

或者,副标题函数添加子标题和控制外观。

副标题(“一个深刻的副标题”“FontAngle”“斜体”

或使用标题函数,并指定两个字符向量输入参数和两个输出参数。然后设置函数返回的第二个文本对象的属性。

[t,s] =标题(t,“聪明的标题”“一个深刻的副标题”);s.FontAngle =“斜体”

请注意

此文本对象不包含在坐标轴中孩子们属性,不能返回findobj,并且不使用为文本对象定义的默认值。

文本对象。x设在标签。要添加共享x-axis标签,设置字符串文本对象的属性。若要更改标签外观,如字体大小,请设置其他属性。例如,创建共享x-axis标签,使用14号字体,用于2 * 2布局。

T = tiledlayout(2,2);t.XLabel.String =“我的x轴标签”;t.XLabel.FontSize = 14;

或者,传递TiledChartLayout对象的包含函数。

包含(t)“我的x轴标签”“字形大小”14)

有关可指定的属性的完整列表,请参见文本属性

请注意

文本对象不包含在坐标轴中孩子们属性返回,因此不能由findobj

文本对象。y设在标签。要添加共享y-axis标签,设置字符串文本对象的属性。若要更改标签外观,如字体大小,请设置其他属性。例如,创建共享y-axis标签,使用14号字体,用于2 * 2布局。

T = tiledlayout(2,2);t.YLabel.String =“我的y轴标签”;t.YLabel.FontSize = 14;

或者,传递TiledChartLayout对象的ylabel函数。

ylabel (t)“我的y轴标签”“字形大小”14)

有关可指定的属性的完整列表,请参见文本属性

请注意

文本对象不包含在坐标轴中孩子们属性返回,因此不能由findobj

位置

全部展开

外部大小和位置,包括标题和轴标签等装饰的边缘,指定为窗体的四元素向量[左下宽高].对象指定的单位为向量中的值单位财产。的默认值[0 0 1 1]包括容器的整个内部。

  • 而且元素定义了从容器的左下角(通常是图形、面板或制表符)到外部位置边界的左下角的距离。

  • 宽度而且高度元素是外部位置边界尺寸。

在下面的布局中,蓝色矩形表示OuterPosition属性,红色矩形表示InnerPosition而且位置属性(具有相同的值)。

2乘2布局,蓝色矩形围绕四个轴和标签。四个绘图框周围只围绕一个红色矩形。

请注意

类的父容器时,设置此属性无效TiledChartLayout

内部大小和位置,不包括标题和轴标签等装饰的边缘,指定为窗体的四元素向量[左下宽高].这个属性等价于位置财产。

请注意

类的父容器时,设置此属性无效TiledChartLayout

内部大小和位置,不包括标题和轴标签等装饰的边缘,指定为窗体的四元素向量[左下宽高].对象指定的单位为向量中的值单位财产。

  • 而且元素定义了从容器的左下角(通常是图形、面板或制表符)到位置边界的左下角的距离。

  • 宽度而且高度元素是位置边界尺寸。对于3-D视图中的轴,位置属性是包含坐标轴的最小矩形。

在下面的布局中,蓝色矩形表示OuterPosition属性,红色矩形表示InnerPosition而且位置属性(具有相同的值)。

2乘2布局,蓝色矩形围绕四个轴和标签。四个绘图框周围只围绕一个红色矩形。

请注意

类的父容器时,设置此属性无效TiledChartLayout

Position属性,在添加、删除或更改装饰时保持不变,指定为以下值之一:

  • “outerposition”- - -OuterPosition属性在添加、删除或更改标题或轴标签等装饰时保持不变。如果需要任何位置调整,MATLAB调整InnerPosition财产。

  • “innerposition”- - -InnerPosition属性在添加、删除或更改标题或轴标签等装饰时保持不变。如果需要任何位置调整,MATLAB调整OuterPosition财产。

请注意

类的父容器时,设置此属性无效TiledChartLayout

定位单位,指定为此表中的值之一。

单位 描述
“归一化”(默认) 对父容器进行了规范化,通常是图中的父容器。图的左下角映射到(0,0)右上角映射到(1,1)
“英寸” 英寸。
“厘米” 厘米。
“角色”

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

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

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

“点” 点。1分等于1/72英寸。
“像素”

像素。

  • 在Windows上®一个像素是1/96英寸。

  • 麦金塔电脑在系统中,一个像素是1/72英寸。

  • 在Linux上®在系统中,像素的大小是由系统分辨率决定的。

所有单位都从父容器的左下角开始测量。

属性会影响其他属性,例如位置财产。如果更改了单位,则在完成计算后将单位返回为默认值,以防止影响采用默认值的其他函数。

如果您指定位置而且单位属性是名称,值对创建对象时,那么规范的顺序很重要。例如,要设置特定单位中的位置,则必须设置单位属性位置财产。

布局选项,指定为TiledChartLayoutOptions对象或GridLayoutOptions对象。使用此属性可在其父布局中定位嵌套布局。例如,要在另一个平铺图表布局中定位布局,请设置瓷砖而且TileSpan属性TiledChartLayoutOptions对象。

例如,这段代码定位layout2进入第三个格子layout1

Layout1 = tiledlayout(2,2);Layout2 = tiledlayout(layout1,1,3);layout2.Layout。Tile = 3;

要使嵌套布局跨越多个磁贴,请指定TileSpan属性作为两元素向量。例如,这段代码跨越layout2穿过一排两列的瓷砖。

layout2.Layout。TileSpan= [1 2];
如果你在两个布局中都填充了所有的tile,复合布局看起来是这样的:

2 × 2布局,第二行是嵌套的1 × 3布局。

要将布局放置到应用程序中的网格布局中,请将此属性指定为GridLayoutOptions对象。有关在应用程序中使用网格布局的更多信息,请参见uigridlayout

如果该布局不是另一布局的子布局(例如,如果该布局是图形或面板的子布局),则此属性为空且不起作用。

交互性

全部展开

共享数据浏览工具栏,指定为AxesToolbar对象返回的axtoolbar函数。当鼠标悬停在工具栏上时,工具栏会出现在布局的右上角。

默认情况下,没有共享工具栏,每个单独的axis对象都有自己的工具栏。创建共享工具栏时,各个轴对象上的工具栏将被隐藏。如果您不希望布局中有任何工具栏,请将此属性保留为空并设置可见的属性AxesToolbar对象“关闭”对于每个轴。

T = tiledlayout(2,1);Ax = nexttile;ax.Toolbar.Visible =“关闭”

可见状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”—显示对象。

  • “关闭”—隐藏对象,但不删除对象。你仍然可以访问一个不可见对象的属性。

回调

全部展开

对象创建函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定在MATLAB创建对象时执行的回调函数。函数执行之前,MATLAB初始化所有属性值CreateFcn回调。如果没有指定CreateFcn属性,然后MATLAB执行默认的创建函数。

设置CreateFcn属性在现有组件上不起作用。

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

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见回调函数定义

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前。如果没有指定DeleteFcn属性,然后MATLAB执行默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo函数来访问对象。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

此属性决定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow数字uifiguregetframe等待,暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后再执行中断回调。

如果正在运行的回调包含这些命令之一,则可中断属性决定是否发生中断:

  • 如果的值可中断“关闭”,则不发生中断。相反,BusyAction属性确定中断回调是被丢弃还是添加到回调队列。

  • 如果的值可中断“上”,则中断。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB继续执行正在运行的回调。

请注意

回调中断和执行在以下情况下表现不同:

  • 如果中断回调是DeleteFcnCloseRequestFcn,或SizeChangedFcn回调函数时,中断发生,而不管可中断属性值。

  • 方法当前正在执行等待函数,则中断发生而不管可中断属性值。

  • 如果中断回调属于计时器对象,则回调函数将根据调度执行,而不管可中断属性值。

请注意

当中断发生时,MATLAB不保存属性的状态或显示。方法返回的对象gcagcf命令可能在执行另一个回调时更改。

回调队列,指定为“队列”“取消”.的BusyAction属性决定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

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

在这些条件下,BusyAction拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction属性:

  • “队列”—将中断的回调放到队列中,待正在运行的回调执行完成后再处理。

  • “取消”—不执行中断回调。

此属性是只读的。

删除状态,作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted财产“上”DeleteFcn回调开始执行。的BeingDeleted属性仍然设置为“上”直到组件对象不再存在。

的值BeingDeleted属性在查询或修改对象之前验证对象是否即将被删除。

父/子

全部展开

父容器,指定为数字面板选项卡TiledChartLayout,或GridLayout对象。

子,作为图形对象数组返回。使用此属性可查看子元素列表,或通过将该属性设置为自身的排列来重新排列子元素。

属性不能添加或删除子元素孩子们财产。要将子元素添加到此列表中,请设置属性的子图形对象TiledChartLayout对象。

对象句柄的可见性孩子们属性,指定为以下值之一:

  • “上”-对象句柄始终可见。

  • “关闭”-对象句柄在任何时候都不可见。此选项用于防止另一个函数的意外更改。设置HandleVisibility“关闭”在函数执行期间暂时隐藏句柄。

  • “回调”对象句柄在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行上访问对象,但允许回调函数访问它。

属性中未列出对象孩子们属性,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数不能返回它。此类函数的示例包括得到findobjgcagcfgconewplotclf,关闭功能。

隐藏对象句柄仍然有效。设置根目录ShowHiddenHandles财产“上”列出所有对象句柄,而不管它们HandleVisibility属性设置。

标识符

全部展开

此属性是只读的。

返回的图形对象类型为“tiledlayout”

对象标识符,指定为字符向量或字符串标量。您可以指定一个惟一的标签值作为对象的标识符。方法在代码中的其他地方需要访问对象时,可以使用findobj方法搜索对象标签价值。

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

如果您在应用程序设计器中工作,请在应用程序中创建公共或私有属性以共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用设计器应用中共享数据

兼容性的考虑

全部展开

R2021a的行为发生了变化

另请参阅

|

R2019b引入