创建模块封装

自定义模块外观、用户界面和模块图

Simulink^® 允许您创建模块封装。封装是用于模块的一种自定义用户界面。

通过封装模块，可以将模块图封装起来，使其拥有自己的参数对话框，以及自己的模块描述、参数提示和帮助文本。

您可以封装独立的自定义模块以作为独特模块重复使用，就像 Simulink 中定义的模块一样。

要了解如何创建模块封装，请参阅创建简单封装。

类

封装参数和约束

`Simulink.Mask`	以编程方式控制封装
`Simulink.Mask.Constraints`	Create mask parameter constraint
`Simulink.Mask.PortConstraints`	Create mask port constraints programmatically (自 R2022a 起)
`Simulink.Mask.ParameterCondition`	Create mask parameter conditions (自 R2022a 起)
`Simulink.Mask.PortConstraintRule`	Create instance of `Simulink.Mask.PortConstraintRule` to define rules of port constraint (自 R2022a 起)
`Simulink.Mask.PortIdentifier`	Create port identifiers to identify ports of block in mask object (自 R2022a 起)
`Simulink.Mask.CrossPortConstraints`	Creates cross-port constraint among ports of the same masked block (自 R2023a 起)
`Simulink.Mask.SharedConstraintFile`	Constraints that needs to be saved in an XML file (自 R2023a 起)
`Simulink.MaskParameter`	以编程方式控制封装参数
`Simulink.Mask.EnumerationBase`	Derive an enumeration class to hold numeric values of any datatype (自 R2021a 起)
`Simulink.Mask.EnumerationTypeOptions`	Parse information from enumeration file derived from `Simulink.IntEnumType` and `Simulink.Mask.EnumerationBase` (自 R2021a 起)

对话框控件元素

`Simulink.dialog.Control`	创建对话框控件的实例
`Simulink.dialog.Button`	Create instance of button dialog control
`Simulink.dialog.Hyperlink`	Create instance of hyperlink dialog control
`Simulink.dialog.Image`	Manage image dialog control
`Simulink.dialog.Text`	Manage text dialog control
`Simulink.dialog.ListboxControl`	Control list box programmatically
`Simulink.dialog.parameter.Control`	Create a parameter dialog control
`Simulink.dialog.parameter.CustomTable`	Create custom tables programmatically
`Simulink.dialog.TreeControl`	Control Tree control programmatically
`Simulink.dialog.LookupTableControl`	Control mask lookup tables programmatically (自 R2021b 起)
`Simulink.dialog.LookupTableControl.Table`	Control table data for mask lookup table (自 R2021b 起)
`Simulink.dialog.LookupTableControl.Breakpoints`	Control breakpoint data set for mask lookup table (自 R2021b 起)
`Simulink.dialog.Container`	Create instance of container dialog control
`Simulink.dialog.Group`	Create instance of group dialog control
`Simulink.dialog.Panel`	Create instance of panel dialog control
`Simulink.dialog.Tab`	Create instance of tab dialog control
`Simulink.dialog.TabContainer`	Create instance of tab container dialog control

主题

封装简介

封装基础知识
了解有关封装和何时封装模块的基础知识。
创建简单封装
您可以使用封装编辑器以交互方式封装模块，也可以编程方式封装模块。此示例说明如何使用封装编辑器来封装模块。要以编程方式封装模块，请参阅以编程方式控制封装
Manage Existing Masks
View or edit an existing block mask.

封装编辑器用户界面

封装编辑器概述
使用封装编辑器界面创建和自定义封装。
使用“数据类型字符串”参数指定数据类型
为“编辑封装”参数添加数据类型约束。
设计封装对话框
尝试此示例以创建一个封装对话框并了解某些封装编辑器功能的用途。
Handling Large Number of Mask Parameters
Add large number of mask parameters in a Table programmatically.
Customize Tables for Masked Blocks
Add custom tables to mask dialog box.
Control Custom Table Programmatically
Use a programmatic interface to control custom tables.
以编程方式控制封装
Simulink® 定义了一组有助于设置和编辑封装的参数。要从 MATLAB® 命令行设置和编辑封装，您可以使用 Simulink.Mask 和 Simulink.MaskParameter 类方法。也可以使用 get_param 和 set_param 函数来设置和编辑封装。但是，由于这些函数使用的分隔符不支持 Unicode®（非英文）字符，建议您使用 Simulink.Mask 方法和 Simulink.MaskParameter 类方法来控制封装。

封装功能

Validating Mask Parameters Using Constraints
Add validation to mask parameters using constraints.
Custom Constraint for Mask Parameter
A mask can contain parameters that accept user input values.
Share Parameter Constraints Across Multiple Block Masks
This example shows how to create a parameter constraint and share it across masks of different blocks in the same model or different models.
Validate Input and Output Port Signals Using Port Constraints
You can validate compile-time signal attributes on the input and output ports of a masked block by using port constraints.
Validate Port Signals Among Ports of the Same Masked Block
This example shows how to create cross port constraints to validate compile-time signal attributes among ports of the same masked block.
Share Port Constraints Across Multiple Masked Blocks
This example shows how to create a port constraint and share it across masks of different blocks in the same model or different models.
封装回调代码
添加并执行封装回调代码。
从封装初始化和回调代码开始
使用 MATLAB^® 代码初始化模块封装。
Promote Block Parameters on a Mask
Blocks and subsystems can have multiple parameters associated with them.
将值传递给封装下的模块
使用封装对话框指定输入值。
Mask Linked Blocks
Add custom interface to linked blocks.
Approaches to Control Active Variant Choice of a Variant Block Using Mask or Model Workspace
This example shows different approaches to control the active choice of inline variant and Variant Subsystem blocks from a mask or a model workspace.
Define Measurement Units for Masked Blocks
Set measurement units for output and input ports of a masked block.
Add Images in Masks
Add images as mask icons and save them in the SLX file.
Create Hierarchical List in Mask Dialog
Create a hierarchical list of data on a mask.
Tune Mask Enumeration Parameters - Popup and Radio Button
Reference external enumeration file to assign numerical values to popup parameter.
Visualize and Plot N-Dimensional Data Using Mask Lookup Table Control
Use a lookup table to evaluate a sampled representation of a function using simple lookup operations.
Preserve Tunability of Parameters That Are Modified or Created in Mask Initialization
A desirable feature of code generated from a model is the ability to tune variables to different values.

图形图标编辑器

Graphical Icon Editor Overview
Create and edit mask icon of a block in a graphical environment.
Create and Edit Block Mask Icon
Create block mask icon using Graphical Icon Editor and Mask Drawing commands.
Add Dynamic Behavior to Masked Icons
Using Graphical Icon Editor, you can add dynamic behavior to masked block icons:

封装回调

从封装初始化和回调代码开始
使用 MATLAB 代码初始化模块封装。
Author Mask Initialization and Callbacks
You can write MATLAB code in the code pane of the Mask Editor for mask initialization and callbacks.
Organize Mask Initialization and Callbacks in a MATLAB File
You can organize mask initialization and mask callback code in a separate MATLAB® class file.
动态封装对话框
您可以为封装模块创建对话框，这些对话框的显示会根据用户输入而发生变化。以这种方式变化的封装对话框的特性包括：
动态封装子系统
创建可以修改其结构性内容的封装库模块。
Debug Masks That Use MATLAB Code
Troubleshoot errors in the mask initialization code.

系统封装

Introduction to System Mask
Learn about masking a model.
以编程方式控制封装
Simulink® 定义了一组有助于设置和编辑封装的参数。要从 MATLAB® 命令行设置和编辑封装，您可以使用 Simulink.Mask 和 Simulink.MaskParameter 类方法。也可以使用 get_param 和 set_param 函数来设置和编辑封装。但是，由于这些函数使用的分隔符不支持 Unicode®（非英文）字符，建议您使用 Simulink.Mask 方法和 Simulink.MaskParameter 类方法来控制封装。
Create and Reference a Masked Model
Mask a model interactively.
Create and Display System Mask Programmatically
You can apply a system mask to a model or a subsystem block diagram.

示例模型

Masking Example Models
View Simulink models that demonstrate masking capabilities.

精选示例

Promote Block Parameters on a Mask

Blocks and subsystems can have multiple parameters associated with them. Block masks allow you to expose one or more of these parameters while hiding others from view. You can promote any underlying parameter of a block either to a block mask or to a subsystem mask. For any subsystem, you have a single view of all the nested blocks, the block parameters, and internal parameters. You can click on any node to access any promotable parameter within the nested blocks. By promoting parameters from the block dialog box to the mask you can:

打开脚本

Tune Mask Enumeration Parameters - Popup and Radio Button

Reference external enumeration file to assign numerical values to popup parameter.

打开脚本

Organize Mask Initialization and Callbacks in a MATLAB File

You can organize mask initialization and mask callback code in a separate MATLAB® class file. By using a separate MATLAB file you can:

打开模型

Validate Port Signals Among Ports of the Same Masked Block

Create cross port constraints to validate compile-time signal attributes among ports of the same masked block. For example, you can set a constraint among the input and output port signals of the masked block to have the same data type. The rules for the cross port constraints are predefined. The available rules are Same Data Type and Same Dimension. Additionally, you can also set parameter conditions. Each port in the masked block is identified by port identifiers. The cross port constraint association is done through port identifiers.

打开模型