GeographicAxes 属性

要在其上绘制数据的地图，指定为下表中列出的值之一。有六幅底图是使用 Natural Earth 创建的图块化数据集。其中五个底图是由 Esri^® 托管的高缩放级别地图。

除 'darkwater' 外，所有底图都需要 Internet 访问权限。'darkwater' 底图包含在 MATLAB 中。

如果您不能随时访问 Internet，可使用附加功能资源管理器将使用 Natural Earth 创建的底图下载到您的本地系统上。这五个高缩放级别的地图无法下载。有关下载底图和更改本地系统上默认底图的详细信息，请参阅访问用于地理坐标区和地理图的底图。

由 Esri 托管的底图会周期性更新。因此，随着时间的推移，您可能会看到可视化出现差异。

边界和区域标签的对齐是数据供应商提供的功能的展示，并不意味着 MathWorks^® 对此做出背书。

地图的纬度范围，返回为 [latmin latmax] 形式的二元素向量。每个元素都在 [-90, 90] 度范围内。

使用 geolimits 函数更改纬度范围。

当您通过调整图窗窗口的大小来调整坐标区的大小时，纬度范围不会改变，除非是为了适应地图纵横比的变化。

示例: [-85 85]

地图的经度范围，返回为 [lonmin lonmax] 形式的二元素向量。

使用 geolimits 函数更改经度范围。

当您通过调整图窗窗口的大小来调整坐标区的大小时，经度范围不会改变，除非是为了适应地图纵横比的变化。

示例: [-100 100]

以纬度和经度表示的地图中心点，指定为 [center_latitude center_longitude] 形式的二元素有限实数值向量。

示例: [38.6292 -95.2520]

地图中心的选择模式，指定为下列值之一：

示例: gx.MapCenterMode = 'auto'

地图的放大级别，指定为从 0 到 25（包括 0 和 25）的有限实数数值标量。该值是以 2 为底的对数地图缩放比例。ZoomLevel 的值增加 1，地图缩放比例将翻倍。

缩放级别的选择模式，指定为下列值之一：

示例: gx.ZoomLevelMode = 'manual'

比例尺，以 GeographicScalebar 对象形式返回。比例尺显示地图上的比例距离。

通过设置 GeographicScalebar 对象的属性来更改比例尺的外观和行为。例如，以下代码显示如何隐藏比例尺。

geoplot(1:10,1:10)
gx = gca;
gx.Scalebar.Visible = "off";

有关 GeographicScalebar 对象属性的详细信息，请参阅 GeographicScalebar 属性。

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

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

字体大小，指定为数值标量。字体大小会影响标题、刻度标签和比例尺，以及与坐标区相关联的任何图例或颜色栏。默认字体大小取决于具体操作系统和区域设置。默认情况下，坐标区对象以磅为单位度量字体大小。要更改单位，请设置 FontUnits 属性。

MATLAB 会自动将某些文本缩放为坐标区字体大小的百分比。

字体大小的选择模式，指定为下列值之一：

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

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

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

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

标签字体大小的缩放因子，指定为大于 0 的数值。此缩放因子应用于 FontSize 属性的值，以确定标签的字体大小。

示例: gx.LabelFontSizeMultiplier = 1.75

标题字体大小的缩放因子，指定为大于 0 的数值。此缩放因子应用于 FontSize 属性的值，以确定标题的字体大小。

标题字符的粗细，指定为下列值之一：

副标题字符粗细，指定为下列值之一：

字体大小单位，指定为下列值之一。

要在同一个函数调用中设置字体大小和字体单位，必须先设置 FontUnits 属性，以便 Axes 对象能够正确解释指定的字体大小。

刻度线方向，指定为下列值之一：

由 TickDir 属性设置的刻度线方向的选择模式，指定为下列值之一。

示例: gx.TickDirMode = 'auto';

刻度线长度，指定为 [length unused] 形式的二元素向量。length 是刻度线长度。指定值时采用的是以坐标区最长维度为基准的归一化单位。GeographicRuler 对象使用一个二元素向量来与其他标尺对象中此属性的值保持一致，但不使用第二个元素。

示例: gx.TickLength = [0.02 0.0];

刻度标签格式，指定为下列选项之一：

默认刻度标签格式包括度、分和秒。但是，仅当 ZoomLevel 属性大于或等于 14 时，坐标区才会显示分和秒。

纬度标尺，指定为 GeographicRuler 对象。使用 GeographicRuler 对象的属性来控制轴标尺的外观和行为。有关详细信息，请参阅 GeographicRuler 属性。

此图以红色显示纬度轴线。

示例: latruler = gx.LatitudeAxis;

示例: gx.LatitudeAxis.TickLabelRotation = 45;

经度标尺，指定为 GeographicRuler 对象。使用 GeographicRuler 对象的属性来控制轴标尺的外观和行为。有关详细信息，请参阅 GeographicRuler 属性。

此图以红色显示经度轴线。

示例: lonruler = gx.LongitudeAxis;

示例: gx.LongitudeAxis.TickDirection = 'out';

轴线、刻度值和标签的颜色，指定为 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)) 获取十六进制颜色代码。

示例: gx.AxisColor = [0 0 1];

示例: gx.AxisColor = 'b';

示例: gx.AxisColor = 'blue';

示例: gx.AxisColor = '#0000FF';

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

示例: gx.Grid = 'off';

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

要显示网格线，请使用 grid on 命令或将 Grid 属性设置为 'on'。

示例: gx.GridLineStyle = '--'

网格线的颜色，指定为 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)) 获取十六进制颜色代码。

例如，创建一个具有红色网格线的地理轴对象。将 GridAlpha 属性设置为 0.5 以增加可见性。

gx = geoaxes;
gx.GridColor = 'r';
gx.GridAlpha = 0.5;

示例: gx.GridColor = [0 0 1];

示例: gx.GridColor = 'b';

示例: gx.GridColor = 'blue';

示例: gx.GridColor = '#0000FF';

用于设置网格颜色的属性，指定为下列值之一：

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

示例: gx.GridAlpha = 0.5

GridAlpha 属性的选择模式，指定为下列值之一：

示例: gx.GridAlphaMode = 'auto'

坐标区标题的文本对象。要添加标题，请设置文本对象的 String 属性。要更改标题外观，例如字体样式或字体颜色，请设置其他属性。有关完整列表，请参阅 Text 属性。

ax = gca;
ax.Title.String = 'My Title';
ax.Title.FontWeight = 'normal';

也可以使用 title 函数添加标题并控制外观。

title('My Title','FontWeight','normal')

坐标区副标题的文本对象。要添加副标题，请设置文本对象的 String 属性。要更改其外观，如字体角度，请设置其他属性。有关完整列表，请参阅 Text 属性。

ax = gca;
ax.Subtitle.String = 'An Insightful Subtitle';
ax.Subtitle.FontAngle = 'italic';

也可以使用 subtitle 函数添加副标题并控制外观。

subtitle('An Insightful Subtitle','FontAngle','italic')

或者使用 title 函数，指定两个字符向量输入参量和两个输出参量。然后设置该函数返回的第二个文本对象的属性。

[t,s] = title('Clever Title','An Insightful Subtitle');
s.FontAngle = 'italic';

标题和副标题与图框水平对齐，指定为下表中的值之一。

纬度轴标签，指定为 Text 对象。要指定标签，请设置 Text 对象的 String 属性。要更改标签外观，例如字体样式或字体颜色，请设置其他 Text 对象属性。有关完整的属性列表，请参阅 Text 属性。

示例: gx.LatitudeLabel.String = 'My Latitude'

经度轴标签，指定为 Text 对象。要指定标签，请设置 Text 对象的 String 属性。要更改标签外观，例如字体样式或字体颜色，请设置其他 Text 对象属性。有关完整的属性列表，请参阅 Text 属性。

示例: gx.LongitudeLabel.String = 'My Longitude'

与地理坐标区关联的图例，指定为 Legend 对象。要向地理坐标区中添加图例，请使用 legend 函数。然后，您可以使用此属性修改图例。有关完整的属性列表，请参阅 Legend 属性。

geoplot(rand(3))
legend({'Line 1','Line 2','Line 3'},'FontSize',12)
gx = gca;
gx.Legend.TextColor = 'red';

还可以使用此属性确定地理坐标区是否包含图例。

gx = gca;
lgd = gx.Legend
if ~isempty(lgd)
    disp('Legend Exists')
end

色序，指定为由 RGB 三元组组成的三列矩阵。此属性定义 MATLAB 创建绘图对象（例如 Line、Scatter 和 Bar 对象）时使用的颜色的调色板。数组的每一行都是一个 RGB 三元组。RGB 三元组是包含三个元素的向量，其元素分别指定颜色的红、绿、蓝分量的强度。强度必须在 [0, 1] 范围内。下表列出了默认颜色。

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

您可以使用 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)) 获取十六进制颜色代码。

MATLAB 根据对象的创建顺序为对象分配颜色。例如，在绘制线条时，第一条线用第一种颜色，第二条线用第二种颜色，以此类推。如果线条比颜色多，则循环使用颜色。

在绘图之前或之后更改色序

您可以通过下列任一方式更改色序：

线型序列，指定为字符向量、字符向量元胞数组或字符串数组。此属性列出了 MATLAB 在坐标区中显示多个绘图线条时使用的线型。MATLAB 根据创建线条的顺序为它们分配线型。默认情况下，只有在对当前线型用尽 ColorOrder 属性中的所有颜色后，它才会开始使用下一线型。将 LineStyleCyclingMethod 属性设置为 "withcolor" 会同时循环使用两者，设置为 "beforecolor" 会首先循环使用线型。默认的 LineStyleOrder 只有一个线型 "-"。

要自定义线型序列，请创建一个字符向量元胞数组或字符串数组。将数组的每个元素指定为下列各表中的一个线条设定符或标记设定符。您可以在一个元素中组合使用线型和标记设定符，如 "-*"。

在绘图之前或之后更改线型序列

您可以在坐标区中绘图之前或之后更改线型序列。当 LineStyleOrder 属性设置为新值时，MATLAB 会更新坐标区中所有线条的线型。如果继续在坐标区中绘图，绘图命令会继续使用更新后的列表中的线型。

当坐标区中有多条线时如何循环使用线型，指定为下表中的值之一。

下表中的示例是使用 ColorOrder 属性中的默认颜色和 LineStyleOrder 属性中的三种线型 (["-","-o","--"]) 创建的。

添加到坐标区的下一个绘图对象的 SeriesIndex 值，以大于或等于 0 的整数形式返回。当您要跟踪对象如何循环使用颜色和线型时，此属性非常有用。此属性维护坐标区中具有数值 SeriesIndex 属性值的对象的计数。MATLAB 使用它为每个新对象分配 SeriesIndex 值。计数在创建坐标区时从 1 开始，每增加一个对象，计数就会增加 1。因此，该计数通常是 n+1，其中 n 是坐标区中对象的数量。

如果您手动更改 ColorOrderIndex 或坐标区上的 LineStyleOrderIndex 属性，NextSeriesIndex 属性的值将更改为 0。因此，当您更改坐标区上的 ColorOrder 或 LineStyleOrder 属性时，具有 SeriesIndex 属性的对象不再自动更新。

在向坐标区中添加新绘图时要重置的属性，指定为下列值之一：

图窗对象还有一个 NextPlot 属性。也可以使用 newplot 函数准备图窗和坐标区，以执行后续的图形命令。

渲染对象的顺序，指定为下列值之一：

色序索引，指定为正整数。此属性指定当 MATLAB 创建下一个绘图对象（例如 Line、Scatter 或 Bar 对象）时从坐标区 ColorOrder 属性中选择的下一个颜色。

线型序列索引，指定为正整数。此属性指定 MATLAB 在创建下一个绘图线条时从坐标区 LineStyleOrder 属性中选择的下一个线型。

颜色图，指定为由 RGB（红色、绿色、蓝色）三元组组成的 m×3 数组，这些三元组定义 m 种单独的颜色。

示例: ax.Colormap = [1 0 1; 0 0 1; 1 1 0] 将颜色图设置为三种颜色：品红色、蓝色和黄色。

MATLAB 按行号访问这些颜色。

也可以使用 colormap 函数更改颜色图。

颜色图的刻度，指定为下列值之一：

颜色图的颜色范围，指定为 [cmin cmax] 形式的二元素向量。

如果关联的模式属性设置为 'auto'，则 MATLAB 将自动选择颜色范围。如果您向该属性分配值，则 MATLAB 会将模式设置为 'manual'，且不会自动选择颜色范围。

CLim 属性的选择模式，指定为下列值之一：

透明度图，指定为从 0 到 1 线性递增的有限 alpha 值组成的数组。数组大小可以是 m×1 或 1×m。MATLAB 按 alpha 值在数组中的索引访问来它们。Alphamap 可以为任意长度。

透明度图的刻度，指定为下列值之一：

alphamap 的 alpha 范围，指定为 [amin amax] 形式的二元素向量。

如果关联的模式属性设置为 'auto'，则 MATLAB 将自动选择 alpha 范围。如果您设置该属性，则 MATLAB 将模式设置为 'manual'，且不会自动选择 alpha 范围。

ALim 属性的选择模式，指定为下列值之一：

背景颜色，指定为 RGB 三元组、十六进制颜色代码、颜色名称或颜色短名称。仅当 Basemap 属性设置为 'none' 时，背景色才可见。

对于自定义颜色，请指定 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)) 获取十六进制颜色代码。

示例: gx.Color = [0 0 1];

示例: gx.Color = 'b';

示例: gx.Color = 'blue';

示例: gx.Color = '#0000FF';

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

示例: gx.LineWidth = 1.5

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

此图像显示一个地理坐标区对象，其 Box 属性设置为 'off'。请注意，沿坐标区的顶部边框或右边框没有轮廓线。

示例: gx.Box = 'off'

大小和位置，包括标签和边距，指定为 [left bottom width height] 形式的四元素向量。默认情况下，MATLAB 按照归一化的容器单位来测量值。要更改单位，请设置 Units 属性。[0 0 1 1] 的默认值包括容器的整个内部。

以下图窗显示由 OuterPosition 值（蓝色）和 Position 值（红色）定义的区域。

内部大小和位置，指定为 [left bottom width height] 形式的四元素向量。此属性等同于 Position 属性。

大小和位置，不包括标签边距，指定为 [left bottom width height] 形式的四元素向量。默认情况下，MATLAB 按照归一化的容器单位来测量值。要更改单位，请设置 Units 属性。

如果要指定位置并考虑让文本围绕坐标区，请改为设置 OuterPosition 属性。以下图窗显示由 OuterPosition 值（蓝色）和 Position 值（红色）定义的区域。

文本标签的边距，以 [left bottom right top] 形式的四元素向量返回。此属性是只读的。

这些元素定义 Position 属性的边界和地理坐标区文本标签及标题的范围之间的距离。默认情况下，这些值使用归一化的图窗或 uipanel（包含地理坐标区）单位进行测量。要更改单位，请设置 Units 属性。

Position 属性和 TightInset 属性定义包围地理坐标区及其标签和标题的最紧凑边界框。

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

位置单位，指定为下列值之一：

在对象创建过程中使用名称-值参量指定单位时，您必须先设置 Units 属性，然后再指定要使用这些单位的属性（如 Position）。

布局选项，指定为 TiledChartLayoutOptions 或 GridLayoutOptions 对象。当坐标区对象位于分块图布局或网格布局中时，此属性非常有用。

要在分块图布局的网格中定位坐标区，请设置 TiledChartLayoutOptions 对象的 Tile 和 TileSpan 属性。例如，假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格，外边缘四周各有一个图块。实际上，该网格不可见，外侧图块也不占用空间，除非您用坐标区或图填充它们。

以下代码将坐标区 ax 放置在网格的第三个图块中。

ax.Layout.Tile = 3;

要使坐标区占据多个图块，请将 TileSpan 属性指定为二元素向量。例如，此坐标区占据了 2 行和 3 列的图块。

ax.Layout.TileSpan = [2 3];

要将坐标区放置在四周的某个图块中，请将 Tile 属性指定为 'north'、'south'、'east' 或 'west'。例如，将值设置为 'east' 会将坐标区放置在网格右侧的图块中。

ax.Layout.Tile = 'east';

要将坐标区放入 App 内的布局中，请将此属性指定为 GridLayoutOptions 对象。有关在 App 中使用网格布局的详细信息，请参阅 uigridlayout。

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

自定义交互行为的选项，指定为 GeographicAxesInteractionOptions 对象。使用 GeographicAxesInteractionOptions 对象的属性自定义与地理坐标区的交互行为。有关完整的属性列表，请参阅 GeographicAxesInteractionOptions Properties。

GeographicAxesInteractionOptions 对象设置的选项适用于相关联的地理坐标区上的以下交互：

示例: gx.InteractionOptions.ZoomSupported = "off" 禁用缩放交互。

数据探索工具栏，指定为 AxesToolbar 对象。将鼠标悬停在地理坐标区上时，工具栏会显示在坐标区的右上角。通过工具栏可快速访问数据探索工具，如缩放、还原视图和数据提示。

如果您不希望在将鼠标悬停在地理坐标区上时显示工具栏，请将 AxesToolbar 对象的 Visible 属性设置为 'off'。有关 AxesToolbar 对象属性的详细信息，请参阅 AxesToolbar 属性。

示例: gx.Toolbar.Visible = 'off'

交互，指定为 PanInteraction、ZoomInteraction 或 DataTipInteraction 对象组成的数组或指定为空数组。可以通过手势在图中使用您指定的交互。您不必选择任何坐标区工具栏按钮即可使用它们。例如，可以通过 PanInteraction 对象在图中拖动以进行平移。有关交互对象的列表，请参阅对图的交互进行控制。

默认情况下，地理坐标区内的图支持平移、缩放和数据提示交互。您可以将默认集替换为新的交互集，但不能访问或修改默认集中的任何交互。例如，以下代码用 PanInteraction 和 ZoomInteraction 对象替换默认交互集。

gx = gca;
gx.Interactions = [panInteraction zoomInteraction];

要暂时禁用当前交互集，请调用 disableDefaultInteractivity 函数。您可以通过调用 enableDefaultInteractivity 函数来重新启用它们。要从坐标区中删除所有鼠标交互，请将此属性设置为空数组。

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

鼠标指针的位置，指定为以下形式的 2×3 数组：

[lat lon 0
 lat lon 0]

CurrentPoint 属性包含鼠标指针关于地理坐标区的纬度 (lat) 和经度 (lon) 坐标。(lat,lon) 点指示上一次鼠标点击的位置。但是，如果图窗定义了 WindowButtonMotionFcn 回调，则 (lat,lon) 点指示鼠标指针最后所在的位置。

返回值的格式与 Axes 对象的 CurrentPoint 属性的返回值一致。对于地理坐标区，返回值的第三列始终为零。第二行中的纬度和经度值与第一行中的值重复。

示例: [52.1411 -125.1167 0; 52.1411 -125.1167 0]

上下文菜单，指定为 ContextMenu 对象。使用此属性在您右键点击对象时显示上下文菜单。使用 uicontextmenu 函数创建上下文菜单。

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

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

鼠标点击回调，指定为下列值之一：

使用此属性在您点击对象时执行代码。如果使用函数句柄指定此属性，则 MATLAB 在执行回调时将向回调函数传递两个参量：

有关如何使用函数句柄定义回调函数的详细信息，请参阅Create Callbacks for Graphics Objects。

对象创建函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定要在 MATLAB 创建对象时执行的回调函数。MATLAB 将在执行 CreateFcn 回调之前初始化所有属性值。如果不指定 CreateFcn 属性，则 MATLAB 执行默认的创建函数。

对现有组件设置 CreateFcn 属性没有任何作用。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参量访问正在创建的对象。否则，使用 gcbo 函数访问该对象。

对象删除函数，指定为下列值之一：

有关将回调指定为函数句柄、元胞数组或字符向量的详细信息，请参阅Create Callbacks for Graphics Objects。

此属性指定在 MATLAB 删除对象时要执行的回调函数。MATLAB 在销毁对象的属性之前执行 DeleteFcn 回调。如果不指定 DeleteFcn 属性，则 MATLAB 执行默认的删除函数。

如果将此属性指定为函数句柄或元胞数组，则可以使用回调函数的第一个参量访问要删除的对象。否则，使用 gcbo 函数访问该对象。

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

此属性确定是否可以中断运行中回调。有以下两种回调状态要考虑：

每次执行处理回调队列的命令时，MATLAB 都会确定回调中断行为。这些命令包括 drawnow、figure、uifigure、getframe、waitfor 和 pause。

如果运行中回调不包含上述命令之一，则不会发生中断。MATLAB 首先完成执行运行中回调，然后执行中断回调。

如果运行中回调确实包含上述命令之一，则由运行中回调所属对象的 Interruptible 属性来确定是否发生中断：

回调排队，指定为 'queue' 或 'cancel'。BusyAction 属性决定 MATLAB 如何处理中断回调的执行。有以下两种回调状态要考虑：

BusyAction 属性仅在同时满足以下两个条件时才确定回调排队行为：

在这些情况下，由中断回调所属对象的 BusyAction 属性确定 MATLAB 如何处理中断回调。以下是 BusyAction 属性的可能值：

捕获鼠标点击的能力，指定为以下值之一：

如果希望某个对象在其位于其他不需要点击的对象下方时可点击，请将其他对象的 PickableParts 属性设置为 'none' 以使点击穿过它们。

对捕获的鼠标点击的响应，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

删除状态，以 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值形式返回。

当 DeleteFcn 回调开始执行时，MATLAB 会将 BeingDeleted 属性设置为 'on'。BeingDeleted 属性将一直保持 'on' 设置状态，直到组件对象不再存在为止。

在查询或修改对象之前，请先检查其 BeingDeleted 属性的值，以确认它不是待删除项。

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

子级，以图形对象数组形式返回。使用该属性可查看子级列表，或重新排列子级顺序（通过将该属性设置为自身的置换来完成）。

不能使用 Children 属性添加或删除子级。要向此列表中添加子级，请将子图形对象的 Parent 属性设置为 GeographicAxes 对象。

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

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

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

图形对象的类型，以 'geoaxes' 形式返回。

对象标识符，指定为字符向量或字符串标量。您可以指定唯一的 Tag 值作为对象的标识符。如果需要访问您代码中其他位置的对象，可以使用 findobj 函数基于 Tag 值搜索对象。

用户数据，指定为任何 MATLAB 数组。例如，您可以指定标量、向量、矩阵、元胞数组、字符数组、表或结构体。使用此属性存储对象上的任意数据。

如果您在 App 设计工具中工作，请在该 App 中创建公共或私有属性以共享数据，而不是使用 UserData 属性。有关详细信息，请参阅在用 App 设计工具创建的 App 内共享数据。