WordCloudChart 属性

图窗中显示在文字云图上方的文本，指定为字符数组、字符向量元胞数组、标量字符串、字符串元胞数组、数值或分类数组。如果将此属性指定为分类数组，则 MATLAB^® 将使用数组中的值，而不是完整的类别集。也可以使用 title 函数设置此值。

示例: "Word Cloud"

文字云图中的标题文本使用的字体，指定为字符串或字符向量。要正确显示和打印文本，字体名称必须是系统支持的字体。默认字体取决于具体操作系统和区域设置。

示例: 'Cambria'

单词颜色，指定为 RGB 三元组、包含颜色名称的字符向量，或者指定为 N×3 矩阵，其中 N 是 WordData 的长度。如果 Color 是矩阵，则每一行对应于 WordData 中相应单词的 RGB 三元组。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: 'blue'

示例: [0 0 1]

单词高亮颜色，指定为 RGB 三元组或包含颜色名称的字符向量。软件使用此颜色突出显示那些最大的单词。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

示例: 'blue'

示例: [0 0 1]

文字云图中的文本使用的字体，指定为字符串或字符向量。要正确显示和打印文本，字体名称必须是系统支持的字体。默认字体取决于具体操作系统和区域设置。

示例: 'Cambria'

要显示的最大单词数，指定为非负整数。软件会显示前 MaxDisplayWords 个出现频率最高的单词。

坐标区框轮廓，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

示例: 'on'

文字云图的形状，指定为 'oval' 或 'rectangle'。

示例: 'rectangle'

单词的位置布局，指定为非负整数。如果您使用相同的输入重复调用 wordcloud，则每次的单词位置布局都相同。要获得不同的单词位置布局，请使用不同的 LayoutNum 值。

要对 SizeData 应用的幂，指定为正标量。本软件显示的单词大小由 SizeData .^ SizePower 指定。

示例: 2

单词数据，指定为字符串向量或字符向量元胞数组。

示例: ["one" "two" "three"]

大小数据，指定为数值向量。

示例: [0.1 0.2 0.3]

源表中的单词数据变量，指定为字符向量。

源表中的大小数据变量，指定为字符向量。

包含单词和大小数据的源表。

文字云图在父级内的大小和位置，指定为 [left,bottom,width,height] 形式的 1×4 数值向量。包括标签和边距。[0 0 1 1] 的默认值包括容器的整个内部。

文字云在父容器（通常为图窗、面板或选项卡）中的内部大小和位置，返回为 [left bottom width height] 形式的 1×4 数值向量。

文字云在父容器（通常为图窗、面板或选项卡）中的内部大小和位置，指定为 [left bottom width height] 形式的四元素向量。此属性等同于 InnerPosition 属性。

在增加、删除或更改装饰元素时保持不变的位置属性，指定为下列值之一：

OuterPosition 属性使用的单位，指定为 'normalized'、'points'、'pixels'、'characters'、'inches' 或 'centimeters'。

布局选项，指定为 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。

如果图不是分块图布局或网格布局的子级（例如，如果它是图窗或面板的子级），则此属性为空且不起作用。

可见性状态，指定为 "on" 或 "off"，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 "on" 等效于 true，"off" 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

父容器，指定为 Figure、Panel、Tab、TiledChartLayout 或 GridLayout 对象。

父级的 Children 属性中对象句柄的可见性，指定为下列值之一：

如果父级的 Children 属性中未列出该对象，则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。此类函数的示例包括 get、findobj、gca、gcf、gco、newplot、cla、clf 和 close 函数。

隐藏的对象句柄仍有效。将根 ShowHiddenHandles 属性设置为 "on" 以列出所有对象句柄，而不管其 HandleVisibility 属性设置如何。