WordCloudChart 属性
控制文字云图的外观和行为
WordCloudChart
属性控制 WordCloudChart
对象的外观和行为。通过更改属性值,您可以修改文字云图的某些方面。
标题
Title
— 图窗中显示在文字云图上方的文本
''
(默认) | 字符数组 | 字符向量元胞数组 | 字符串 | 字符串元胞数组 | 数值 | 分类数组
图窗中显示在文字云图上方的文本,指定为字符数组、字符向量元胞数组、标量字符串、字符串元胞数组、数值或分类数组。如果将此属性指定为分类数组,则 MATLAB® 将使用数组中的值,而不是完整的类别集。也可以使用 title
函数设置此值。
示例: "Word Cloud"
数据类型: string
| char
| cell
TitleFontName
— 文字云图中的标题文本使用的字体
'Helvetica'
(默认) | 字符向量 | 字符串
文字云图中的标题文本使用的字体,指定为字符串或字符向量。要正确显示和打印文本,字体名称必须是系统支持的字体。默认字体取决于具体操作系统和区域设置。
示例: 'Cambria'
数据类型: char
| string
颜色和样式
Color
— 单词颜色
[0.2510 0.2510 0.2510]
(默认) | RGB 三元组 | 包含颜色名称的字符向量 | 矩阵
单词颜色,指定为 RGB 三元组、包含颜色名称的字符向量,或者指定为 N
×3 矩阵,其中 N
是 WordData
的长度。如果 Color
是矩阵,则每一行对应于 WordData
中相应单词的 RGB 三元组。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码'#FF8800'
与'#ff8800'
、'#F80'
与'#f80'
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: 'blue'
示例: [0 0 1]
HighlightColor
— 单词高亮颜色
[0.8510 0.3255 0.0980]
(默认) | RGB 三元组 | 包含颜色名称的字符向量
单词高亮颜色,指定为 RGB 三元组或包含颜色名称的字符向量。软件使用此颜色突出显示那些最大的单词。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码'#FF8800'
与'#ff8800'
、'#F80'
与'#f80'
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
示例: 'blue'
示例: [0 0 1]
FontName
— 文字云图中的文本使用的字体
'Helvetica'
(默认) | 字符向量 | 字符串
文字云图中的文本使用的字体,指定为字符串或字符向量。要正确显示和打印文本,字体名称必须是系统支持的字体。默认字体取决于具体操作系统和区域设置。
示例: 'Cambria'
数据类型: char
| string
MaxDisplayWords
— 要显示的最大单词数
100 (默认) | 非负整数
要显示的最大单词数,指定为非负整数。软件会显示前 MaxDisplayWords
个出现频率最高的单词。
Box
— 坐标区框轮廓
'off'
(默认) | 'on'
坐标区框轮廓,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'off'
- 不显示围绕坐标区的框轮廓。'on'
- 显示围绕坐标区的框轮廓。
示例: 'on'
Shape
— 文字云的形状
'oval'
(默认) | 'rectangle'
文字云图的形状,指定为 'oval'
或 'rectangle'
。
示例: 'rectangle'
LayoutNum
— 单词的位置布局
1 (默认) | 非负整数
单词的位置布局,指定为非负整数。如果您使用相同的输入重复调用 wordcloud
,则每次的单词位置布局都相同。要获得不同的单词位置布局,请使用不同的 LayoutNum
值。
SizePower
— 要对 SizeData
应用的幂
0.5 (默认) | 正标量
要对 SizeData
应用的幂,指定为正标量。本软件显示的单词大小由 SizeData .^ SizePower
指定。
示例: 2
数据
WordData
— 单词数据
""
(默认) | 字符串向量 | 字符向量元胞数组
单词数据,指定为字符串向量或字符向量元胞数组。
示例: ["one" "two" "three"]
数据类型: string
| cell
SizeData
— 大小数据
[]
(默认) | 数值向量
大小数据,指定为数值向量。
示例: [0.1 0.2 0.3]
WordVariable
— 源表中的单词数据变量
字符向量
源表中的单词数据变量,指定为字符向量。
数据类型: char
SizeVariable
— 源表中的大小数据变量
字符向量
源表中的大小数据变量,指定为字符向量。
数据类型: char
SourceTable
— 源表
表
包含单词和大小数据的源表。
数据类型: table
位置
OuterPosition
— 文字云图在父级内的大小和位置
[0 0 1 1]
(默认) | 1×4 数值向量
文字云图在父级内的大小和位置,指定为 [left,bottom,width,height]
形式的 1×4 数值向量。包括标签和边距。[0 0 1 1]
的默认值包括容器的整个内部。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
InnerPosition
— 内部大小和位置
[0 0 1 1]
(默认) | 1×4 数值向量
文字云在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,返回为 [left bottom width height]
形式的 1×4 数值向量。
left
和bottom
元素定义容器左下角到文字云左下角的距离。width
和height
元素是文字云的维度。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
Position
— 内部大小和位置
四元素向量
文字云在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,指定为 [left bottom width height]
形式的四元素向量。此属性等同于 InnerPosition
属性。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
PositionConstraint
— 保持不变的位置
'outerposition'
| 'innerposition'
在增加、删除或更改装饰元素时保持不变的位置属性,指定为下列值之一:
'outerposition'
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,OuterPosition
属性保持不变。如需任何位置调整,MATLAB 会调整InnerPosition
属性。'innerposition'
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,InnerPosition
属性保持不变。如需任何位置调整,MATLAB 会调整OuterPosition
属性。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
Units
— OuterPosition
属性使用的单位
'normalized'
(默认) | 'points'
| 'pixels'
| 'characters'
| 'inches'
| 'centimeters'
OuterPosition
属性使用的单位,指定为 'normalized'
、'points'
、'pixels'
、'characters'
、'inches'
或 'centimeters'
。
Layout
— 布局选项
空 LayoutOptions
数组 (默认) | TiledChartLayoutOptions
对象 | GridLayoutOptions
对象
布局选项,指定为 TiledChartLayoutOptions
或 GridLayoutOptions
对象。当图采用分块图布局或网格布局时,此属性非常有用。
要在分块图布局的网格中定位图,请设置 TiledChartLayoutOptions
对象的 Tile
和 TileSpan
属性。例如,假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格,外边缘四周各有一个图块。实际上,该网格不可见,外侧图块也不占用空间,除非您用坐标区或图填充它们。
以下代码将图 c
放置在网格的第三个图块中。
c.Layout.Tile = 3;
要使图占据多个图块,请将 TileSpan
属性指定为二元素向量。例如,此图占据了 2
行和 3
列的图块。
c.Layout.TileSpan = [2 3];
要将图放在四周的某个图块中,请将 Tile
属性指定为 'north'
、'south'
、'east'
或 'west'
。例如,将值设置为 'east'
会将图放置在网格右侧的图块中。
c.Layout.Tile = 'east';
要将图放入 App 内的一个布局中,请将此属性指定为 GridLayoutOptions
对象。有关在 App 中使用网格布局的详细信息,请参阅 uigridlayout
。
如果图不是分块图布局或网格布局的子级(例如,如果它是图窗或面板的子级),则此属性为空且不起作用。
Visible
— 可见性状态
'on'
(默认) | on/off 逻辑值
可见性状态,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'on'
- 显示对象。'off'
- 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。
父级/子级
Parent
— 父容器
Figure
对象 | Panel
对象 | Tab
对象 | TiledChartLayout
对象 | GridLayout
对象
父容器,指定为 Figure
、Panel
、Tab
、TiledChartLayout
或 GridLayout
对象。
HandleVisibility
— 对象句柄的可见性
'on'
(默认) | 'off'
| 'callback'
父级的 Children
属性中对象句柄的可见性,指定为下列值之一:
'on'
- 对象句柄始终可见。'off'
- 对象句柄始终不可见。该选项用于防止另一函数无意中对其进行更改。将HandleVisibility
设置为'off'
可在执行该函数时暂时隐藏句柄。'callback'
- 对象句柄在回调或回调所调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止通过命令行访问对象,但允许回调函数访问对象。
如果父级的 Children
属性中未列出该对象,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。此类函数的示例包括 get
、findobj
、gca
、gcf
、gco
、newplot
、cla
、clf
和 close
函数。
隐藏的对象句柄仍有效。将根 ShowHiddenHandles
属性设置为 'on'
以列出所有对象句柄,而不管其 HandleVisibility
属性设置如何。
版本历史记录
在 R2017b 中推出R2020a: 不推荐使用 ActivePositionProperty
从 R2020a 开始,不推荐设置或获取 ActivePositionProperty
。请改用 PositionConstraint
属性。
当前没有删除 ActivePositionProperty
的计划,但当您对图对象调用 set
、get
或 properties
函数时,该属性不再列出。
要更新代码,请进行以下更改:
将
ActivePositionProperty
的所有实例替换为PositionConstraint
。将所有对
'position'
选项的引用替换为'innerposition'
选项。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)