2026a
# 模型结构名词解释
以 Modelica 标准库中的 PID_Controller 模型来对模型的 key、模型简名、模型全名、模型路径、模型描述等名词进行解释。
# 模型key
每个模型都会对应一个 MWint 类型的键值(简称 key)，用于标识模型，作为模型的 ID。
- 软件每次启动后若对模型进行了卸载重新打开、模型编辑、模型修改等操作都会导致key发生改变，可用key来对模型进行定位、获取属性等相关操作；软件重新启动后模型key与上次软件打开的模型key不一致；
- PID_Controller 本模型有一个对应的唯一模型key，也称主模型key；
- 模型 key 可通过 GetKeyByTypeName 接口对传入模型全名进行查询。
# 组件key
模型下会存在组件，每个组件名称都存在一个唯一 key。
- 例如，PID_Controller模型下有个名称为
PI的组件，该组件会存在一个组件 key； - 组件 key 可通过传入组件全名 GetKeyByTypeName 接口进行查询。
# 组件类型key
组件是一个模型的实例，而模型是一个组件的类型，所以每个组件会对应一个类型，该类型也会存在一个 key。
- 例如名称为 PI 的组件其类型为
Modelica.Blocks.Continuous.LimPID该类型会对应一个 key，该 key 为 PI 组件的类型 key; - 组件类型 key 可通过传入组件对应的类型全名 GetKeyByTypeName 接口进行查询；
- 通过组件 key 查询到的模型相关属性为该组件所在模型 key 下的属性，通过类型 key 查询到的相关属性为该类型对应的模型的相关属性。
# 模型描述
对模型使用的描述。模型描述可通过 GetPropAsString 接口并传入模型 key 进行查询。
# 组件描述
模型下组件对应的描述。组件描述可通过 GetPropAsString 接口并传入模型 key 进行查询。
# 模型全名
由包含模型的所有外层类（依次由外至内）及模型本身名称组合而成，各名称之间用“.”分割。
- 例如本模型中模型全名为 Modelica.Blocks.Examples.PID_Controller;
- 模型全名可通过 GetFullnameProp 接口来查询。
# 组件全名
模型下的组件的全名。
- 例如组件 PI 的全名为 Modelica.Blocks.Examples.PID_Controller.PI；
- 组件全名可通过 GetFullnameProp 接口来查询.
# 组件简名
模型下的组件名称。
- 例如 PI；
- 组件名称可通过 GetNameProp 接口来查询。
# 模型简名
只有模型名称，称为简名。
- 例如 PID_Controller ；
- 模型名称可通过 GetNameProp 接口来查询。
# 组件列表key
模型下有多个组件，每个组件都有一个唯一 key，所有的 key 形成一个列表称为组件 key，通过组件列表 key 可循环操作组件并获取相关属性。
组件列表 key 可通过 LookupCompAndTypeEx 来查询。
# 模型路径
保存模型的文件。
模型路径可通过 GetFullFileName 接口来查询。
# 界面查看方式
查看模型属性 在 PID_Controller 模型空白处，右击选择属性，弹出下列属性框：
① 模型类别② 模型简明
③ 模型描述
④ 模型路径
查看组件属性 选择对应的组件，右击选择属性，弹出下列属性框：
① 组件简名，该组件会有一个组件key；② 组件描述；
③ 组件类型全名，该模型会对应一个组件类型key。
查看组件列表 在Sysplorer界面右上角，选择窗口>组件浏览器，可查看到该模型下的所有组件，这些组件会有一个组件列表 key：
