Main Content

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

mlreportgen.ppt.MessageEventData 类

命名空间: mlreportgen.ppt

保存触发消息事件的消息

全页展开

描述

包含触发消息事件的消息。

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

创建对象

描述

示例

messageEventDataObj = MessageEventData(msg) 创建一个包含 PPT 消息的消息事件数据对象，例如 mlreportgen.ppt.ProgressMessage 类型的消息。

PPT 消 息调度程度在分发消息时将该类型的对象附加到消息事件上。附加对象可使消息事件侦听程序检索已发送的消息。仅当您想创建自己的消息调度程序时才需要创建此类型的实例。

输入参量

全部展开

触发消息事件的消息对象，例如 mlreportgen.ppt.ProgressMessage 对象。

属性

全部展开

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

属性：

NonCopyable
true

数据类型: char | string

该只读属性的值是一个触发消息事件的 PPT 消 息对象，例如 mlreportgen.ppt.ProgressMessage 对象。

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

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

属性：

NonCopyable
true

数据类型: char | string

示例

全部折叠

当您添加调度程序时，PPT API 会创建 evtdata 对象，它是一个 mlreportgen.ppt.MessageEventData 对象。

创建演示文稿。

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);

版本历史记录

在 R2015a 中推出

另请参阅

主题