主要内容

addRow

R2026b

向模型顾问分析结果中添加表行

描述

addRow(ftObj,rowEntries) 在格式模板对象 ftObj 所表示的表的末尾插入一个新行,该行包含 rowEntries 中指定的数据。如果没有向表中添加数据,模型顾问就不会在结果中显示该表。

注意

在向表中添加表行之前,必须使用 setColTitles 方法指定列标题。

函数 addRow 用来格式化通过 Simulink® Check™ 得到的模型顾问分析结果中的表。有关详细信息,请参阅 Simulink Check。

有关如何在 MATLAB® 中使用表的信息,请参阅创建表并为其分配数据。

示例

示例

全部折叠

此示例演示了如何在模型顾问中创建表,设置表的标题和列,以及添加包含模型中模块信息的行。

使用 ModelAdvisor.FormatTemplate 创建一个类型为 'TableTemplate' 的格式模板对象。

ft = ModelAdvisor.FormatTemplate("TableTemplate");

指定表的标题。

setTableTitle(ft, {"Blocks in Model"});

在添加任何行之前,设置列标题。

setColTitles(ft, {"Index","Block Name"});

打开模型 vdp:

open_system("vdp");

找到模型中的所有模块,并将它们作为行添加到表中。

allBlocks = find_system("vdp");
for idx = 2:length(allBlocks)
    addRow(ft,{idx-1,allBlocks(idx)});
end

您可以在检查回调函数中(例如在 sl_customization 文件中)使用此逻辑。

function result = SampleStyleOneCallback(system)
ft = ModelAdvisor.FormatTemplate("TableTemplate");
setTableTitle(ft,{"Blocks in Model"});
setColTitles(ft,{"Index","Block Name"});
allBlocks = find_system("vdp");
for idx = 2:length(allBlocks)
    addRow(ft, {idx-1,allBlocks(idx)});
end
result = ft;
end

有关如何格式化检查结果的详细信息,请参阅定义自定义模型顾问检查。

输入参数

全部折叠

ModelAdvisor.FormatTemplate 对象,指定为格式模板的句柄。

表行项,指定为字符向量元胞数组或对象元胞数组。元胞数组中各项的顺序确定该项位于哪一列。

示例: {"Item 1","Item 2"}

版本历史记录

在 R2009a 中推出