Реализация Устанавливала/Получала Интерфейс для Свойств

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

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

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

  • matlab.mixin.SetGet — использование когда это необходимо поддерживает для нечувствительного к регистру, частичного соответствия имени свойства. Получение от matlab.mixin.SetGet не влияет на точное имя свойства, требуемое при помощи ссылки записи через точку на свойства.

  • matlab.mixin.SetGetExactNames — используйте когда это необходимо, чтобы поддержать только чувствительное к регистру полное соответствие имени свойства.

Примечание

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.

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

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')

Методы доступа к свойствам, Вызванные набором и, добираются

MATLAB вызывает методы доступа свойства (set.Style или set.Marker в классе LineType), когда вы используете методы get и set.

set(h,'Style','-.-')
Error using LineType>LineType.set.Style
Invalid line style

Для получения дополнительной информации о методах доступа свойства см. Методы доступа к свойствам

Листинг всех свойств

Возвратите struct, содержащий свойства объектов и их текущие значения с помощью get:

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

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

Возвратите struct, содержащий свойства, которые имеют public SetAccess с помощью set:

S = set(h)
S =

     Style: {}
    Marker: {}

Класс LineType задает свойство Units с SetAccess = protected. Поэтому S = set(h) не создает поле для Units в S.

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

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

Предположим, что вы создаете массив объектов LineType:

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

  1x2 LineType with properties:

    Style
    Marker
    Units

Когда H является массивом указателей, get возвращается (length(H)-by-1) массив ячеек значений свойств:

CV = get(H,'Style')
CV = 

    '..'
    '--'

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

SV = get(H)
SV = 

2x1 struct array with fields:
    Style
    Marker
    Units

Получите значение свойства Marker от второго элемента массива в массиве SV структур:

SV(2).Marker
ans =

q

Массивы указателей, имен и значений

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

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

Результат этого вызова isset:

H(1)
ans = 

  LineType with properties:

     Style: '..'
    Marker: 'o'
     Units: 'points
H(2)
ans = 

  LineType with properties:

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

Настройка списка свойств

Настройте способ, которым списки свойств отображаются путем переопределения следующих методов в подклассе:

  • setdisp Когда вы вызываете set без выходного аргумента и одного скалярного входа указателя, set вызывает setdisp, чтобы определить, как отобразить список свойств.

  • getdisp Когда вы вызываете get без выходного аргумента и одного скалярного входа указателя, get вызывает getdisp, чтобы определить, как отобразить список свойств.

Смотрите также

|

Похожие темы

Для просмотра документации необходимо авторизоваться на сайте