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

ModelAdvisor.Text

创建模型顾问文本输出

全页展开

说明

使用 ModelAdvisor.Text 对象创建格式化文本，以便在模型顾问输出中显示。

创建对象

语法

textObj = ModelAdvisor.Text
textObj = ModelAdvisor.Text(attribute)
textObj = ModelAdvisor.Text(content,attribute)

描述

textObj = ModelAdvisor.Text 创建一个默认文本对象，用于在模型顾问输出中显示。默认文本对象不包含任何文本，但您可以设置对象的属性来自定义要显示的文本。

示例

textObj = ModelAdvisor.Text(attribute) 创建一个文本对象，用于在模型顾问输出中显示。

示例

textObj = ModelAdvisor.Text(content,attribute) 创建一个文本对象，该对象使用 attribute 中的文本样式显示内容中的文本。

示例

输入参量

全部展开

要显示的文本，指定为字符串标量或字符向量。默认情况下，内容为空，文本对象不会在模型顾问输出中显示任何文本。

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

示例: "Check passed"

示例: "bold"

文本格式，以字符向量的元胞数组指定，其中包含文本内容的格式选项。默认情况下，attribute 为 {"normal"}，并且该对象在模型顾问输出中显示未格式化的黑色文本。可能的格式选项包括：

  • "normal"（默认值）- 文本为黑色且非格式化。

  • "bold" - 文本显示为粗体。

  • "italic" - 文本显示为斜体。

  • "underline" - 文本带下划线。

  • "pass" - 文本显示为绿色。

  • "warn" - 文本显示为黄色。

  • "fail" - 文本显示为红色。

  • "keyword" - 文本显示为蓝色。

  • "subscript" - 文本具有下标。

  • "superscript" - 文本具有上标。

输出参量

全部展开

模型顾问输出的文本，以 ModelAdvisor.Text 对象的形式返回。

对象函数

setBold在模型顾问分析结果中将文本设置为粗体
setColor在模型顾问分析结果中设置文本颜色
setHyperlink在模型顾问分析结果中将文本设置为超链接
setItalic在模型顾问分析结果中将文本设置为斜体样式
setRetainSpaceReturn在模型顾问分析结果中保留空格和换行符
setSubscript在模型顾问分析结果中将文本设置为下标
setSuperscript在模型顾问分析结果中将文本设置为上标
setUnderlined在模型顾问分析结果中将文本设置为带下划线

示例

全部折叠

打开实时脚本

在这个示例中，您可以创建和组合文本对象，以自定义模型顾问的文本输出。

在模型顾问中，文本是最简单的输出形式。您可以指定并设置输出文本的格式，以突出显示重要信息或提高可读性。

指定格式化文本

创建一个应用斜体的文本对象。

textObj = ModelAdvisor.Text("MySampleText",{"italic"})
textObj = 
  Text with properties:

              Hyperlink: ''
                 IsBold: 0
               IsItalic: 1
           IsUnderlined: 0
          IsSuperscript: 0
            IsSubscript: 0
           RetainReturn: 0
      RetainSpaceReturn: 0
    ContentsContainHTML: 1
                  Color: 'Normal'
              SpanClass: ''
                  title: ''
                Content: 'MySampleText'
                    Tag: ''
         IsSingletonTag: 0
          TagAttributes: {0×2 cell}
        CollapsibleMode: 'none'
          HiddenContent: []

合并多个格式选项

要在一条消息中应用不同的格式，请创建多个文本对象并将它们组合起来。

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

在检查回调函数中指定条件文本

为简单的检查回调函数应用不同类型的格式化。

function result = SampleStyleOneCallback(system)
% Get Model Advisor object for the current system
mdladvObj = Simulink.ModelAdvisor.getModelAdvisor(system);

% Check if the screen color of the Simulink model is white
if strcmp(get_param(bdroot(system),"ScreenColor"),"white")
    % If white, display a "Passed" message with pass formatting
    result = ModelAdvisor.Text("Passed",{"pass"});
    mdladvObj.setCheckResultStatus(true);
else
    % If not white, provide a recommendation and a clickable link
    msg1 = ModelAdvisor.Text("It is recommended that you 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 the screen color to white.");
    result = [msg1,msg2,msg3];
    mdladvObj.setCheckResultStatus(false);
end
end

版本历史记录

在 R2006b 中推出

另请参阅

主题