GeographicScalebar 属性
地理比例尺的外观和行为
GeographicScalebar 属性控制存储在 GeographicAxes 或 MapAxes (Mapping Toolbox™) 对象中的 GeographicScalebar 对象的外观和行为。
通过更改属性值，您可以修改该比例尺的特定方面。使用 GeographicAxes 或 MapAxes 对象的 Scalebar 属性访问 GeographicScalebar 对象。使用圆点表示法查询和设置属性。
geoplot(1:10,1:10) gx = gca; v = gx.Scalebar.Visible; gx.Scalebar.Visible = "off";
外观
背景透明度，指定为范围 [0, 1] 内的值。值为 1 表示不透明，值为 0 表示透明。
示例: gx.Scalebar.BackgroundAlpha = 0.2;
背景颜色，指定为 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)) 获取十六进制颜色代码。
示例: gx.Scalebar.BackgroundColor = [0 0 1];
示例: gx.Scalebar.BackgroundColor = "b";
示例: gx.Scalebar.BackgroundColor = "none";
示例: gx.Scalebar.BackgroundColor = "#0000FF";
线条颜色，指定为 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)) 获取十六进制颜色代码。
注意
设置父坐标区的属性会影响比例尺。
当父级是地理坐标区时，设置坐标区的
AxisColor属性会将比例尺的EdgeColor属性设置为相同的值。当父级是地图坐标区时，设置坐标区的
OutlineColor属性会将比例尺的EdgeColor属性设置为相同的值。
但是，设置比例尺的属性不会影响父坐标区。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.EdgeColor = "b";
示例: gx.Scalebar.EdgeColor = "blue";
示例: gx.Scalebar.EdgeColor = [0 0 1];
示例: gx.Scalebar.EdgeColor = "#0000FF";
线条宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。
注意
设置父坐标区的 LineWidth 属性会将比例尺的 LineWidth 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.LineWidth = 2;
字体
字体名称，指定为支持的字体名称或 'FixedWidth'。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。
要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 'FixedWidth'。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。
注意
设置父坐标区的 FontName 属性会将比例尺的 FontName 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.FontName = "Cambria";
字体大小，指定为数值标量。
注意
设置父坐标区的 FontSize 属性会将比例尺的 FontSize 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
当使用存储在父坐标区中的字体大小时，比例尺将字体大小缩放到坐标区字体大小的 80%。
示例: gx.Scalebar.FontSize = 12;
字符粗细，指定为 'normal' 或 'bold'。
MATLAB® 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。
注意
设置父坐标区的 FontWeight 属性会将比例尺的 FontWeight 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.FontWeight = "bold";
字体颜色，指定为 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)) 获取十六进制颜色代码。
注意
设置父坐标区的属性会影响比例尺。
当父级是地理坐标区时，设置坐标区的
AxisColor属性会将比例尺的FontColor属性设置为相同的值。当父级是地图坐标区时，设置坐标区的
FontColor属性会将比例尺的FontColor属性设置为相同的值。
但是，设置比例尺的属性不会影响父坐标区。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.FontColor = "b";
示例: gx.Scalebar.FontColor = "blue";
示例: gx.Scalebar.FontColor = [0 0 1];
示例: gx.Scalebar.FontColor = "#0000FF";
字符倾斜，指定为 'normal' 或 'italic'。
并非所有字体都有两种字体样式。因此，斜体可能看上去和常规字体一样。
注意
设置父坐标区的 FontAngle 属性会将比例尺的 FontAngle 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。
示例: gx.Scalebar.FontAngle = "italic";
字体平滑处理，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。
'on'- 使用抗锯齿功能使文本在屏幕上看上去更平滑。'off'- 不使用抗锯齿功能。在文本看似模糊时使用此设置。
注意
FontSmoothing 属性在以后的版本中将不起作用。无论该属性的值如何，都将启用字体平滑处理。
示例: gx.Scalebar.FontSmoothing = "off";
