本页采用了机器翻译。点击此处可查看最新英文版本。

addDurationConstraint

为交互添加持续时间约束

自 R2025a 起

全页折叠

    语法

    durationConstraint = addDurationConstraint(start, end, expression)

    说明

    durationConstraint = addDurationConstraint(start, end, expression) 在 start 指定的起始事件和 end 指定的终止事件之间添加一个持续时间约束，表达式由 expression 指定。

    示例

    示例

    全部折叠

    此示例使用:

    打开实时脚本

    以编程方式创建一个序列图，描述行人在有交通信号灯的十字路口过马路的情景。

    要了解有关序列图的更多信息，请参阅以交互方式编写序列图。

    打开交通灯示例

    加载 TLExample 架构模型。

    model = systemcomposer.openModel('TLExample');

    TLExample architecture model with various components.

    创建一个名为 'InhibitCopy' 的新序列图。

    diagram = model.addInteraction('InhibitCopy');

    添加生命线

    为架构中的每个组件添加生命线。

    sourceLifeline = diagram.addLifeline('TLExample/source');
pollerLifeline = diagram.addLifeline('TLExample/poller');
switchLifeline = diagram.addLifeline('TLExample/switch');
lampLifeline = diagram.addLifeline('TLExample/lampController');
controllerLifeline = diagram.addLifeline('TLExample/controller');

    获取交互的根片段和根操作数。

    rootFragment = diagram.RootFragment;
rootOperand = rootFragment.Operands(1);

    添加消息和片段

    向根操作数添加两条消息。

    sourceToPollerMsg = rootOperand.addMessage(sourceLifeline, "switchout", pollerLifeline, "sw", "rising(sw-1){sw==1}");
pollerToSwitchMsg = rootOperand.addMessage(pollerLifeline, "switchEvent", switchLifeline, "switchEvent", "switchEvent{switchEvent==1}");

    向根操作数添加一个条件片段。

    altFrag = rootOperand.addFragment('Alt');

    为条件片段的每个操作数指定保护表达式。

    op1 = altFrag.Operands(1);
op1.Guard = "switch/inhibit==0";
op2 = altFrag.addOperand("switch/inhibit==1");

    向条件片段的第一个操作数添加两条消息。

    switchToLampControllerMsg1 = op1.addMessage(switchLifeline, "lampColor", lampLifeline, "switchPed", "switchPed{switchPed==1}");
switchToControllerMsg = op1.addMessage(switchLifeline, "switchPush", controllerLifeline, "pedRequest", "pedRequest");

    在条件片段的第二个操作数中添加一条消息。

    switchToLampControllerMsg2 = op2.addMessage(switchLifeline, "lampColor", lampLifeline, "switchPed", "switchPed{switchPed==2}");

    添加持续时间约束

    在条件片段第一个操作数中的两个消息之间添加一个持续时间约束。

    startEvent = switchToLampControllerMsg1.End;
endEvent = switchToControllerMsg.End;
expression = "t > 12msec";
durationConstraint = diagram.addDurationConstraint(startEvent, endEvent, expression);

    打开序列图

    打开新创建的序列图。

    open(diagram);

    Newly created sequence diagram called 'InhibitCopy'.

    输入参数

    全部折叠

    与持续时间约束开始相对应的消息事件，指定为 systemcomposer.interaction.MessageEvent 对象。

    与持续时间约束结束相对应的消息事件，指定为 systemcomposer.interaction.MessageEvent 对象。

    定义持续时间约束的表达式，指定为字符串。

    持续时间约束的表达式包含：

    • 表示观察持续时间的关键字。使用：t 或 duration。

    • 一个关系运算符。使用：>、<、>= 或 <=。

    • 一个时间值。

    • 一个时间单位。使用：sec、msec 或 usec。

    示例: duration < 10sec

    示例: 1 >= t > 3msec

    输出参量

    全部折叠

    添加的持续时间约束，以 systemcomposer.interaction.DurationConstraint 对象的形式返回。

    版本历史记录

    在 R2025a 中推出

    另请参阅

    工具

    函数

    对象

    主题