Stateflow.Transition
R2026b图、状态、框或函数中的转移
描述
使用 Stateflow.Transition 对象创建从一个工作模式到另一个工作模式的转移。有关详细信息,请参阅工作模式之间的转移。
创建对象
输入参量
属性
Stateflow API 对象具有与您在 Stateflow 编辑器中设置的值对应的属性。要访问或修改属性,请使用圆点表示法。要访问或修改多个 API 对象的多个属性,请分别使用 get 和 set 函数。有关详细信息,请参阅Modify Properties and Call Functions of Stateflow Objects。
内容
转移的标签,指定为字符串标量或字符向量。有关详细信息,请参阅Specify Labels in States and Transitions Programmatically。
此 属性 为只读。
转移条件,指定为字符向量。此属性的值取决于转移的 LabelString 属性。有关详细信息,请参阅Specify Labels in States and Transitions Programmatically。
此 属性 为只读。
转移条件动作,指定为字符向量。此属性的值取决于转移的 LabelString 属性。有关详细信息,请参阅Specify Labels in States and Transitions Programmatically。
此 属性 为只读。
转移动作,指定为字符向量。此属性的值取决于转移的 LabelString 属性。有关详细信息,请参阅Specify Labels in States and Transitions Programmatically。
此 属性 为只读。
转移触发器,指定为字符向量。此属性的值取决于转移的 LabelString 属性。有关详细信息,请参阅Specify Labels in States and Transitions Programmatically。
当转移的源处于激活状态时转移的执行顺序,指定为整数标量。此属性仅在包含转移的图的 UserSpecifiedStateTransitionExecutionOrder 属性为 true 时适用。有关详细信息,请参阅转移的计算顺序。
是否注释掉转移,指定为数值或逻辑值 1 (true) 或 0 (false)。将此属性设置为 true 等效于右键点击转移并选择注释掉。有关详细信息,请参阅Comment Out Objects in a Stateflow Chart。
此 属性 为只读。
转移是否隐式被注释掉,指定为数值或逻辑值 1 (true) 或 0 (false)。当您显式注释掉包含转移的对象或注释掉其源或目标时,该转移会隐式被注释掉。如果转移包含在原子子图或原子框中,则此属性为 false,除非显式注释的对象也包含在该原子子图或原子框中。
自 R2023a 起
此 属性 为只读。
转移是否被注释掉,指定为数值或逻辑值 1 (true) 或 0 (false)。当 IsExplicitlyCommented 或 IsImplicitlyCommented 为 true 时,此属性为 true。
添加到转移的注释文本,指定为字符串标量或字符向量。此属性仅在 IsExplicitlyCommented 属性为 true 时适用。在 Stateflow 编辑器中,当您指向转移上的注释徽章
时,文本显示为工具提示。当您将 IsExplicitlyCommented 属性设置为 false 时,CommentText 的值会还原为 ""。
图形外观
转移的源,指定为空数组或以下类型之一的 Stateflow API 对象:
转移端点在其源处的位置,指定为相对于图左上角的坐标的二元素数值向量 [x y]。
转移端点在其源处的位置,指定为 0 到 12 之间的标量,用于描述时钟位置。
转移的目标,指定为空数组或以下类型之一的 Stateflow API 对象:
转移端点在其目标处的位置,指定为相对于图左上角的坐标的二元素数值向量 [x y]。
转移端点在其目标处的位置,指定为 0 到 12 之间的标量,用于描述时钟位置。
转移中点的位置,指定为相对于图左上角的坐标的二元素数值向量 [x y]。
转移标签的位置和大小,指定为 [left top width height] 形式的四元素数值向量。
目标处的转移箭头大小,指定为标量。当您更改转移的目标时,此属性会重置为新目标的 ArrowSize 属性的值。
转移标签的字体大小,指定为标量。包含转移的图的 TransitionFont.Size 属性设置此属性的初始值。
调试
转移的调试器属性,指定为具有以下属性的 Stateflow.TransDebug 对象:
Breakpoints.WhenTested- 是否设置When Transition is Tested断点,指定为数值或逻辑值 1 (true) 或 0 (false)。Breakpoints.WhenValid- 是否设置When Transition is Valid断点,指定为数值或逻辑值 1 (true) 或 0 (false)。
有关详细信息,请参阅Set Breakpoints to Debug Charts。
示例: transition.Debug.Breakpoints.WhenTested = true;
示例: transition.Debug.Breakpoints.WhenValid = true;
代码生成
转移是否为变体转移,指定为数值或逻辑值 1 (true) 或 0 (false)。有关详细信息,请参阅Control Indicator Lamp Dimmer Using Variants。
层次结构
此 属性 为只读。
包含转移的图,指定为 Stateflow.Chart 对象。
此 属性 为只读。
转移的子查看器,指定为 Stateflow.Chart、Stateflow.State、Stateflow.Box 或 Stateflow.Function 对象。子查看器是您可以在其上以图形方式查看转移的图或子图。
此 属性 为只读。
包含转移的状态机,指定为 Stateflow.Machine 对象。
此 属性 为只读。
转移的父级在模型层次结构中的位置,指定为字符向量。
标识
转移的描述,指定为字符串标量或字符向量。
转移的文档链接,指定为字符串标量或字符向量。
转移的用户定义的标记,指定为任何类型的数据。
此 属性 为只读。
会话独立标识符,指定为整数标量。使用此属性区分转移与其父图中的其他对象。
此 属性 为只读。
唯一标识符,指定为整数标量。与 SSIdNumber 不同,每次启动新 MATLAB® 会话时都会重新分配此属性的值,并且在删除对象后可能会回收该值。
对象函数
示例
在图 ch 中添加将状态 s1 连接到状态 s2 的转移。
transition = Stateflow.Transition(ch); transition.Source = s1; transition.Destination = s2;
在转移 transition 上添加指定触发器、条件和条件动作的标签。
transition.LabelString = "trigger[guard]{action();}";
要提取转移标签指定的触发器、条件和条件动作,请输入:
trigger = transition.Trigger
trigger =
'trigger'condition = transition.Condition
condition =
'guard'action = transition.ConditionAction
action =
'action();'在 Stateflow.Chart 对象 ch 中创建一个 Stateflow.Transition 对象。
dt = Stateflow.Transition(ch);
将转移的目标设置为 Stateflow.State 对象 st。
dt.Destination = st; dt.DestinationOClock = 0;
将转移的源端点放置在目标端点上方 30 像素处。将转移的中点放置在目标端点上方 15 像素处。
dt.SourceEndPoint = dt.DestinationEndPoint-[0 30]; dt.MidPoint = dt.DestinationEndPoint-[0 15];

创建一个将子图内部结点连接到子图外部结点的超转移。

打开模型并访问图的 Stateflow.Chart 对象。
open_system("sfSupertransitionAPIExample") ch = find(sfroot,"-isa","Stateflow.Chart");
访问子图的 Stateflow.State 对象和各结点的 Stateflow.Junction 对象。
st = find(ch,"-isa","Stateflow.State"); j1 = find(st,"-isa","Stateflow.Junction"); j2 = find(ch,"-isa","Stateflow.Junction","-depth",1);
将子图的原始位置保存到临时工作区变量 subchartPosition。
subchartPosition = st.Position;
通过将子图的 IsSubchart 和 IsGrouped 属性设置为 false 将子图转换为普通状态。
st.IsSubchart = false;
Assertion failed: Deviant 'root deviant' not opened for transactions. Attempt to modify object of type 'StateflowDI.Junction' [id = -1 ] at kernel/deviant/Deviant.cpp:75:
st.IsGrouped = false;
当您将子图转换为普通状态时,它可能会更改大小以显示其内容。

添加将结点 j1 连接到结点 j2 的转移。
tr = Stateflow.Transition(ch); tr.Source = j1; tr.Destination = j2;

通过将状态的 IsSubchart 属性设置为 true 将状态还原为子图。将子图还原到其原始位置。
st.IsSubchart = true; st.Position = subchartPosition;

结点之间的转移现在是跨子图边界的超转移。
版本历史记录
在 R2006a 之前推出使用对象函数 commentedBy 和属性 IsCommented 调查注释掉的转移:
对象函数
commentedBy标识导致转移被注释掉的显式注释对象。属性
IsCommented指示转移是否被注释掉。此属性取代了对象函数isCommented。
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)