GeographicScalebar 属性

控制地理比例尺的外观和行为

自 R2019a 起

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";

外观

全部展开

`BackgroundAlpha` — 背景透明度
`0.45` （默认） | 范围 [0, 1] 内的值

背景透明度，指定为范围 [0, 1] 内的值。值为 1 表示不透明，值为 0 表示透明。

示例： gx.Scalebar.BackgroundAlpha = 0.2;

`BackgroundColor` — 背景色
`[1 1 1]` （默认） | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

背景颜色，指定为 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"`	不适用	不适用	不适用	无颜色

以下是 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"`

示例： gx.Scalebar.BackgroundColor = [0 0 1];

示例： gx.Scalebar.BackgroundColor = "b";

示例： gx.Scalebar.BackgroundColor = "none";

示例： gx.Scalebar.BackgroundColor = "#0000FF";

`EdgeColor` — 线条颜色
`[0.15 0.15 0.15]` （默认） | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

线条颜色，指定为 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"`	不适用	不适用	不适用	无颜色

以下是 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"`

注意

设置父坐标区的属性会影响比例尺。

当父级是地理坐标区时，设置坐标区的 AxisColor 属性会将比例尺的 EdgeColor 属性设置为相同的值。
当父级是地图坐标区时，设置坐标区的 OutlineColor 属性会将比例尺的 EdgeColor 属性设置为相同的值。

但是，设置比例尺的属性不会影响父坐标区。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.EdgeColor = "b";

示例： gx.Scalebar.EdgeColor = "blue";

示例： gx.Scalebar.EdgeColor = [0 0 1];

示例： gx.Scalebar.EdgeColor = "#0000FF";

`LineWidth` — 线条宽度
`0.5` （默认） | 正值

线条宽度，指定为以磅为单位的正值。一磅等于 1/72 英寸。

注意

设置父坐标区的 LineWidth 属性会将比例尺的 LineWidth 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.LineWidth = 2;

`Visible` — 可见性状态
`'on'` （默认） | on/off 逻辑值

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

'on' - 显示对象。
'off' - 隐藏对象而不删除它。您仍然可以访问不可见对象的属性。

字体

全部展开

`FontName` — 字体名称
支持的字体名称 | `'FixedWidth'`

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

要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 'FixedWidth'。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

注意

设置父坐标区的 FontName 属性会将比例尺的 FontName 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.FontName = "Cambria";

`FontSize` — 字体大小
`8` （默认） | 数值标量

字体大小，指定为数值标量。

注意

设置父坐标区的 FontSize 属性会将比例尺的 FontSize 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

当使用存储在父坐标区中的字体大小时，比例尺将字体大小缩放到坐标区字体大小的 80%。

示例： gx.Scalebar.FontSize = 12;

`FontWeight` — 字符粗细
`'normal'` （默认） | `'bold'`

字符粗细，指定为 'normal' 或 'bold'。

MATLAB 使用 FontWeight 属性从系统提供的字体中选择一种字体。并非所有字体都有加粗字体。因此，指定加粗字体仍可能得到普通字体。

注意

设置父坐标区的 FontWeight 属性会将比例尺的 FontWeight 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.FontWeight = "bold";

`FontColor` — 字体颜色
`[0.15 0.15 0.15]` （默认） | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

字体颜色，指定为 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"`	不适用	不适用	不适用	无颜色

以下是 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"`

注意

设置父坐标区的属性会影响比例尺。

当父级是地理坐标区时，设置坐标区的 AxisColor 属性会将比例尺的 FontColor 属性设置为相同的值。
当父级是地图坐标区时，设置坐标区的 FontColor 属性会将比例尺的 FontColor 属性设置为相同的值。

但是，设置比例尺的属性不会影响父坐标区。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.FontColor = "b";

示例： gx.Scalebar.FontColor = "blue";

示例： gx.Scalebar.FontColor = [0 0 1];

示例： gx.Scalebar.FontColor = "#0000FF";

`FontAngle` — 字符倾斜
`'normal'` （默认） | `'italic'`

字符倾斜，指定为 'normal' 或 'italic'。

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

注意

设置父坐标区的 FontAngle 属性会将比例尺的 FontAngle 属性设置为相同的值。但是，设置比例尺属性不会设置坐标区属性。要防止坐标区属性值覆盖比例尺值，请先设置坐标区属性值，然后设置比例尺属性值。

示例： gx.Scalebar.FontAngle = "italic";

`FontSmoothing` — 字体平滑处理
`'on'` （默认） | on/off 逻辑值

字体平滑处理，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

'on' - 使用消除锯齿功能使文本在屏幕上看上去更平滑。
'off' - 不使用消除锯齿功能。在文本看似模糊时使用此设置。

注意

FontSmoothing 属性在以后的版本中将不起作用。无论该属性的值如何，都将启用字体平滑处理。

示例： gx.Scalebar.FontSmoothing = "off";

父级/子级

全部展开

`Parent` — 父级
`GeographicAxes` 对象 | `MapAxes` 对象

此属性为只读。

父级，指定为 GeographicAxes 对象或 MapAxes 对象。

注意

比例尺对象未在父对象的 Children 属性中列出。

`Children` — 子级
空 `GraphicsPlaceholder` 数组

此属性为只读。

比例尺对象没有子级。

版本历史记录

在 R2019a 中推出

全部展开

R2022a: `FontSmoothing` 属性在以后的版本中将不起作用

FontSmoothing 属性在以后的版本中将不起作用。无论该属性的值如何，都将启用字体平滑处理。

另请参阅

属性

GeographicAxes 属性 | MapAxes Properties (Mapping Toolbox)

GeographicScalebar 属性

外观

BackgroundAlpha — 背景透明度 0.45 （默认） | 范围 [0, 1] 内的值

BackgroundColor — 背景色 [1 1 1] （默认） | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

EdgeColor — 线条颜色 [0.15 0.15 0.15] （默认） | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

LineWidth — 线条宽度 0.5 （默认） | 正值

Visible — 可见性状态 'on' （默认） | on/off 逻辑值

字体

FontName — 字体名称 支持的字体名称 | 'FixedWidth'

FontSize — 字体大小 8 （默认） | 数值标量

FontWeight — 字符粗细 'normal' （默认） | 'bold'

FontColor — 字体颜色 [0.15 0.15 0.15] （默认） | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

FontAngle — 字符倾斜 'normal' （默认） | 'italic'

FontSmoothing — 字体平滑处理 'on' （默认） | on/off 逻辑值

父级/子级

Parent — 父级 GeographicAxes 对象 | MapAxes 对象

Children — 子级 空 GraphicsPlaceholder 数组

版本历史记录

R2022a: FontSmoothing 属性在以后的版本中将不起作用

另请参阅

属性

WeChat

`BackgroundAlpha` — 背景透明度
`0.45` （默认） | 范围 [0, 1] 内的值

`BackgroundColor` — 背景色
`[1 1 1]` （默认） | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

`EdgeColor` — 线条颜色
`[0.15 0.15 0.15]` （默认） | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

`LineWidth` — 线条宽度
`0.5` （默认） | 正值

`Visible` — 可见性状态
`'on'` （默认） | on/off 逻辑值

`FontName` — 字体名称
支持的字体名称 | `'FixedWidth'`

`FontSize` — 字体大小
`8` （默认） | 数值标量

`FontWeight` — 字符粗细
`'normal'` （默认） | `'bold'`

`FontColor` — 字体颜色
`[0.15 0.15 0.15]` （默认） | RGB 三元组 | 十六进制颜色代码 | `'r'` | `'g'` | `'b'` | ...

`FontAngle` — 字符倾斜
`'normal'` （默认） | `'italic'`

`FontSmoothing` — 字体平滑处理
`'on'` （默认） | on/off 逻辑值

`Parent` — 父级
`GeographicAxes` 对象 | `MapAxes` 对象

`Children` — 子级
空 `GraphicsPlaceholder` 数组

R2022a: `FontSmoothing` 属性在以后的版本中将不起作用