Main Content

matlab.system.display.SectionGroup 类

包: matlab.system.display
超类:

System object 的节组

语法

matlab.system.display.SectionGroup(N1,V1,...Nn,Vn)
matlab.system.display.SectionGroup(Obj,...)

说明

matlab.system.display.SectionGroup(N1,V1,...Nn,Vn) 创建用于显示 System object™ 属性的组并显示通过 matlab.system.display.Section 创建的节。可使用属性名称-值对组 (N,V) 定义此类节或属性。节组可以包含属性和节。您可以使用 matlab.system.display.SectionGroup 借助 getPropertyGroupsImpl 方法来定义节组。节组在 MATLAB System (Simulink) 模块中显示为单独的选项卡。可用节属性包括:

  • Title - 组标题。默认值为空字符向量。

  • TitleSource - 组标题的来源。有效值为 'Property''Auto'。默认值为 'Property',它使用 Title 属性中的字符向量。如果提供了 Obj 名称,则默认值为 Auto,它会使用 Obj 名称。在 MATLAB® 命令行上显示的 System object 属性中,您可以通过将 TitleSource 设置为 'Auto',省略第一组属性的默认“Main”标题。

  • Description - 出现在任何属性或面板上方的组或选项卡描述。默认值为空字符向量。

  • PropertyList - 属性名称元胞数组形式的组或选项卡属性列表。默认值是空数组。如果提供了 Obj 名称,则默认值为所有符合条件的显示属性。

  • Sections - 将节组合为节对象数组。如果提供了 Obj 名称,则默认值为 Obj 的默认节。

  • Type - 容器类型。例如,选项卡、组、面板和可折叠面板。

  • Row - 指定需要在其中放置容器的行(当前行/新行)。您可以使用枚举类 matlab.system.display.internal.row 指定该行。

  • AlignPrompts - 指定布尔值来控制容器内的对齐提示。

matlab.system.display.SectionGroup(Obj,...) 为指定的 System object (Obj) 创建节组,并设置以下属性值:

  • TitleSource - 设置为 'Auto'

  • Sections - 对于 Obj,设置为 matlab.system.display.Section 对象。

您可以在此方法中使用 mfilename('class'),以获取 System object 的名称。如果设置任何名称-值对组,则这些属性值将覆盖默认设置。

示例

全部折叠

在您的类定义文件中定义两个选项卡,每个都包含特定的属性。对于此示例,您使用 matlab.system.display.SectionGroupmatlab.system.display.SectiongetPropertyGroupsImpl 方法。

classdef MultipleGroupsWithSectionGroup < 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'},...
                'GroupType', matlab.system.display.SectionType.group);
            
            % Section for the value parameters
            valueSection = matlab.system.display.Section(...
                'Title','Value parameters',...
                'PropertyList',{'StartValue','EndValue'},...
                'SectionType', matlab.system.display.SectionType.collapsiblepanel);
            
            % Section for the threshold parameters
            thresholdSection = matlab.system.display.Section(...
                'Title','Threshold parameters',...
                'PropertyList',{'Threshold','UseThreshold'},...
                'SectionType', matlab.system.display.SectionType.collapsiblepanel);
            
            % Group with two sections: the valueSection and thresholdSection sections
            mainTab = matlab.system.display.SectionGroup(...
                'Title','Main', ...
                'Sections',[valueSection,thresholdSection],...
                'GroupType', matlab.system.display.SectionType.group);
            
            % 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

当您使用 MATLAB System (Simulink) 模块向 Simulink® 中添加对象时,生成的对话框如下所示。