Main Content

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

mlreportgen.ppt.MessageDispatcher 类

命名空间: mlreportgen.ppt

PPT 消 息调度程序

全页展开

描述

演示文稿生成状态消息的调度程序。

注意

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

mlreportgen.ppt.MessageDispatcher 类是一个 handle 类。

属性

全部展开

此只读属性指定一个过滤器，用于确定调度程序调度的消息类型。您可以通过设置过滤器的属性来控制发送的消息类型。

此 PPT API 对象的 ID，指定为字符向量或字符串标量。会话唯一 ID 是在对象创建过程中生成的。您可以指定一个 ID 来 替换生成的 ID。

属性：

NonCopyable
true

数据类型: char | string

此 PPT API 对象的标签，指定为字符向量或字符串标量。在创建此对象的过程中会生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。

指定您自己的标签值可以帮助您识别演示文稿生成过程中出现问题的位置。

属性：

NonCopyable
true

数据类型: char | string

方法

全部展开

示例

全部折叠

此示例显示如何在生成演示文稿时添加要显示的进度消息。

创建演示文稿。

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

创建侦听程序并将其添加到消息调度程序。

dispatcher = MessageDispatcher.getTheDispatcher;

dispatcher.Filter.ErrorMessagesPass = true;
dispatcher.Filter.ProgressMessagesPass = false;

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

在打开之前创建消息并发送。

msg = ErrorMessage('Invalid slide',pre);
dispatch(dispatcher, msg);

open(pre);

在程序中创建一个错误，并在打开演示文稿之前发送消息。

titleText = Text('This is a Title');
titleText.Style = {Bold};
replace(pre,'Title',titleText);

close(pre);

删除侦听程序以避免在 MATLAB 会话期间重复报告消息对象。

delete(l);

版本历史记录

在 R2015b 中推出

另请参阅

| | |

主题