主要内容

显示进度和调试消息

报告生成的消息

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.Filter属性来指定显示调试消息。

    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(dispatcher,“消息”,@ (src evtdata) disp (evtdata.Message.formatAsText));开放(d);p =段(“章”);p。标签=“章标题”;p。风格= {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。标签=“章标题”;p。风格= {CounterInc (“章”),CounterReset (“表”),空格(“以前”)};追加(p, AutoNumber (“章”));追加(d, p);关闭(d);rptview (“测试”,“html”);删除(左);

MATLAB命令窗口显示进度信息,包括章开始消息和DOM API分派默认的消息。

另请参阅

功能