概述的StateflowAPI
的Stateflow®应用程序编程接口(API)是一个工具用于创建或改变通过MATLAB Stateflow图表®命令。通过将Stateflow API命令一个MATLAB脚本,你可以在一个命令自动化图表编辑过程。
Stateflow API的应用程序包括:
创建一个脚本,该脚本执行常见的图形编辑和简化编辑Stateflow图表
创建一个脚本,该脚本创建一个重复的“基础”Stateflow图表
创建一个脚本,该脚本生成一个专门报告你的模型
Stateflow API包含对象代表Stateflow图的图形和nongraphical对象。例如,API类型的对象状态
和过渡
代表Stateflow图的状态和转换。API对象和对象之间的通信在一个图表是双向的。当你修改一个API对象的属性或调用它的一个方法,你影响Stateflow图中相应的对象。当你使用Stateflow编辑器上执行一个操作一个对象的图表,你会影响相应的API对象。
请注意
你不能撤消任何操作在Stateflow编辑器中,你使用Stateflow API执行。如果你通过API执行编辑操作,撤销和重做按钮被禁用之前撤销和重做任何操作。
StateflowAPI对象层次结构
Stateflow API对象包含或包含于其他API对象。例如,如果状态一个
包含状态B
在Stateflow图表,然后API对象的状态一个
包含API对象的状态B
。控制规则定义了Stateflow Stateflow等级和API对象层次结构。例如,图可以包含状态但不能包含图表。有关更多信息,请参见Stateflow对象的概述。
这个图表显示了Stateflow API的对象层次结构。
Stateflow API层次结构由这些层的控制:
根- - -
根
是所有Stateflow API对象的父对象。这是一个占位符的顶部Stateflow API从仿真软件层次结构来区分Stateflow对象金宝app®模型对象。你自动创建根
对象时加载仿真软件模型包含Stateflow图金宝app表或调用的函数sfnew
与Stateflow图表创建一个模型。机——Stateflow机包含所有的图表在仿真软件模型。金宝app
机
对象是相当于从Stateflow角度仿真软件模型。金宝app所有机
对象是包含在根
对象。机
对象可以容纳图表
对象代表Stateflow图表、状态转换表,和真值表块。图表——在任何
机
可以有任意数量的对象图表
对象。每个类型的对象图表
可以包含对象代表状态,过渡连接,盒、函数、注释、数据、事件和消息。这些对象代表Stateflow图表的组成部分。州、函数和盒子——内嵌套类型的对象
状态
,函数
,盒子
可以有其他对象,代表国家,过渡,路口,盒子,功能,注释,数据、事件和消息。嵌套的水平可以继续下去。
层次结构关系图显示了两个对象类型存在以外的Stateflow容器层次结构:
编辑器——尽管不是Stateflow容器层次结构的一部分,一个类型的对象
编辑器
提供的纯图形方面的对象类型图表
。为每一个图表
对象,有一个编辑器
对象提供了API访问Stateflow编辑器。有关更多信息,请参见修改你的图形属性图。剪贴板- - -
剪贴板
对象有两个方法,复制
和pasteTo
,使用剪贴板作为暂存区域Stateflow API实现复制和粘贴功能。有关更多信息,请参见复制和粘贴Stateflow对象。
掌握StateflowAPI对象
你操纵Stateflow对象通过操纵Stateflow API对象代表他们。你操纵Stateflow API通过MATLAB变量称为对象处理。
第一个处理需要Stateflow API是一个句柄根
对象,该对象的父Stateflow中的所有对象的API。在这个命令中,函数sfroot
返回一个句柄根
对象:
rt = sfroot
一旦你有了一个根
对象句柄,你可以找到一个句柄的模型对象Stateflow机器与你想要的工作。一旦你有一个句柄机
对象,您可以找到一个句柄图表
图想要编辑的对象。之后,当您创建对象或发现现有对象Stateflow图表,你收到处理对象,您可以使用它们来操纵Stateflow编辑器中的实际对象。
学习如何使用API对象句柄来创建和编辑Stateflow图表,看看通过使用Stateflow API创建图表。
访问API对象属性和方法
获得处理Stateflow API对象后,您可以通过操纵Stateflow对象,他们表示每个Stateflow API对象拥有的属性和方法。访问对象的属性和方法通过一个对象的句柄。
API对象属性
API属性对应的值,你通常设置一个对象通过Stateflow编辑器的用户界面。例如,您可以改变通过改变过渡的位置位置
财产的过渡
对象代表了过渡。在Stateflow编辑器中,您可以click-drag来源,最终,或中点过渡到改变立场。
API对象方法
API方法类似于函数用于创建、查找、更改或删除他们属于的对象。他们提供的服务,通常都是提供的Stateflow编辑器。例如,您可以删除一个过渡在Stateflow编辑器中通过调用删除
的方法过渡
对象代表了过渡。在Stateflow编辑器中删除一个过渡通常是通过选择一个过渡和紧迫删除关键。
通用的API属性和方法
Stateflow API对象有一些共同的属性和方法。例如,有一个所有API对象Id
和一个描述
财产。有一个所有API对象得到
和一个集
方法用于查看或改变一个对象的属性,分别。大多数API对象也有一个删除
方法。
独特的API的属性和方法
每个API对象也有属性和方法独特类型。例如,一个状态
对象有位置
属性包含它所代表的国家的空间坐标Stateflow编辑器。一个数据
对象,但是,没有位置
财产。