主要内容

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

mlreportgen.ppt.MessageDispatcher 类

命名空间: mlreportgen.ppt

PPT 消息调度程序

描述

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

注意

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

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

属性

全部展开

消息过滤器,用于确定调度程序调度的消息类型,指定为字符向量或字符串标量。您可以通过设置过滤器的属性来控制发送的消息类型。

属性:

GetAccess
public
SetAccess
protected
NonCopyable
true
Transient
true

数据类型: char | string

标记,指定为字符向量或字符串标量。PPT API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID,其中 CLASS 是对象类,ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符,指定为字符向量或字符串标量。PPT API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性:

GetAccess
public
SetAccess
public
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 中推出