Документация

Interface Properties и методы

Класс graph задает следующие свойства, которые должны задать подклассы:

Имена классов GraphInterface три абстрактных метода, которые должны реализовать подклассы. Класс GraphInterface также предлагает в комментариях, что каждый конструктор подкласса должен принять данные о графике и имя свойства / пары значения свойства для всех свойств класса.

Интерфейс ведет дизайн класса

Пакет классов, которые выводят из абстрактного класса GraphInterface, реализует следующие поведения:

Определение интерфейса

Класс GraphInterface является абстрактным классом, который задает методы и свойства, используемые подклассами. Комментарии в абстрактном классе описывают намеченную реализацию:

classdef GraphInterface < handle
   % Abstract class for creating data graphs
   % Subclass constructor should accept
   % the data that is to be plotted and
   % property name/property value pairs
   properties (SetAccess = protected, GetAccess = protected)
      Primitive
      AxesHandle
   end
   properties
      Data
   end
   methods (Abstract)
      draw(obj)
      % Use a line, surface,
      % or patch graphics primitive
      zoom(obj,factor)
      % Change the CameraViewAngle
      % for 2D and 3D views
      % use camzoom for consistency
      updateGraph(obj)
      % Update the Data property and
      % update the drawing primitive
   end
   
   methods
      function set.Data(obj,newdata)
         obj.Data = newdata;
         updateGraph(obj)
      end
      function addButtons(gobj)
         hfig = get(gobj.AxesHandle,'Parent');
         uicontrol(hfig,'Style','pushbutton','String','Zoom Out',...
            'Callback',@(src,evnt)zoom(gobj,.5));
         uicontrol(hfig,'Style','pushbutton','String','Zoom In',...
            'Callback',@(src,evnt)zoom(gobj,2),...
            'Position',[100 20 60 20]);
      end
   end
end 

Класс GraphInterface реализует метод набора свойств (set.Data), чтобы наблюдать изменения к свойству Data. Альтернатива должна задать свойство Data как Abstract и позволить подклассам определить, реализовать ли метод доступа набора для этого свойства. Класс GraphInterface задает метод доступа набора, который вызывает абстрактный метод (updateGraph, который каждый подкласс должен реализовать). Интерфейс GraphInterface налагает определенный проект на целый пакет классов, не ограничивая гибкость.

Метод, чтобы работать со всеми подклассами

Метод addButtons добавляет кнопки для методов zoom, которые должен реализовать каждый подкласс. Используя метод вместо обычной функции позволяет addButtons получить доступ к данным защищенного класса (указатель осей). Используйте метод объекта zoom в качестве коллбэка кнопки.

function addButtons(gobj)
   hfig = get(gobj.AxesHandle,'Parent');
   uicontrol(hfig,'Style','pushbutton',...
      'String','Zoom Out',...
      'Callback',@(src,evnt)zoom(gobj,.5));
   uicontrol(hfig,'Style','pushbutton',...
      'String','Zoom In',...
      'Callback',@(src,evnt)zoom(gobj,2),...
      'Position',[100 20 60 20]);
end

Получение реального класса - LineGraph

Этот пример задает только один подкласс, используемый, чтобы представлять простой линейный график. Это выводит от GraphInterface, но обеспечивает реализации для абстрактных методов draw, zoom, updateGraph и его собственный конструктор. GraphInterface базового класса и подкласс все содержатся в пакете (graphics), который необходимо использовать, чтобы сослаться на имя класса:

classdef LineGraph < graphics.GraphInterface

Добавление свойств

Класс LineGraph реализует интерфейс, заданный в классе GraphInterface, и добавляет два дополнительных свойства — LineColor и LineType. Этот класс задает начальные значения для каждого свойства, так определение, что значения свойств в конструкторе являются дополнительными. Можно создать объект LineGraph без данных, но вы не можете произвести график из того объекта.

properties
   LineColor = [0 0 0];
   LineType = '-';
end

Конструктор LineGraph

Конструктор принимает struct с x и данными о координате y и именем свойства / пары значения свойства:

function gobj = LineGraph(data,varargin)
   if nargin > 0
      gobj.Data = data;
      if nargin > 2
         for k=1:2:length(varargin)
            gobj.(varargin{k}) = varargin{k+1};
         end
      end
   end
end

Реализация Метода ничьей

Метод draw LineGraph использует значения свойств, чтобы создать объект line. Класс LineGraph хранит указатель line как данные защищенного класса. Чтобы поддержать использование никаких входных параметров для конструктора класса, draw проверяет свойство Data определить, пусто ли это перед продолжением:

function gobj = draw(gobj)
   if isempty(gobj.Data)
      error('The LineGraph object contains no data')
   end
   h = line(gobj.Data.x,gobj.Data.y,...
      'Color',gobj.LineColor,...
      'LineStyle',gobj.LineType);
   gobj.Primitive = h;
   gobj.AxesHandle = get(h,'Parent');
end

Реализация Метода изменения масштаба

Метод zoom LineGraph следует комментариям в классе GraphInterface, которые предлагают использовать функцию camzoom. camzoom обеспечивает удобный интерфейс к изменению масштаба и действует правильно с кнопками, созданными методом addButtons.

Определение методов набора свойств

Методы набора свойств обеспечивают удобный способ выполнить код автоматически, когда значение свойства изменяется впервые в конструкторе. (См. Методы Набора свойств.) Класс linegraph использует методы установки обновить line примитивные данные (который вызывает перерисовку графика) каждый раз, когда значение свойства изменяется. Использование методов набора свойств обеспечивает способ обновить график данных быстро, не требуя вызова метода draw. Метод draw обновляет график путем сброса всех значений, чтобы совпадать с текущими значениями свойств.

Три свойства используют методы установки: LineColor, LineType и Data. LineColor и LineType являются свойствами, добавленными классом LineGraph, и характерны для line, примитивного используемый этим классом. Другие подклассы могут задать различные свойства, уникальные для их специализации (например, FaceColor).

Класс GraphInterface реализует метод набора свойств Data. Однако класс GraphInterface требует, чтобы каждый подкласс задал метод под названием updateGraph, который обрабатывает обновление, отображают данные на графике для определенного рисунка, примитивного используемый.

Класс LineGraph

Вот определение класса LineGraph.

classdef LineGraph < graphics.GraphInterface
   properties
      LineColor = [0 0 0]
      LineType = '-'
   end
   
   methods
      function gobj = LineGraph(data,varargin)
         if nargin > 0
            gobj.Data = data;
            if nargin > 1
               for k=1:2:length(varargin)
                  gobj.(varargin{k}) = varargin{k+1};
               end
            end
         end
      end
      
      function gobj = draw(gobj)
         if isempty(gobj.Data)
            error('The LineGraph object contains no data')
         end
         h = line(gobj.Data.x,gobj.Data.y,...
            'Color',gobj.LineColor,...
            'LineStyle',gobj.LineType);
         gobj.Primitive = h;
         gobj.AxesHandle = h.Parent;
      end
      
      function zoom(gobj,factor)
         camzoom(gobj.AxesHandle,factor)
      end
      
      function updateGraph(gobj)
         set(gobj.Primitive,...
            'XData',gobj.Data.x,...
            'YData',gobj.Data.y)
      end
      
      function set.LineColor(gobj,color)
         gobj.LineColor = color;
         set(gobj.Primitive,'Color',color)
      end
      
      function set.LineType(gobj,ls)
         gobj.LineType = ls;
         set(gobj.Primitive,'LineStyle',ls)
      end
   end
end

Использование класса LineGraph

Класс LineGraph задает простой API, заданный базовым классом graph, и реализует его специализированный тип графика:

d.x = 1:10;
d.y = rand(10,1);
lg = graphics.LineGraph(d,'LineColor','b','LineType',':');
lg.draw;
lg.addButtons;

Нажатие кнопки Zoom In показывает метод zoom, обеспечивающий коллбэк для кнопки.

Изменение свойств обновляет график:

d.y = rand(10,1); 
lg.Data = d;
lg.LineColor = [0.9,0.1,0.6]; 

Теперь нажмите Zoom Out и смотрите новые результаты: