DOM API包括一组可以在生成报告时显示的消息。每当在生成报告期间创建文档元素或追加文档元素时,都会触发这些消息。
您可以定义在生成报告期间显示的其他消息。DOM API提供了以下类来定义消息:
ProgressMessage
DebugMessage
WarningMessage
ErrorMessage
DOM API提供了额外的类来处理报表消息调度和显示。它使用MATLAB®事件和侦听器来分派消息。根据指定DOM对象的事件数据分派消息。有关事件和监听器的介绍,请参见事件和监听器概念.
请注意
当您创建消息分派器时,DOM API将保持分派器直到当前MATLAB会话结束。删除消息事件监听器以避免在MATLAB会话期间重复报告消息对象。
这个例子展示了如何显示默认的DOM调试消息。使用类似的方法来显示其他类型的DOM报告消息。
属性创建消息调度程序MessageDispatcher.getTheDispatcher
方法。对所有消息使用相同的调度程序。
调度程序= MessageDispatcher.getTheDispatcher;
使用MessageDispatcher。过滤器
属性指定显示调试消息。
dispatcher.Filter.DebugMessagesPass = true;
使用MATLAB添加一个监听器addlistener
函数。指定调度程序对象、源和事件数据以及disp
函数,该函数指定要用于消息的事件数据和格式。
l = addlistener(调度程序,“消息”,...@ (src evtdata) disp (evtdata.Message.formatAsText));
包括删除侦听器的代码。将它放在生成报告的代码之后。
删除(左);
该报告显示调试消息。
进口mlreportgen.dom。*;d =文档(“测试”,“html”);调度程序= MessageDispatcher.getTheDispatcher;dispatcher.Filter.DebugMessagesPass = true;l = addlistener(调度程序,“消息”,...@ (src evtdata) disp (evtdata.Message.formatAsText));开放(d);p =段(“章”);p.Tag =“章标题”;p.Style = {CounterInc(“章”),...CounterReset (“表”),空格(“以前”)};追加(p, AutoNumber (“章”));追加(d, p);关闭(d);rptview (“测试”,“html”);删除(左);
此示例演示如何创建和分发进度消息。您可以对其他类型的消息(如警告)使用类似的方法。
创建消息调度程序。
调度程序= MessageDispatcher.getTheDispatcher;
使用MATLAB添加一个监听器addlistener
函数。
l = addlistener(调度程序,“消息”,...@ (src evtdata) disp (evtdata.Message.formatAsText));
使用Message.dispatch
方法。指定分派器对象和要分派的消息。这里的消息是一个被调用的调试消息章开始
,文档
对象d
是消息的来源。
调度(调度员,ProgressMessage (“章开始”, d));
在生成报告的代码之后包含删除侦听器的代码。
删除(左);
此报告使用此进度消息。
进口mlreportgen.dom。*;d =文档(“测试”,“html”);调度程序= MessageDispatcher.getTheDispatcher;l = addlistener(调度程序,“消息”,...@ (src evtdata) disp (evtdata.Message.formatAsText));开放(d);调度(调度员,ProgressMessage (“章开始”, d));p =段(“章”);p.Tag =“章标题”;p.Style = {CounterInc(“章”),...CounterReset (“表”),空格(“以前”)};追加(p, AutoNumber (“章”));追加(d, p);关闭(d);rptview (“测试”,“html”);删除(左);
MATLAB命令窗口显示进度消息,包括章开始
消息和DOM API默认分派的消息。