主要内容

ModelAdvisor.Text

创建模型顾问文本输出

说明

ModelAdvisor.Text 对象为模型顾问输出创建格式化文本。

创建对象

描述

text = ModelAdvisor.Text(content,attribute) 为模型顾问输出创建一个文本对象。

示例

输入参量

全部展开

(可选)指定文本对象内容的字符向量。如果 content 为空,则输出空文本。

(可选)指定内容格式字符向量的元胞数组。如果属性为空,则输出文本使用默认颜色。可能的格式选项包括:

  • normal(默认值)- 文本为黑色且非格式化。

  • bold - 文本显示为粗体。

  • italic - 文本显示为斜体。

  • underline - 文本带下划线。

  • pass - 文本显示为绿色。

  • warn - 文本显示为黄色。

  • fail - 文本显示为红色。

  • keyword - 文本显示为蓝色。

  • subscript - 文本具有下标。

  • superscript - 文本具有上标。

使用 MATLAB® char 命令添加 ASCII 和扩展 ASCII 字符。

对象函数

setBold在模型顾问分析结果中指定粗体文本
setColor在模型顾问分析结果中指定文本颜色
setHyperlink指定超链接文本
setItalic在模型顾问分析结果中指定斜体文本
setRetainSpaceReturnRetain spacing and returns in text
setSubscript指定下标文本
setSuperscript指定上标文本
setUnderlined对文本加下划线

示例

全部折叠

文本是最简单的输出格式。您可以用很多不同方式格式化文本。

当您要所有文本都使用一种格式时,请使用以下语法:

ModelAdvisor.Text(content, {attributes})

要应用多种类型的格式,您必须创建几个文本对象并将它们组合使用。

t1 = ModelAdvisor.Text('It is ');
t2 = ModelAdvisor.Text('recommended', {'italic'});
t3 = ModelAdvisor.Text(' to use same font for ');
t4 = ModelAdvisor.Text('blocks', {'bold'});
t5 = ModelAdvisor.Text(' for a uniform appearance in the model.');

result = ([t1, t2, t3, t4, t5]); 

下面是使用模型顾问格式 API 的简单检查回调函数的示例:

function result = SampleStyleOneCallback(system)
mdladvObj = Simulink.ModelAdvisor.getModelAdvisor(system);
if strcmp(get_param(bdroot(system), 'ScreenColor'),'white')
   result = ModelAdvisor.Text('Passed',{'pass'});
   mdladvObj.setCheckResultStatus(true); 
else
   msg1 = ModelAdvisor.Text(...
       ['It is recommended to select a Simulink window screen color'...
       ' of white for a readable and printable model. Click ']);
   msg2 = ModelAdvisor.Text('here');
   msg2.setHyperlink('matlab: set_param(bdroot,''ScreenColor'',''white'')');
   msg3 = ModelAdvisor.Text(' to change screen color to white.');
   result = [msg1, msg2, msg3];
   mdladvObj.setCheckResultStatus(false); 
end 

版本历史记录

在 R2006b 中推出