Main Content

getAxes

类: matlab.graphics.chartcontainer.ChartContainer
命名空间: matlab.graphics.chartcontainer

获取图容器子类的坐标区

自 R2019b 起

全页展开

语法

ax = getAxes(obj)

说明

ax = getAxes(obj) 为从 matlab.graphics.chartcontainer.ChartContainer 基类继承的图返回一个或多个坐标区对象。

输入参数

全部展开

从 matlab.graphics.chartcontainer.ChartContainer 基类继承的类的对象。

输出参量

全部展开

坐标区对象，或坐标区对象组成的数组。当您在类定义中调用绘图函数时，ax 的内容对于指定目标坐标区很有用。您还可以使用 ax 对坐标区设置属性。

根据图的内容，ax 可以是标量坐标区对象，也可以是坐标区对象组成的数组：

  • 如果图尚未包含坐标区对象，getAxes 会创建笛卡尔坐标区，并将其以 ax 形式返回。

  • 如果图包含一个笛卡尔、极坐标或地理坐标区对象，ax 将以该对象形式返回。

  • 如果图包含多个坐标区对象，则 ax 是一个由这些对象组成的数组。

getAxes 仅返回笛卡尔、极坐标或地理坐标区对象。它不返回作为 TiledChartLayout 的子级的其他类型的对象。

属性

Protectedtrue

要了解方法的属性，请参阅方法属性。

示例

全部展开

通常通过 setup 方法来调用绘图函数和设置坐标区的保留状态。在这两种情况下，您都必须指定目标坐标区。

在类定义文件中创建 setup 方法。在该方法中，调用 getAxes 以获取坐标区对象 ax。然后通过将 ax 作为第一个参量传递给 plot 和 hold 函数，绘制两个线条。在方法的末尾调用 hold(ax,'off')。

classdef TwoLinesPlot < matlab.graphics.chartcontainer.ChartContainer
    
    properties
        % ...
    end
    
    methods(Access = protected)
        function setup(obj)
            % Get the axes
            ax = getAxes(obj);
            
            % Plot two lines in the axes
            line1 = plot(ax,[1 2 3 4 5],[3 5 1 4 9]);
            hold(ax,'on')
            line2 = plot(ax,[1 2 3 4 5],[30 52 21 9 18]);
            
            % Turn off hold state
            hold(ax,'off')
        end
        function update(obj)
            % ...
        end
    end
end

在您的类定义文件中定义 setup 方法。在该方法中，调用 getAxes 以获取坐标区对象 ax。然后设置 x 轴的颜色和坐标区的字体角度。在调用任何绘图函数之前调用 hold(ax,'on')。然后在方法的末尾调用 hold(ax,'off')。

classdef RedAxisPlot < matlab.graphics.chartcontainer.ChartContainer
    
    properties
        % ...
    end
    
    methods(Access = protected)
        function setup(obj)
            ax = getAxes(obj);
            ax.XColor = [1 0 0];
            ax.FontAngle = 'italic';
            hold(ax,'on')
            
            % Call plotting functions
            % ...
            
            hold(ax,'off')
        end
        function update(obj)
            % ...
        end
    end
end

局限性

  • 对坐标区设置 OuterPositon、InnerPosition、Position 或 PositionConstraint 属性可能产生意外的结果。在这种情况下，请对图的实例配置位置。

  • 不推荐更改坐标区的 Parent 属性。更好的做法是，对图的实例指定 Parent 属性。

版本历史记录

在 R2019b 中推出

全部展开

另请参阅

类

属性

主题