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

显示演示生成消息

表示生成消息

当您生成 PowerPoint® 演示文稿时，PPT API 可以显示消息。在演示文稿生成过程中，每次创建或追加演示文稿元素时都会触发消息。

您可以定义演示文稿生成时显示的附加消息。PPT API 提供了以下类用于定义消息：

  • ProgressMessage

  • DebugMessage

  • WarningMessage

  • ErrorMessage

PPT API 提供了用于处理演示消息调度和显示的附加类。它使用 MATLAB® 事件和侦听程序来发送消息。根据指定 PPT 对象的事件数据发送消息。有关事件和侦听程序的介绍，请参阅 事件和侦听程序概念。

注意

当您创建消息调度程序时，PPT API 会保留该调度程序直到当前 MATLAB 会话结束。为了避免在 MATLAB 会话期间重复报告消息对象，请删除消息事件侦听程序。

显示 PPT 默认消息

此示例显示如何显示默认的 PPT 调试消息。使用类似的方法显示其他类型的 PPT 演示消息。

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

    dispatcher = MessageDispatcher.getTheDispatcher;

  2. 要显示调试消息，请使用 MessageDispatcher.Filter 属性。

    dispatcher.Filter.DebugMessagesPass = true;

  3. 使用 MATLAB addlistener 函数添加侦听程序。指定调度程序对象、源和事件数据以及指定消息的事件数据和格式的 disp 函数。

    l = addlistener(dispatcher,"Message", ...
      @(src, evtdata) disp(evtdata.Message.formatAsText));

  4. 在生成演示文稿的代码后添加删除侦听程序的代码。

    delete(l);

此演示文稿显示调试消息。

import mlreportgen.ppt.*;

dispatcher = MessageDispatcher.getTheDispatcher;
dispatcher.Filter.DebugMessagesPass = true;

l = addlistener(dispatcher,"Message", ...
      @(src, evtdata) disp(evtdata.Message.formatAsText));

slides = Presentation("myMessagePresentation");
titleSlide = add(slides,"Title and Content");

p = Paragraph("Hello World:");
p.Style = {Bold(true)};
t = Text("  How are you?");
t.Bold = false;
append(p,t);


add(titleSlide,"Content",p);

close(slides);
     
delete(l);

创建并显示进度消息

此示例显示如何创建和发送进度消息。您可以对其他类型的消息（例如警告）使用类似的方法。

  1. 创建消息调度程序。

    dispatcher = MessageDispatcher.getTheDispatcher;

  2. 使用 MATLAB addlistener 函数添加侦听程序。 

    l = addlistener(dispatcher,"Message", ...
      @(src, evtdata) disp(evtdata.Message.formatAsText));

  3. 使用 Message.dispatch 方法发送消息。指定调度程序对象和要调度的消息。这里的消息是一个名为 firstSlide 的调试消息，而 Presentation 对象 slides 是该消息的来源。

    dispatch(dispatcher,ProgressMessage("firstSlide",slides));

  4. 在生成演示文稿的代码后添加删除侦听程序的代码。

    delete(l);

本演示使用了此进度消息。

import mlreportgen.ppt.*;
pre = Presentation("myPresentation.pptx");

dispatcher = MessageDispatcher.getTheDispatcher;
l = addlistener(dispatcher,"Message", ...
      @(src, evtdata) disp(evtdata.Message.formatAsText));


dispatch(dispatcher,ProgressMessage("starting presentation",pre));
open(pre);

titleText = Text("This is a Title");
titleText.Style = {Bold};

replace(pre,"Title",titleText);

close(pre);

delete(l);

另请参阅

函数

类