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

Стандартный набор / Получает Интерфейс

Некоторые объекты ^MATLAB®, такие как графические объекты, реализуют интерфейс на основе функций get и set. Эти функции включают доступ к нескольким свойствам на массивах объектов в единственном вызове функции.

Можно добавить set и функциональность get к классу путем получения от одного из этих классов:

Разделение на подклассы синтаксиса

Используйте абстрактный класс matlab.mixin.SetGet или matlab.mixin.SetGetExactNames в качестве суперкласса:

classdef MyClass < matlab.mixin.SetGet
   ...
end

Поскольку matlab.mixin.SetGet и matlab.mixin.SetGetExactNames выводят от класса handle, ваш подкласс является также классом handle.

Синтаксис метода get

Метод get возвращает значение свойства объекта с помощью указателя на объект и имени свойства. Например, примите, что H является указателем на объект:

v = get(H,'PropertyName');

Если вы задаете массив указателей с единственным именем свойства, get возвращает значение свойства для каждого объекта как массив ячеек значений:

CV = get(H,'PropertyName');

Массив CV всегда является столбцом независимо от формы H.

Если вы задаете массив ячеек имен свойства вектора char и массив указателей, get возвращает массив ячеек значений свойств. Каждая строка в ячейке соответствует объекту в массиве указателя. Каждый столбец в ячейке соответствует имени свойства.

props = {'PropertyName1','PropertyName2'};
CV = get(H,props);

get возвращает массив ячеек m на n, where m = length(H) и n = length(props).

Если вы задаете массив указателя, но никакие имена свойства, get возвращает массив типа struct, в котором каждая структура в массиве соответствует объекту в H. Каждое поле в каждой структуре соответствует свойству, заданному классом H. Значение каждого поля является значением соответствующего свойства.

SV = get(H);

Если вы не присваиваете выходную переменную, то H должен быть скаляром.

Для примера смотрите Используя, добираются с Массивами Указателей.

Синтаксис метода установки

Метод set присваивает заданное значение заданному свойству для объекта с указателем H. Если H является массивом указателей, MATLAB присваивает значение свойству для каждого объекта в массиве H.

set(H,'PropertyName',PropertyValue)

Можно передать массив ячеек имен свойства и массив ячеек значений свойств к set:

props = {'PropertyName1','PropertyName2'};
vals = {Property1Value,Property2Value};
set(H,props,vals)

Если length(H) больше, чем один, то массив ячеек значения свойства (vals) может иметь значения для каждого свойства в каждом объекте. Например, предположите, что length(H) равняется 2 (два указателя на объект). Вы хотите присвоить два значений свойств на каждом объекте:

props = {'PropertyName1','PropertyName2'};
vals = {Property11Value,Property12Value;Property21Value,Property22Value};
set(H,props,vals))

Предыдущий оператор эквивалентен следованию за двумя операторами:

set(H(1),'PropertyName1',Property11Value,'PropertyName2',Property12Value)
set(H(2),'PropertyName1',Property21Value,'PropertyName2',Property22Value)

Если вы задаете скалярный указатель, но никакие имена свойства, set возвращает struct с одним полем для каждого свойства в классе H. Каждое поле содержит массив пустой ячейки.

SV = set(h);

Класс, Выведенный от matlab.mixin. SetGet

Этот демонстрационный класс задает установить/получить интерфейс и иллюстрирует поведение унаследованных методов:

classdef LineType < matlab.mixin.SetGet
   properties
      Style = '-'
      Marker = 'o'
   end
   properties (SetAccess = protected)
      Units = 'points'
   end
   methods
      function obj = LineType(s,m)
         if nargin > 0
            obj.Style = s;
            obj.Marker = m;
         end
      end
      function obj = set.Style(obj,val)
         if ~(strcmpi(val,'-') ||...
               strcmpi(val,'--') ||...
               strcmpi(val,'..'))
            error('Invalid line style ')
         end
         obj.Style = val;
      end
      function obj = set.Marker(obj,val)
         if ~isstrprop(val,'graphic')
            error('Marker must be a visible character')
         end
         obj.Marker = val;
      end
   end
end

Создайте экземпляр класса и сохраните его указатель:

h = LineType('--','*');

Запросите значение любого свойства объекта с помощью наследованного метода get:

get(h,'Marker')

ans =

*

Установите значение любого свойства с помощью наследованного метода set:

set(h,'Marker','Q')

set(h,'Style','-.-')

Error using LineType>LineType.set.Style
Invalid line style

h = LineType('--','*');
SV = get(h)

SV =

     Style: '--'
    Marker: '*'
     Units: 'points'

S = set(h)

S =

     Style: {}
    Marker: {}

H = [LineType('..','z'),LineType('--','q')]

H = 

  1x2 LineType with properties:

    Style
    Marker
    Units

CV = get(H,'Style')

CV = 

    '..'
    '--'

SV = get(H)

SV = 

2x1 struct array with fields:
    Style
    Marker
    Units

SV(2).Marker

ans =

q

H = [LineType('..','z'),LineType('--','q')];
set(H,{'Style','Marker'},{'..','o';'--','x'})

H(1)

ans = 

  LineType with properties:

     Style: '..'
    Marker: 'o'
     Units: 'points

H(2)

ans = 

  LineType with properties:

     Style: '--'
    Marker: 'x'
     Units: 'points'