主要内容

TextScatter属性

控制文本散点图的外观和行为

TextScatter属性控制外观和行为TextScatter对象。通过更改属性值,可以修改文本散点图的某些方面。

文本

全部展开

文本标签,指定为字符串数组或字符向量的单元格数组。

例子:(“word1 word2”“word3”)

数据类型:字符串|细胞

要显示的文本数据的百分比,指定为从0到100的标量。若要显示所有文本,请设置TextDensityPercentage到100年。若不显示文本,请设置TextDensityPercentage为0。

如果你设置TextDensityPercentage到100,那么软件就不会绘制标记。

例子:70

文本标签的最大长度,指定为正整数。该软件将文本标签截断到这个长度,并在截断点添加省略号。

例子:10

字体样式

全部展开

字体名称,指定为要使用的字体的名称或“FixedWidth”.要正确显示和打印,字体名称必须是系统支持的字体。金宝app默认字体取决于特定的操作系统和地区。

要使用在任何区域设置中看起来都不错的固定宽度字体,请使用“FixedWidth”.的“FixedWidth”价值依赖于根FixedWidthFontName财产。设置根FixedWidthFontName属性导致立即更新显示以使用新字体。

例子:“威尔士”

字体大小,指定为点单位大于零的标量值。一个点=1/72英寸。要更改字体单位,请使用FontUnits财产。

例子:12

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

字符倾斜,指定为“正常”“斜体”.并不是所有的字体都有两种字体样式。因此,斜体字体可能看起来与正常字体相同。

文本字符的粗细,指定为以下值之一:

  • “正常”-由特定字体定义的默认权重

  • “大胆”-较粗的字符轮廓比正常

MATLAB®使用FontWeight属性以从系统上可用的字体中选择字体。并不是所有的字体都有粗体字体。因此,指定粗体字体权重仍然可能导致正常字体权重。

平滑的字体字符外观,指定为以下值之一:

  • “上”-应用字体平滑。减少文本字符中锯齿的出现,使文本更容易阅读。

  • “关闭”-不应用字体平滑。

文本框

全部展开

框轮廓的颜色,指定为“没有”,三元素RGB三元组,或颜色名称的字符向量。的默认边缘颜色“没有”使盒子的轮廓不可见。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0F.这些值不区分大小写。因此,颜色是代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

“绿色” ‘g’ (0 1 0) “# 00 ff00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “y” (1 1 0) “# FFFF00”

“黑” “k” (0 0 0) # 000000的

“白色” ' w ' (1 1 1) “# FFFFFF”

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

RGB值 十六进制颜色代码 外观
[0 0.4470 - 0.7410) “# 0072 bd”

(0.8500 0.3250 0.0980) “# D95319”

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

例子:“蓝”

例子:(0 0 1)

文本框背景的颜色,指定为以下值之一:

  • “没有”—设置文本框背景透明。

  • “数据”-使用指定的背景颜色ColorData.该软件自动选择一个前景来补充背景色。

  • RGB三联体-使用相同的颜色在情节中的所有标记。RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.5 0.6 0.7)

例子:(1 0 0)

文本框中围绕文本的空格,指定为点单位的正标量。

MATLAB使用程度上属性值加上保证金属性值以确定文本框的大小。

例子:8

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64

标记

全部展开

标记颜色,指定为以下值之一:

  • “汽车”—标记时,请使用与文本标签相同的颜色。

  • “没有”-不要显示标记。

  • RGB三联体-使用相同的颜色在情节中的所有标记。RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.5 0.6 0.7)

例子:(1 0 0)

标记大小,指定为正标量。

例子:10

数据

全部展开

x值,指定为标量或向量。文本散点图为中的每个值显示一个单独的标记XData

输入参数Xtextscattertextscatter3功能设置x值。XDataYData长度必须相等。

例子:[1 2 4 2 6]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

变量与XData,指定为包含MATLAB工作区变量名的字符向量。MATLAB在基本工作空间中计算变量以生成XData

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新XData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“x”

y值,指定为标量或向量。文本散点图为中的每个值显示一个单独的标记YData

输入参数Ytextscattertextscatter3功能设置y值。XDataYData长度必须相等。

例子:[1 3 3 4 6]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

变量与YData,指定为包含MATLAB工作区变量名的字符向量。MATLAB在基本工作空间中计算变量以生成YData

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新YData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“y”

z值,指定为标量或向量。

  • 对于二维散点图,ZData默认为空。

  • 对于3-D散点图,输入参数Zscatter3函数设置z值。XDataYData,ZData长度必须相等。

例子:[1 2 2 1 0]

数据类型:||int8|int16|int32|int64|uint8|uint16|uint32|uint64|分类|datetime|持续时间

变量与ZData,指定为包含MATLAB工作区变量名的字符向量。MATLAB在基本工作空间中计算变量以生成ZData

默认情况下,没有链接变量,所以值是空字符向量,''.如果你链接一个变量,那么MATLAB不会更新ZData立即值。要强制更新数据值,请使用refreshdata函数。

请注意

如果将一个数据源属性更改为包含不同维度数据的变量,则可能导致该函数生成警告,并且在将所有数据源属性更改为适当值之前不会呈现图表。

例子:“z”

文本颜色,指定为以下值之一:

  • RGB三联体-使用相同颜色的所有文本在情节。RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.5 0.6 0.7)

  • RGB三联体的三列矩阵-为图中的每个文本标签使用不同的颜色。矩阵的每一行定义了一种颜色。行数必须等于文本标签的数目。

  • 类别向量-为向量中的每个类别使用不同的颜色。指定ColorData作为一个长度相同的向量XData.属性指定每个类别的颜色颜色财产

例子:[1 0 0;0 1 0;0 0 1]

类别颜色,指定为RGB三联体矩阵。RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0, 1];例如,(0.5 0.6 0.7)

默认情况下,颜色等于ColorOrder属性的轴对象。

例子:[1 0 0;0 1 0;0 0 1]

可见性

全部展开

可见性状态,指定为以下值之一:

  • “上”—显示对象。

  • “关闭”-隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“textscatter”.使用此属性可查找绘图层次结构中给定类型的所有对象;例如,使用findobj

此属性是只读的。

用户指定的与对象关联的标记,指定为字符向量。标签提供了一种识别图形对象的方法。使用此属性可查找绘图层次结构中具有特定标记的所有对象;例如,搜索标签使用findobj

例子:“1月数据”

此属性是只读的。

与对象关联的数据,指定为任意MATLAB数据;例如,标量、向量、矩阵、单元格数组、字符数组、表或结构。MATLAB不使用这些数据。

要关联多组数据或将字段名附加到数据,请使用getappdatasetappdata功能。

例子:1:10 0

此属性是只读的。

用于图例标签的文本,指定为字符向量。如果不指定文本,则图例将使用表单的标签“dataN”.图例不会显示,直到你调用传说命令。

例子:“标签文本”

控件,用于从图例中包含或排除对象注释对象。设置底层IconDisplayStyle属性设置为以下值之一:

  • “上”-在图例中包含对象(默认)。

  • “关闭”-不要在图例中包含该对象。

例如,从图例中排除一个词干图。

p =情节(1:10“DisplayName的”“折线图”);持有s =茎(1:10“DisplayName的”“茎图”);持有s.Annotation.LegendInformation.IconDisplayStyle =“关闭”;传奇(“显示”

控件来控制图例中的项目传说函数。将第一个输入参数指定为要包含的图形对象的向量。

p =情节(1:10“DisplayName的”“折线图”);持有s =茎(1:10“DisplayName的”“茎图”);持有传奇(p)

父/子

全部展开

父,指定为PolarAxes集团,或变换对象。

儿女,归为空GraphicsPlaceholder数组或一个DataTip对象数组。使用此属性可查看绘制在图表上的数据提示列表。

属性添加或删除子节点孩子们财产。要将子列表添加到此列表,请设置财产的DataTip对象指向图表对象。

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

  • “上”-对象句柄总是可见的。

  • “关闭”对象句柄在任何时候都是不可见的。这个选项对于防止其他函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在函数执行期间暂时隐藏句柄。

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

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

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

交互控制

全部展开

鼠标单击回调,指定为以下值之一:

  • 函数处理

  • 单元格数组,包含函数句柄和附加参数

  • 字符向量,这是一个有效的MATLAB命令或函数,在基本工作区中进行评估(不推荐)

在单击对象时使用此属性执行代码。如果使用函数句柄指定此属性,则MATLAB在执行回调函数时传递两个参数:

  • 单击对象-您可以从回调函数中访问单击对象的属性。

  • 事件数据——此属性的参数为空。将其替换为波浪字符(),以指示不使用此参数。

有关如何使用函数句柄来定义回调函数的更多信息,请参见回调函数定义

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则此回调不执行。

例子:@myCallback

例子:{@myCallback,长度}

上下文菜单,指定为快捷菜单对象。使用此属性可在右键单击对象时显示上下文菜单。控件创建上下文菜单uicontextmenu函数。

请注意

如果PickableParts属性设置为“没有”或者如果HitTest属性设置为“关闭”,则不会出现上下文菜单。

选择状态,指定为以下值之一:

  • “上”——选择。如果在绘图编辑模式下单击对象,则MATLAB将其设置为选择财产“上”.如果SelectionHighlight属性也设置为“上”,然后MATLAB显示对象周围的选择手柄。

  • “关闭”——而不是选择。

选择句柄时的显示,指定为以下值之一:

  • “上”-显示选择手柄时选择属性设置为“上”

  • “关闭”-永远不显示选择句柄,即使当选择属性设置为“上”

数据提示内容,指定为DataTipTemplate对象。您可以通过修改底层的属性来控制出现在数据提示中的内容DataTipTemplate对象。有关属性列表,请参见DataTipTemplate属性

有关修改数据提示的示例,请参见创建自定义数据提示

请注意

DataTipTemplate对象不返回findobjfindall,它不会被复制copyobj

回调执行控制

全部展开

捕捉鼠标点击的能力,指定为以下值之一:

  • “可见”-可以捕捉鼠标点击时,可见。的可见属性必须设置为“上”你必须点击其中的一部分TextScatter具有已定义颜色的对象。不能单击将关联颜色属性设置为的部件“没有”.如果情节包含标记,那么如果边缘或填充具有定义的颜色,那么整个标记都是可点击的。的HitTest属性决定TextScatter对象对单击作出响应,如果是祖先则响应。

  • “没有”-无法捕获鼠标点击。单击TextScatter对象将单击传递给图形窗口当前视图中其下方的对象。的HitTest财产的TextScatter对象没有效果。

对捕获的鼠标点击的响应,指定为以下值之一:

  • “上”——触发ButtonDownFcn回调的TextScatter对象。如果你定义了UIContextMenu属性,然后调用上下文菜单。

  • “关闭”对象的最近祖先触发回调TextScatter对象,该对象具有HitTest属性设置为“上”和一个PickableParts属性值,该属性使祖先能够捕获鼠标单击。

请注意

PickableParts属性决定TextScatter对象可以捕获鼠标点击。如果不能,那么HitTest财产没有影响。

回调中断,指定为“上”“关闭”.的可中断属性确定是否可以中断正在运行的回调。

请注意

有两种回调状态需要考虑:

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

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

当MATLAB调用回调时,回调试图中断正在运行的回调。的可中断属性决定是否允许中断。如果不允许中断,则BusyAction拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。

如果ButtonDownFcn回调的TextScatter对象是正在运行的回调函数,然后可中断属性确定另一个回调是否可以中断它:

  • “上”——可中断。中断发生在MATLAB处理队列的下一个点,例如当有drawnow数字getframe等待,或暂停命令。

    • 如果正在运行的回调包含这些命令之一,那么MATLAB将在此时停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB继续执行正在运行的回调。有关更多信息,请参见中断执行回调

    • 如果正在运行的回调函数不包含这些命令之一,那么MATLAB将在不中断的情况下完成回调函数的执行。

  • “关闭”——而不是可中断。MATLAB在没有任何中断的情况下完成了正在运行的回调。

指定为“队列”“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。

请注意

有两种回调状态需要考虑:

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

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

当MATLAB调用回调时,回调试图中断正在运行的回调。的可中断属性决定是否允许中断。如果不允许中断,则BusyAction拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。

如果ButtonDownFcn回调的TextScatter对象试图中断不能被中断的正在运行的回调,则BusyAction属性确定它是被丢弃还是放入队列中。指定BusyAction属性为以下值之一:

  • “队列”—将中断回调放入正在运行的回调执行完成后待处理的队列中。这是默认行为。

  • “取消”—放弃中断回调。

创建和删除控件

全部展开

创建回调,指定为以下值之一:

  • 函数处理

  • 单元格数组,包含函数句柄和附加参数

  • 字符向量,这是一个有效的MATLAB命令或函数,在基本工作区中进行评估(不推荐)

在创建对象时使用此属性执行代码。设置CreateFcn属性对现有对象不起作用。必须为该属性定义默认值,或使用名称,值在创建对象时对。MATLAB在创建对象并设置其所有属性后执行回调。

如果你使用函数句柄指定这个回调函数,那么MATLAB在执行回调函数时将传递两个参数:

  • 创建的对象——你可以从回调函数中访问对象的属性。控件也可以访问该对象CallbackObject属性,可以使用gcbo函数。

  • 事件数据——此属性的参数为空。将其替换为波浪字符(),以指示不使用此参数。

有关如何使用函数句柄来定义回调函数的更多信息,请参见回调函数定义

例子:@myCallback

例子:{@myCallback,长度}

删除回调,指定为以下值之一:

  • 函数处理

  • 单元格数组,包含函数句柄和附加参数

  • 字符向量,这是一个有效的MATLAB命令或函数,在基本工作区中进行评估(不推荐)

MATLAB在销毁对象之前执行回调,以便回调可以访问它的属性值。

如果你使用函数句柄指定这个回调函数,那么MATLAB在执行回调函数时将传递两个参数:

  • 删除对象-你可以从回调函数中访问对象的属性。控件也可以访问该对象CallbackObject属性,可以使用gcbo函数。

  • 事件数据——此属性的参数为空。将其替换为波浪字符(),以指示不使用此参数。

有关如何使用函数句柄来定义回调函数的更多信息,请参见回调函数定义

例子:@myCallback

例子:{@myCallback,长度}

删除状态,返回“关闭”“上”.MATLAB设置BeingDeleted财产“上”当对象的delete函数开始执行时(请参阅DeleteFcn属性)。的BeingDeleted属性仍然设置为“上”直到对象不再存在。

检查该值BeingDeleted属性来验证对象在查询或修改之前不会被删除。

兼容性的考虑

全部展开

不建议在R2020a开始

介绍了R2017b