getPropertyGroupsImpl

Группы свойства для отображения Системного объекта

Синтаксис

group = getPropertyGroupsImpl

Описание

group = getPropertyGroupsImpl задает, как отобразить свойства в диалоговом окне блока блока MATLAB System. Можно задать:

  • Разделы — свойства Arrange в разделы (панель по диалоговому окну блока MATLAB System) с matlab.system.display.Section.

  • Свойства Section Groups — Arrange и разделы в группы (переходит на диалоговом окне блока MATLAB System) с matlab.system.display.SectionGroup.

  • Порядок свойств — Задает порядок свойств в разделах/группах

  • Порядок разделов — Задает порядок разделов в группах.

Если вы создаете раздел, но тот раздел не находится в группе раздела, ее свойства появляются выше диалоговых панелей вкладки блока.

Детали во время выполнения

В Simulink®, getPropertyGroupsImpl изменяет диалоговое окно блока MATLAB System.

В MATLAB®, getPropertyGroupsImpl изменяет, как свойства появляются, когда Система object™ отображена в командной строке MATLAB. getPropertyGroupsImpl задает порядок и группировки свойств. Если ваш getPropertyGroupsImpl задает несколько групп раздела, только свойства от первой группы раздела отображены в командной строке. Чтобы отобразить свойства в других разделах, ссылка обеспечивается в конце отображения свойства Системного объекта. Заголовки группы также отображены в командной строке.

Метод, создающий советы

  • Необходимо установить Access = protected для этого метода.

  • Если вы включаете getPropertyGroupsImpl метод, но не перечисляет все свойства, исключенные свойства не появляются в диалоговом окне.

  • Не использовать Main заголовок для первой группы свойств, в matlab.system.display.SectionGroup, установите TitleSource к 'Auto'.

  • По умолчанию, если вы не настраиваете этот метод в своем Системном объекте, диалоговое окно блока MATLAB System отображает все публичные свойства в порядке, заданном в файле класса Системного объекта.

  • Чтобы настроить имена свойства, добавьте комментарии выше каждого свойства. Для примера смотрите Системный объект к Отображению Значения по умолчанию Диалогового окна блока.

Выходные аргументы

развернуть все

Группы свойства и разделы, чтобы передать блоку MATLAB System, заданному как массив matlab.system.display.Section и matlab.system.display.SectionGroup объекты.

Примеры

развернуть все

Этот пример настраивает диалоговое окно блока для блока MATLAB System путем определения имен отображения свойства и изменения getPropertyGroupImpl метод. Эта индивидуальная настройка продемонстрирована с Системным объектом AddPropertySections.

Измените метки свойства

Чтобы изменить метку свойства, которая появляется на диалоговом окне, добавьте комментарии перед каждым свойством в этом формате %PropertyName Block Dialog Label без пробела между знаком процента и именем свойства. Например, чтобы отобразить UseAlpha свойство как альфа Использования, задайте:

%UseAlpha Use alpha
UseAlpha = 0

AddPropertySections Системный объект, включенный с этим примером, повторно помечает свойства для отображения в диалоговом окне блока MATLAB System.

Организуйте диалоговое окно

Организовывать свойства на диалоговом окне, AddPropertySections Класс системного объекта задает getPropertyGroupsImpl метод. В getPropertyGroupsImpl метод, этот пример задает два раздела, каждого с двумя свойствами.

classdef AddPropertySections < matlab.System
    % AddPropertySections Customized dialog with two parameter sections
    
    % Public, tunable properties
    properties
        
        %NumberOfShapes Number of shapes
        NumberOfShapes = 10
        
        Alpha = 0.75
    end
 
    % Public, nontunable properties
    properties(Nontunable)
        Coloring (1, 1) {mustBeMember(Coloring,["red","blue","green"])} = "red"

        %UseAlpha Use alpha
        UseAlpha (1,1) logical = false
    end
    
    methods (Static, Access = protected)
        function groups = getPropertyGroupsImpl           
            % Section for the value parameters
            valueSection = matlab.system.display.Section(...
                'Title','Shape parameters',...
                'PropertyList',{'NumberOfShapes','Coloring'});
            
            % Section for the threshold parameters
            shadingSection = matlab.system.display.Section(...
                'Title','Shading parameters',...
                'PropertyList',{'UseAlpha','Alpha'});
            
            % Return an array with the two sections.
            groups = [valueSection, shadingSection];
        end
    end
end

Получившееся диалоговое окно

load_system('CustomSystemBlockDialog')
open_system('CustomSystemBlockDialog/MATLAB System')

Этот пример настраивает диалоговое окно блока для MultipleGroupsWithTabs Блок MATLAB System путем определения свойства отображает имена и изменения getPropertyGroupImpl метод.

Измените метку свойства

Чтобы изменить метку свойства, которая появляется на диалоговом окне, добавьте комментарии перед каждым свойством в этом формате %PropertyName Block Dialog Label без пробела между комментарием и именем свойства. Например, чтобы отобразить StartValue свойство, как Запускают Значение, задает:

%StartValue Start Value
StartValue = 0

MultipleGroupsWithTabs Системный объект в этом примере повторно помечает каждое свойство для отображения в диалоговом окне блока MATLAB System.

Организуйте диалоговое окно

MutlitpleGroupsWithTabs Класс системного объекта задает getPropertyGroupsImpl метод. В getPropertyGroupsImpl метод, этот пример задает две вкладки (группы раздела) и три группировки параметра (разделы).

classdef MultipleGroupsWithTabs < matlab.System
    % MultipleGroupsWithTabs Customize block dialog with multiple tabs and parameter groups.
    
    % Public, tunable properties
    properties
        %StartValue Start Value
        StartValue = 0
        
        %EndValue End Value
        EndValue = 10
        
        Threshold = 1
        
        %BlockLimit Limit
        BlockLimit = 55
    end
    % Public Nontunable 
    properties(Nontunable)
        %IC1 First initial condition
        IC1 = 0
        
        %IC2 Second initial condition
        IC2 = 10
        
        %IC3 Third initial condition
        IC3 = 100

        %UseThreshold Use threshold
        UseThreshold (1,1) logical = true
    end
    
    methods (Static, Access = protected)
        function groups = getPropertyGroupsImpl
            % Section to always display above any tabs.
            alwaysSection = matlab.system.display.Section(...
                'Title','','PropertyList',{'BlockLimit'});
           
            % Group with no sections
            initTab = matlab.system.display.SectionGroup(...
                'Title','Initial conditions', ...
                'PropertyList',{'IC1','IC2','IC3'});
            
            % Section for the value parameters
            valueSection = matlab.system.display.Section(...
                'Title','Value parameters',...
                'PropertyList',{'StartValue','EndValue'});
            
            % Section for the threshold parameters
            thresholdSection = matlab.system.display.Section(...
                'Title','Threshold parameters',...
                'PropertyList',{'Threshold','UseThreshold'});
            
            % Group with two sections: the valueSection and thresholdSection sections
            mainTab = matlab.system.display.SectionGroup(...
                'Title','Main', ...
                'Sections',[valueSection,thresholdSection]);
            
            % Return an array with the group-less section, the group with
            % two sections, and the group with no sections.
            groups = [alwaysSection,mainTab,initTab];
        end
    end
end

Получившееся диалоговое окно

load_system('ShowSystemBlockDialog')
open_system('ShowSystemBlockDialog/MATLAB System')

Введенный в R2013b

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