CategoricalRuler 属性
控制具有分类值的轴
CategoricalRuler 属性可控制显示分类值的 x 轴、y 轴或 z 轴的外观和行为。每一个单独的轴都有它自己的标尺对象。通过更改标尺的属性值，您可以修改特定轴的某些方面。
使用圆点表示法引用特定的标尺和属性。可通过 Axes 对象的 XAxis、YAxis 和 ZAxis 属性访问标尺对象。例如：
ax = gca; co = ax.XAxis.Color; ax.XAxis.Color = 'blue';
外观
轴线和标签的颜色，指定为 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" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 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)) 获取十六进制颜色代码。
注意
标尺的 Color 属性与其父坐标区所关联的 XColor、YColor 或 ZColor 属性始终具有相同的值。设置一个会同时设置另一个。
轴标签水平对齐，指定为表中的值之一。
LabelHorizontalAlignment 值 | 描述 | 外观 |
|---|---|---|
'center' | 对于水平轴，标签位于图框的左右边缘之间的中间位置。 对于垂直轴，标签位于图框的上下边缘之间的中心位置。 |
|
'left' | 对于水平轴，标签与图框的左边缘对齐。 对于垂直轴，标签与图框的下边缘对齐。 |
|
'right' | 对于水平轴，标签与图框的右边缘对齐。 对于垂直轴，标签与图框的上边缘对齐。 |
|
标度和方向
刻度值和标签
沿轴绘制的类别，指定为字符向量元胞数组、分类数组或字符串数组。查询此属性将返回一个字符向量元胞数组。设置此属性可阻止某些类别出现在图中。
示例: ax.XAxis.Categories = categorical({'small','medium','large'}) 指定分类数组。
示例: ax.XAxis.Categories = {'small','medium','large'} 指定元胞数组。
示例: ax.XAxis.Categories = string({'small','medium','large'}) 指定字符串数组。
示例
创建 x 轴为类别的一个直方图，并查询 Categories 属性。然后设置 Categories 属性，仅使一部分类别出现在该轴上。
A = categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Categories
ans =
1×5 categorical array
b g m r y ax.XAxis.Categories = categorical({'b','m','y'});数据类型: cell | categorical | string
沿轴显示的第一个和最后一个类别，指定为指示两个类别名称的二元素向量。这两个类别必须是 Categories 属性中的类别，而且出现的相对顺序必须与 Categories 属性中相同。
示例: ax.XAxis.Categories = categorical({'small','medium'}) 指定二元素分类数组。
示例: ax.XAxis.Categories = {'small','medium'} 指定二元素元胞数组。
示例: ax.XAxis.Categories = string({'small','medium'}) 指定二元素字符串数组。
如果您为此属性赋值，则 MATLAB® 会将关联的 LimitsMode 属性更改为 'manual'。
或者，使用 xlim、ylim 和 zlim 函数设置范围。
注意
标尺的 Limits 属性与其父坐标区所关联的 XLim、YLim 或 ZLim 属性始终具有相同的值。设置一个会同时设置另一个。
示例
设置 Limits 属性，以便只沿轴显示 'b' 和 'm' 之间的类别。
A = categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Limits = categorical({'b','m'});数据类型: categorical | string | cell
轴上的刻度线位置，指定为指示类别名称的字符向量元胞数组、分类数组或字符串数组。这些类别必须属于 Categories 属性中的一部分类别，而且出现的相对顺序必须与 Categories 属性中相同。要删除轴上的所有刻度线和标签，请将此属性设置为空数组 []。
示例: ax.XAxis.Categories = categorical({'small','medium','large'}) 指定分类数组。
示例: ax.XAxis.Categories = {'small','medium','large'} 指定元胞数组。
示例: ax.XAxis.Categories = string({'small','medium','large'}) 指定字符串数组。
如果您为此属性赋值，则 MATLAB 会将 TickValuesMode 属性设置为 'manual'。
或者，使用 xticks、yticks 和 zticks 函数。
注意
标尺的 TickValues 属性与其父坐标区所关联的 XTick、YTick 或 ZTick 属性始终具有相同的值。设置一个会同时设置另一个。
示例
通过将 TickValues 属性设置为类别子集，可以标记沿轴的类别子集。
A = categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.TickValues = categorical({'b','m','y'});数据类型: categorical | string | cell
刻度线标签，指定为字符向量元胞数组、字符串数组或分类数组。使用此属性可以重新为刻度线添加标签，而不用更改类别名称。如果您没有为每一个值都指定标签，标签将会重复。标签支持 TeX 和 LaTeX 标记。有关详细信息，请参阅 TickLabelInterpreter 属性。
如果您设置此属性，则 MATLAB 会将 TickLabelsMode 属性设置为 'manual'。
或者，使用 xticklabels、yticklabels 和 zticklabels 函数指定刻度标签。
注意
如果将此属性指定为分类数组，MATLAB 将使用数组中的值，而不是类别。
标尺的
TickLabels属性与其父坐标区所关联的XTickLabel、YTickLabel或ZTickLabel属性始终具有相同的值。设置一个会同时设置另一个。
示例
重新为 x 轴上的类别添加标签。
A = categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g'});
h = histogram(A);
ax = gca;
ax.XAxis.TickLabels = {'Blue','Green','Red','Yellow'}数据类型: char | string | categorical
刻度标签颜色，指定为 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" |
|
"none" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
| 调色板 | 调色板颜色 |
|---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 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)) 获取十六进制颜色代码。
注意
设置标尺的 Color 属性也会将 TickLabelColor 属性设置为相同的值。但是，设置 TickLabelColor 属性不会更改 Color 属性。为了防止 Color 属性值覆盖 TickLabelColor 属性值，请先设置 Color 属性，然后设置 TickLabelColor 属性。
次刻度线位置，指定为指示类别名称的字符向量元胞数组、分类数组或字符串数组。这些类别必须属于 Categories 属性中的一部分类别，而且出现的相对顺序必须与 Categories 属性中相同。
如果您赋值给此属性，则 MATLAB 会将 MinorTickValuesMode 属性设置为 'manual'。
数据类型: categorical | string | cell
