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

systemcomposer.interaction.Iterator

用于导航交互的迭代器实用工具

自 R2024a 起

全页展开

    说明

    Iterator 对象是一种实用工具，可按预定顺序访问交互中的每个元素。

    创建对象

    通过传入一个 systemcomposer.interaction.Fragment 对象作为作用域片段，来实例化一个 Iterator 对象。

    iterator = systemcomposer.interaction.Iterator(interaction.RootFragment)

    属性

    全部展开

    迭代器的范围，指定为 systemcomposer.interaction.Fragment 对象。

    迭代器是否仍然有效，指定为 1 (true) 或 0 (false)。当交互发生变化时，迭代器就会失效。您可以通过编辑和保存对当前序列图的更改来改变交互。

    数据类型: logical

    对象函数

    next返回片段中的下一个元素
    current返回当前访问过的片段元素
    reset重置迭代器

    示例

    全部折叠

    打开实时脚本

    您可以使用只读 API 工作流浏览 System Composer™ 中的序列图，并显示每个元素的相关信息。

    打开交通灯示例

    打开交通灯示例架构模型，以便直观地检查序列图并确认程序输出。

    model = systemcomposer.openModel("TLExample");

    要查看与模型关联的序列图，请在 System Composer 工具条上导航至建模 > 序列图。

    The press detection sequence diagram in the views gallery of the top model.

    以编程方式浏览序列图

    收集由 interactions 表示的序列图，其中包含模型中元素的特定交互。

    interactions = model.getInteractions;

    对于第一个交互，提取序列图的名称。

    disp("The first sequence diagram is called " + interactions(1).Name + ".")
    The first sequence diagram is called PressDetection.

    在该序列图中，显示每条生命线以及生命线所代表的组件。

    for i = 1:length(interactions(1).Lifelines)
    disp("The " + interactions(1).Lifelines(i).Name + ...
    " lifeline represents the " + ...
    interactions(1).Lifelines(i).RelatedElements.Name + ...
    " component.")
end
    The source lifeline represents the source component.
The poller lifeline represents the poller component.
The switch lifeline represents the switch component.

    显示根片段中一条消息的内容。

    disp("The sequence diagram message starting at the " + ...
    interactions(1).RootFragment.Operands.Fragments(1).Name + ...
    " message end is of type " + ...
    string(interactions(1).RootFragment.Operands.Fragments(1).Message.Type) + ...
    " and the message label is " + ...
    interactions(1).RootFragment.Operands.Fragments(1).Message.Condition + ".")
    The sequence diagram message starting at the switchout message end is of type Signal and the message label is rising(sw-1).

    使用迭代器实用工具逐步浏览序列图

    使用 Inhibit 实用工具逐步浏览 Iterator 序列图。

    interaction = model.getInteraction('Inhibit');
interaction.open

    Inhibit sequence diagram from the top model.

    显示交互中的注解。

    disp(interaction.Annotations.Content)
    When inhibit is true, it means pedestrian crossing is not controlled by a walk signal on this intersection.

    在提取序列图的属性之前，使用迭代器浏览序列图的所有元素。

    iterator = systemcomposer.interaction.Iterator(interaction.RootFragment);
next = iterator.next;
while ~isempty(next)
    disp(class(next))
    next = iterator.next;
end
    systemcomposer.interaction.RootFragment
systemcomposer.interaction.Operand
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.AltFragment
systemcomposer.interaction.Operand
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.Operand
systemcomposer.interaction.MessageEvent
systemcomposer.interaction.MessageEvent

    详细信息

    全部展开

    版本历史记录

    在 R2024a 中推出

    另请参阅

    工具

    函数

    对象

    主题