Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

getAxes

类: matlab.graphics.chartcontainer.ChartContainer
包: matlab.graphics.chartcontainer

获取图容器子类的坐标区

语法

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 作为第一个参数传递给 plothold 函数,绘制两个线条。在方法的末尾调用 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

局限性

  • 对坐标区设置 OuterPositonInnerPositionPositionPositionConstraint 属性可能产生意外的结果。在这种情况下,请对图的实例配置位置。

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

兼容性考虑

全部展开

R2020a 中的行为有变化

在 R2019b 中推出