Main Content

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

setup

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

设置图容器子类的实例

语法

setup(obj)

说明

setup(obj) 设置图的初始状态。它在创建图对象时执行一次。执行 setup 方法后,将对作为名称-值对组参数传递给图的构造函数方法的任何属性进行赋值。

定义此方法以便为类的每个新实例执行初始化代码。例如,您可以使用此方法创建底层图形对象,并设置这些对象的初始属性值。

输入参数

全部展开

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

属性

Abstracttrue
Protectedtrue

要了解方法的属性,请参阅方法属性

示例

全部展开

定义名为 SmoothPlot 的类,该类使用一条蓝色点线和该线条经过平滑处理的版本绘制一组数据。

要定义该类,请创建包含以下类定义的名为 SmoothPlot.m 的文件,该文件具有如下特性:

  • XDataYData 公共属性,用于存储原始线条的 xy 坐标数据。

  • SmoothColorSmoothWidth 公共属性,用于控制平滑线条的颜色和宽度。

  • OriginalLineSmoothLine 私有属性,用于存储原始数据和平滑数据的 Line 对象。

  • 一个 setup 方法,用于初始化 OriginalLineSmoothLine

  • 一个 update 方法,当用户更改属性值时,该方法会更新绘图。

  • 一个 createSmoothData 方法,用于计算 YData 的经过平滑处理的版本。

classdef SmoothPlot < matlab.graphics.chartcontainer.ChartContainer
    properties
        XData (1,:) double = NaN
        YData (1,:) double = NaN
        SmoothColor (1,3) double {mustBeGreaterThanOrEqual(SmoothColor,0),...
            mustBeLessThanOrEqual(SmoothColor,1)} = [0.9290 0.6940 0.1250]
        SmoothWidth (1,1) double = 2
    end
    properties(Access = private,Transient,NonCopyable)
        OriginalLine (1,1) matlab.graphics.chart.primitive.Line
        SmoothLine (1,1) matlab.graphics.chart.primitive.Line
    end
    
    methods(Access = protected)
        function setup(obj)
            % Create the axes
            ax = getAxes(obj);
            
            % Create the original and smooth lines
            obj.OriginalLine = plot(ax,NaN,NaN,'LineStyle',':');
            hold(ax,'on')
            obj.SmoothLine = plot(ax,NaN,NaN);
            hold(ax,'off')
        end
        function update(obj)
            % Update line data
            obj.OriginalLine.XData = obj.XData;
            obj.OriginalLine.YData = obj.YData;
            obj.SmoothLine.XData = obj.XData;
            obj.SmoothLine.YData = createSmoothData(obj);
            
            % Update line color and width
            obj.SmoothLine.Color = obj.SmoothColor;
            obj.SmoothLine.LineWidth = obj.SmoothWidth;
        end
        function sm = createSmoothData(obj)
            % Calculate smoothed data
            v = ones(1,10)*0.1;
            sm = conv(obj.YData,v,'same');
        end
    end
end

接下来,创建一对 xy 向量。调用 ChartContainer 类提供的 SmoothPlot 构造函数方法来绘制 xy。指定 'XData''YData' 名称-值对组参数,并以 c 形式返回对象。

x = 1:1:100;
y = 10*sin(x./5) + 8*sin(10.*x + 0.5);
c = SmoothPlot('XData',x,'YData',y);

使用 c 将平滑线的颜色更改为红色。

c.SmoothColor = [1 0 0];

兼容性考虑

全部展开

R2020a 中的行为有变化

在 R2019b 中推出