主要内容

Stateflow.Transition

R2026b

图、状态、框或函数中的转移

    描述

    使用 Stateflow.Transition 对象创建从一个工作模式到另一个工作模式的转移。有关详细信息,请参阅工作模式之间的转移。

    创建对象

    描述

    transition = Stateflow.Transition(parent) 在父图、状态、框或图形函数中创建一个 Stateflow.Transition 对象。

    示例

    输入参量

    全部展开

    新转移的父级,指定为以下类型之一的 Stateflow® API 对象:

    属性

    全部展开

    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® 会话时都会重新分配此属性的值,并且在删除对象后可能会回收该值。

    对象函数

    getParent标识对象的父级
    commentedByIdentify objects that implicitly comment out a graphical object
    dialog打开属性对话框
    view在编辑环境中显示对象
    highlight突出显示图形对象
    fitToView放大图形对象

    示例

    全部折叠

    在图 ch 中添加将状态 s1 连接到状态 s2 的转移。

    transition = Stateflow.Transition(ch);
    transition.Source = s1;
    transition.Destination = s2;

    在转移 transition 上添加指定触发器、条件和条件动作的标签。

    transition.LabelString = "trigger[guard]{action();}";

    Transition with a trigger, a condition, and a condition 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 with a default transition leading to a state.

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

    A Stateflow chart with two junctions. One junction is inside a subchart, while the other is outside the subchart. The chart does not have transitions.

    打开模型并访问图的 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;

    当您将子图转换为普通状态时,它可能会更改大小以显示其内容。

    A Stateflow subchart that has been converted to a state. The state contains a junction. Outside of the state, there is a disconnected junction.

    添加将结点 j1 连接到结点 j2 的转移。

    tr = Stateflow.Transition(ch);
    tr.Source = j1;
    tr.Destination = j2;

    A junction inside a state connects to an exterior junction by using a transition.

    通过将状态的 IsSubchart 属性设置为 true 将状态还原为子图。将子图还原到其原始位置。

    st.IsSubchart = true;
    st.Position = subchartPosition;

    Stateflow chart with a subchart. A supertransition connects a junction inside the subchart to a junction outside the subchart.

    结点之间的转移现在是跨子图边界的超转移。

    版本历史记录

    在 R2006a 之前推出

    全部展开