主要内容

显示进度和调试器消息

报告生成的消息

DOM API包括一组可以在生成报告时显示的消息。每当在生成报告期间创建文档元素或追加文档元素时,都会触发这些消息。

您可以定义在生成报告期间显示的其他消息。DOM API提供了以下类来定义消息:

  • ProgressMessage

  • DebugMessage

  • WarningMessage

  • ErrorMessage

DOM API提供了额外的类来处理报表消息调度和显示。它使用MATLAB®事件和侦听器来分派消息。根据指定DOM对象的事件数据分派消息。有关事件和监听器的介绍,请参见事件和监听器概念

请注意

当您创建消息分派器时,DOM API将保持分派器直到当前MATLAB会话结束。删除消息事件监听器以避免在MATLAB会话期间重复报告消息对象。

显示DOM默认消息

这个例子展示了如何显示默认的DOM调试消息。使用类似的方法来显示其他类型的DOM报告消息。

  1. 属性创建消息调度程序MessageDispatcher.getTheDispatcher方法。对所有消息使用相同的调度程序。

    调度程序= MessageDispatcher.getTheDispatcher;
  2. 使用MessageDispatcher。过滤器属性指定显示调试消息。

    dispatcher.Filter.DebugMessagesPass = true;
  3. 使用MATLAB添加一个监听器addlistener函数。指定调度程序对象、源和事件数据以及disp函数,该函数指定要用于消息的事件数据和格式。

    l = addlistener(调度程序,“消息”...@ (src evtdata) disp (evtdata.Message.formatAsText));
  4. 包括删除侦听器的代码。将它放在生成报告的代码之后。

    删除(左);

该报告显示调试消息。

进口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”);删除(左);

创建并显示进度消息

此示例演示如何创建和分发进度消息。您可以对其他类型的消息(如警告)使用类似的方法。

  1. 创建消息调度程序。

    调度程序= MessageDispatcher.getTheDispatcher;
  2. 使用MATLAB添加一个监听器addlistener函数。

    l = addlistener(调度程序,“消息”...@ (src evtdata) disp (evtdata.Message.formatAsText));
  3. 使用Message.dispatch方法。指定分派器对象和要分派的消息。这里的消息是一个被调用的调试消息章开始,文档对象d是消息的来源。

    调度(调度员,ProgressMessage (“章开始”, d));
  4. 在生成报告的代码之后包含删除侦听器的代码。

    删除(左);

此报告使用此进度消息。

进口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默认分派的消息。

另请参阅

功能