ModelAdvisor.Text

创建模型顾问文本输出

全页展开

说明

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

创建对象

语法

text = ModelAdvisor.Text(content,attribute)

描述

示例

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

输入参量

全部展开

`content` — 文本对象内容
字符向量

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

`attribute` — （可选）元胞数组
normal (默认) | 字符向量 | 字符向量元胞数组

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

normal（默认值）- 文本为黑色且非格式化。
bold - 文本显示为粗体。
italic - 文本显示为斜体。
underline - 文本带下划线。
pass - 文本显示为绿色。
warn - 文本显示为黄色。
fail - 文本显示为红色。
keyword - 文本显示为蓝色。
subscript - 文本具有下标。
superscript - 文本具有上标。

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

对象函数

`setBold`	在模型顾问分析结果中指定粗体文本
`setColor`	Specify text color in Model Advisor analysis results
`setHyperlink`	指定超链接文本
`setItalic`	在模型顾问分析结果中指定斜体文本
`setRetainSpaceReturn`	Retain spacing and returns in text
`setSubscript`	Specify subscripted text
`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