2026a

# axes 属性


坐标区的外观和行为

# 字体

fontname - 字体名称
支持的字体名称

字体名称,指定为支持的字体名称。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

fontsize - 字体大小
数值标量

字体大小,指定为数值标量。字体大小会影响标题、轴标签和刻度标签。

fontweight - 字符粗细
"normal" (默认)| "bold"

字符粗细,指定为 "normal" 或 "bold"。

fontangle - 字符倾斜
"normal" (默认)| "italic"

字符倾斜,指定为 "normal" 或 "italic"。

并非所有字体都有两种字体样式。因此,斜体可能看上去和常规字体一样。

# 刻度

xtick,ytick,ztick - 刻度值
由递增值组成的向量

刻度值,指定为由递增值组成的向量。如果您不希望沿坐标轴显示刻度线,请指定空向量 []。刻度值是坐标轴上显示刻度线的位置。刻度标签是您在每个刻度线旁边看到的标签。使用 XTickLabels、YTickLabels 和 ZTickLabels 属性指定关联的标签。

xtickmode,ytickmode,ztickmode - 刻度值的选择模式
"auto" (默认)| "manual"

此属性为只读。 刻度值的选择模式,指定为下列值之一:

  • "auto" - 根据坐标轴的数据范围自动选择刻度值;
  • "manual" - 手动指定刻度值。要指定值,请设置 XTick、YTick 或 ZTick 属性。
xticklabel, yticklabel, zticklabel - 刻度标签
字符向量|字符串数组|分类数组

刻度标签,指定为字符向量|字符串数组|分类数组。如果您不希望显示刻度标签,请指定空数组 []。如果您没有为所有刻度值指定足够多的标签,将会重复使用标签。

xticklabelmode, yticklabelmode, zticklabelmode - 刻度标签的选择模式
"auto" (默认) | "manual"

此属性为只读。 刻度标签的选择模式,指定为下列值之一:

  • "auto" - 自动选择刻度标签;
  • "manual" - 手动指定刻度标签。要指定标签,请设置 XTickLabel、YTickLabel 或 ZTickLabel 属性。
xminortick, yminortick, zminortick - 次刻度线
"on"/"off"

次刻度线,指定为 "on" 或 "off"。

  • "on" - 在坐标轴的主刻度线之间显示次刻度线。主刻度线的间距决定次刻度线的数目。此值是使用对数刻度的坐标轴的默认值;
  • "off" - 不显示次刻度线。此值是使用线性刻度的坐标轴的默认值。
tickdir - 刻度线方向
"in"(默认)/"out"/"inout"

三维轴不支持该属性。
刻度线方向,指定为下列值之一:

  • "in" - 刻度线从轴线指向内部;
  • "out" - 刻度线从轴线指向外部;
  • "inout" - 刻度线以轴线为中心。
xexponent, yexponent, zexponent - 刻度值通用的指数计数法
整数值

所有刻度值通用的指数记数法,指定为整数值。该轴显示次级标签 10^5。

底数值始终为 10。但是,您可以通过设置 xexponent, yexponent, zexponent 属性更改指数值。例如,将指数更改为 2。

ax = gca;
plt_set(ax,"xexponent", 2)

如果指数值为 0,则不会显示指数标签。

如果您为此属性赋值,则 Syslab 会将 *exponentmode 属性设置为 "manual"。如果轴使用对数刻度,则 *exponent 属性不起作用。

xexponentmode,yexponentmode,zexponentmode - xexponent,yexponent,zexponent 属性的选择模式
"auto" (默认) | "manual"

xexponent,yexponent,zexponent 属性的选择模式,指定为下列值之一:

  • "auto" - 根据坐标轴范围自动选择指数值;

  • "manual" - 使用您指定的指数值。要指定值,请设置 *exponent 属性。

# 标尺

xlim, ylim, zlim - 最小和最大坐标轴范围
(min,max)形式的二元素元组

最小和最大范围,指定为 (min, max) 形式的二元素元组,其中 max 大于 min。您可以将范围指定为数字、分类、日期时间或持续时间值。但您指定的值类型必须与坐标轴上的值类型匹配。

xlimmode, ylimmode, zlimmode - 坐标轴范围的选择模式
"auto"(默认) | "manual"

此属性为只读。 坐标轴范围的选择模式,指定为下列值之一:

  • "auto" - 根据绘制的数据(即坐标区中显示的所有对象的 xdata、ydata 或 zdata 的总体范围)自动选择坐标轴范围;
  • "manual" - 手动指定坐标轴范围。要指定坐标轴范围,请设置 xlim、ylim 或 zlim 属性。
xaxis, yaxis, zaxis - 轴标尺
标尺对象

此属性为只读。
轴标尺,以标尺对象的形式返回。标尺控制 x 轴、y 轴或 z 轴的外观和行为。通过访问相关的标尺并设置标尺属性,可以修改坐标轴的外观和行为。

xcolor, ycolor, zcolor - 轴线、刻度值和标签的颜色
[0 0 0](默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

x、y 或 z 方向的轴线、刻度值和标签的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4, 0.6, 0.7];
  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0 到 F。 这些值不区分大小写。因此,颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
颜色名称 短名称 RGB 三元组 十六进制颜色代码 外观
"red" "r" [1, 0, 0] "#FF0000"
"green" 不适用 [0, 0.5019607843137255, 0] "#008000"
不适用 "g" [0, 0.5, 0] "#007F00"
不适用 不适用 [0, 1, 0] "#00FF00"
"blue" "b" [0, 0, 1] "#0000FF"
"cyan" 不适用 [0, 1, 1] "#00FFFF"
不适用 "c" [0, 0.75, 0.75] "#00BFBF"
"magenta" 不适用 [1, 0, 1] "#FF00FF"
不适用 "m" [0.75, 0, 0.75] "#BF00BF"
"yellow" 不适用 [1, 1, 0] "#FFFF00"
不适用 "y" [0.75, 0.75, 0] "#BFBF00"
"black" "k" [0, 0, 0] "#000000"
"white" "w" [1, 1, 1] "#FFFFFF"
"none" 不适用 不适用 不适用 无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 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"
xdir - x 轴的方向
"normal" (默认) | "reverse"

x 轴方向,指定为下列值之一:

  • "normal" 值从左向右逐渐增加;
  • "reverse" 值从右到左逐渐增加。
ydir - y 轴的方向
"normal" (默认) | "reverse"

y 轴方向,指定为下列值之一:

  • "normal" 值从下向上(二维视图)或从前向后(三维视图)逐渐增加;
  • "reverse" 值从上向下(二维视图)或从后向前(三维视图)逐渐增加。
zdir - Z 轴的方向
"normal" (默认) | "reverse"

z 轴方向,指定为下列值之一:

  • "normal" 值按从内向外(二维视图)或从下向上(三维视图)逐渐增加;
  • "reverse" 值按从外向内(二维视图)或从上向下(三维视图)逐渐增加。
xscale, yscale, zscale - 值沿坐标轴的标度
"linear" (默认) | "log"

坐标轴刻度,"linear" 表示线性刻度,"log" 表示对数刻度。

# 网格

xgrid, ygrid, zgrid - 网格线
"on"/"off"

网格线,指定为 "on" 或 "off"。

  • "on" - 坐标轴正交的网格线,例如,沿着常量 x、y 或 z 值对应的线条;
  • "off" - 不显示网格线。
gridlinestyle - 网格线的线型
"-" (默认) | "--" | ":" | "-." | "none"

网格线的线型,指定为下表中的线型之一。

线型 说明 表示的线条
"-" 实线
"--" 虚线
":" 点线
"-." 点划线
"none" 无线条 无线条
gridcolor - 网格线的颜色
[0.00 0.00 0.00] (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4, 0.6, 0.7];
  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0 到 F。 这些值不区分大小写。因此,颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
RGB 三元组 十六进制颜色代码 外观
[1, 0, 0] "#FF0000"
[0, 1, 0] "#00FF00"
[0, 0, 1] "#0000FF"
[0, 1, 1] "#00FFFF"
[1, 0, 1] "#FF00FF"
[1, 1, 0] "#FFFF00"
[0, 0, 0] "#000000"
[1, 1, 1] "#FFFFFF"
"none" 不适用 无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 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"
gridalpha - 网格线透明度
0.15 (默认) | 范围 [0,1] 内的值

网格线透明度,指定为范围 [0,1] 中的值。值为 1 表示不透明,值为 0 表示完全透明。

xminorgrid, yminorgrid - 次网格线
"off" (默认) | "on"/"off"

次网格线,指定为 "on" 或 "off"。 此属性只支持二维轴。

  • "on" - 显示与轴的次刻度线对齐的网格线。不必启用次刻度即可显示次网格线;
  • "off" - 不显示网格线。
minorgridlineStyle - 次网格线的线型
":" (默认) | "-" | "--" | "-." | "none"

次网格线的线型,指定为下表中显示的线型之一。

线型 说明 表示的线条
"-" 实线
"--" 虚线
":" 点线
"-." 点划线
"none" 无线条 无线条
minorgridcolor - 次网格线的颜色
[0.0 0.0 0.0] (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

次网格线的颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4, 0.6, 0.7];
  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0 到 F。 这些值不区分大小写。因此,颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
RGB 三元组 十六进制颜色代码 外观
[1, 0, 0] "#FF0000"
[0, 1, 0] "#00FF00"
[0, 0, 1] "#0000FF"
[0, 1, 1] "#00FFFF"
[1, 0, 1] "#FF00FF"
[1, 1, 0] "#FFFF00"
[0, 0, 0] "#000000"
[1, 1, 1] "#FFFFFF"
"none" 不适用 无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 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"
minorgridalpha - 次网格线的透明度
0.25 (默认) | 范围 [0,1] 内的值

次网格线透明度,指定为范围 [0,1] 中的值。值为 1 表示不透明,值为 0 表示完全透明。

# 标签

title - 标题的文本对象
文本对象

坐标区标题的文本对象。要添加标题,请设置文本对象的 String 属性。要更改标题外观,例如字体样式或字体颜色,请设置其他属性。

xlabel, ylabel, zlabel - 坐标轴标签的文本对象
文本对象

轴标签的文本对象。要添加轴标签,请设置文本对象的 String 属性。要更改标签外观,例如字号,请设置其他属性。

legend - 与坐标区关联的图例
nothing (默认) | legend 对象

此属性为只读。

与 Axes 对象关联的图例,指定为 Legend 对象。要向坐标区中添加图例,请使用 legend 函数。

# 框样式

color - 框样式背景色
[1.0, 1.0, 1.0, 1.0] (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

框样式背景色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。 对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4, 0.6, 0.7];
  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0 到 F。 这些值不区分大小写。因此,颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。
RGB 三元组 十六进制颜色代码 外观
[1, 0, 0] "#FF0000"
[0, 1, 0] "#00FF00"
[0, 0, 1] "#0000FF"
[0, 1, 1] "#00FFFF"
[1, 0, 1] "#FF00FF"
[1, 1, 0] "#FFFF00"
[0, 0, 0] "#000000"
[1, 1, 1] "#FFFFFF"
"none" 不适用 无颜色

以下是 Syslab 在许多类型的绘图中使用的默认颜色的 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"
linewidth - 线条宽度
0.8(默认)| 正值

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值,则线条显示为一个像素的宽度。

box - 框轮廓
"off"(默认)| "on"

框轮廓,指定为 "on" 或 "off"。

说明 二维结果和三维结果
"on" 显示坐标区周围的框轮廓。对于三维视图,可以使用 boxstyle 属性更改轮廓的范围。示例:box(ax,"on")
"off" 不显示坐标区周围的框轮廓。示例:box(ax,"off")

xcolor、ycolor 和 zcolor 属性控制轮廓的颜色。

示例: box(ax,"on")

boxstyle - 框轮廓样式
"back"(默认)| "full"

框轮廓样式,指定为 "back" 或 "full"。此属性仅影响三维视图。

说明 结果
"back" 画出三维框的背板轮廓。示例:ax.set_boxstyle("back")
"full" 画出整个三维框的轮廓。示例:ax.set_boxstyle("full")
clipping - 在坐标区范围内裁剪对象
"off"(默认)| "on"

按照坐标区范围裁剪对象,指定为 "on" 或 "off"。

'on' - 使坐标区内的每个对象基于其 Clipping 属性值控制自身的裁剪行为。

'off' - 禁用坐标区内所有对象的裁剪。

注意

clipping 属性在三维坐标支持的函数为:surf、mesh.

# 位置

position - 大小和位置
四元素向量

大小和位置,不包括标签边距,指定为 [left bottom width height] 形式的四元素向量。

  • left 和 bottom 元素定义从容器(通常为图窗、面板或选项卡)左下角到位置边界左下角之间的距离;

  • width 和 height 元素是位置边界维度。对于三维视图中的坐标区,position 属性是包围坐标区的最小矩形。

# 交互性

visible - 可见性状态
"on" (默认) | "on"/"off"

可见性状态,指定为 "on" 或 "off"

  • "on" - 显示对象;

  • "off" - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

selected - 选择状态
'off' (默认) | "on"/"off"

选择状态,指定为 "on" 或 "off"

  • "on" - 已选择。如果您在绘图编辑模式下点击对象,则 SYSLAB 会将其 selected 属性设置为 "on";

  • "off" - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

# 父级/子级

parent - 父容器
Figure 对象

此属性为只读。 父容器,指定为 Figure 对象。

children - 子级
空数组 | 图形对象的数组

此属性为只读。
子级,以图形对象数组形式返回。axes 没有子级对象返回 [],只有一个子级对象返回子级句柄,多个子级对象返回包含子级句柄的数组。

# 标识符

type - 图形对象的类型
"axes"

此属性为只读。 图形对象的类型,以 "axes" 形式返回。