滑动开关
使用可自定义外观的开关更改参数或变量值
- 库:
Simulink / Dashboard /自定义块
描述
使用滑动开关块，在模拟之前或模拟期间更改连接变量或参数的值。当你使用滑动开关块，您可以自定义块的外观，使其看起来像系统中的真实交换机，并且您可以配置具有任意数量的状态的交换机来自定义行为。例如，您可以设计一个三向拨动开关或一个代表换挡的开关。使用滑动开关块与其他仪表板块一起创建模型的交互式仪表板。
双击滑动开关块在模拟过程中或选定块时不会打开其对话框。要编辑块参数，您可以使用属性检查器或通过以下方式打开块对话框:
当块未被选中且模型未被模拟时，双击该块。
右键单击该块并进行选择块的参数从上下文菜单。
定制滑动开关块
当你添加滑动开关块到您的模型时，该块已预先配置为默认设计。您可以使用具有默认设计的块或自定义块的外观。设计开关时使用滑动开关块，你可以添加任意数量的状态到块。对于每个状态，您可以:
添加一个图像，用于定义该状态下块的外观。
指定要分配给连接的变量或参数的块的值。
指定状态的标签文本、颜色和位置，以及标签在块设计上是否可见。
配置状态单击区域的大小和位置。当您单击某个状态的单击区域时，块将转换到该状态。
您还可以设计块背景和前景，它们适用于所有状态。要配置块的前景，请上传前景图像。要配置块的背景，您可以上传背景图像或使用纯色背景。
要自定义块的外观，请使用设计模式。选择块后，可以通过以下三种方式之一进入设计模式:
在按钮选项卡,在设计,点击编辑．
在属性检查器，在设计选项卡上,单击编辑设计．
在块上方出现的省略号上暂停，然后单击编辑自定义块按钮。
设计模式允许您访问块参数和设置，这些参数和设置允许您自定义块的外观。您可以使用该块上方的工具栏为每个状态配置图像、图标、标签颜色和不透明度。有关更多自定义选项，请使用设计选项卡在属性检查器。
完成交换机设计后，单击退出，以退出设计模式。
连接仪表板块
仪表板块不使用端口连接到模型元素。要将仪表板块连接到变量和块参数，请使用连接模式。连接模式简化了在模型中连接仪表板块的过程，特别是当您希望一次连接多个块时。要连接单个指示板块，还可以使用连接表中的信息。
提示
在正常模式和加速模式模拟期间，可以在模型中修改仪表板块连接。
请注意
在更新模型图之前，仪表板块无法连接到变量。若要将仪表板块连接到变量或在打开模型和运行模拟之间修改变量值，请使用Ctrl + D．
要进入连接模式，请在画布中选择要连接的仪表板块。关于Simulink®工具条中，将出现一个以所选块的类型命名的选项卡。在块选项卡上，单击连接．在连接模式下，当您选择一个或多个块时，将显示用于连接的参数和变量列表。从列表中选择一个变量或参数，以连接到选定的仪表板块。
当所选变量或块参数的值是非标量时，请使用控件底部的文本框连接表来指定要连接到仪表板块的元素。要连接到向量、矩阵或数组的元素，请指定元素索引，例如，3.或(1、3)．要连接到总线或结构中的元素，请在总线或结构层次结构的上下文中指定元素，方法是使用圆点表示层次结构中的不同级别，并省略顶层。例如，指定a.b连接到标量元素b结构或总线的一个嵌套在所选复合变量或参数内。
要连接另一个仪表板块，请在另一个仪表板块上暂停，然后单击连接按钮在上面。然后，在模型中选择信号和块，并选择一个要连接的模型元素。
当您完成连接模型中的仪表板块时，在块选项卡上单击完成连接．
提示
控件可以隐藏未连接块上显示的消息set_param函数与ShowInitialText块参数。当您连接块时，消息也会消失。
参数记录
连接到仪表板块的可调参数被记录到模拟数据检查器，在那里您可以查看参数值以及记录的信号数据。您可以在MATLAB中访问记录的参数数据®方法从仿真数据检查器中导出参数数据Simulink.sdi.exportRun函数。有关使用模拟数据检查器UI导出数据的详细信息，请参见将数据导出到工作区或文件．参数数据存储在Simulink.SimulationData.Parameter对象，可作为导出对象中的元素访问Simulink.SimulationData.Dataset．
限制
除了仪表板范围Block和显示块，仪表板块只能连接到真正的标量信号。
工具条不支持面板内的块。
您不能使用连接表将仪表板块连接到注释掉的块。当使用连接模式将仪表板块连接到注释块时，在取消注释该块之前，仪表板块不会显示连接的值。
仪表板块不能连接到引用模型中的模型元素。
当模拟模型层次结构时，引用模型中的仪表板块不会更新。
仪表盘块不支持快速加速器模拟。
在模拟期间将仪表板块连接到变量或参数时，该变量或参数的数据不会记录到模拟数据检查器。若要将变量和参数数据记录到模拟数据检查器，请在模拟之前将仪表板块连接到变量或参数。
类在外部模式下模拟模型时默认参数行为设置为内联，仪表板块可以显示更改参数和变量值。但是，更改不会传播到模拟中。例如,获得控件所做的更改获得参数使用仪表板块，但是获得在模拟中使用的值不会更改。
参数
使用属性检查器和块参数对话框指定块参数的值。若要设置仪表板块的核心参数，请使用“块参数”对话框或参数选项卡在属性检查器。要自定义块，请使用设计选项卡在属性检查器。若要显示某块的“块参数”对话框，请双击该块。控件上显示属性检查器建模选项卡,在设计中,选择属性检查器．
参数
要设置仪表板块的核心参数，请打开属性检查器并单击参数选项卡。
连接连接—选择要连接的变量或块参数
变量和参数连接选项
使用连接表中选择或更改要控制的变量或块参数。将块连接到一个变量或块参数:
如果块未连接，则在“属性检查器”中参数选项卡上,单击连接打开“块参数”对话框。如果该块已经连接，并且您想要更改其连接的信号，请单击改变．
在模型中选择一个块。
选择要连接的变量或参数。
当所选变量或块参数的值是非标量时，请使用控件底部的文本框连接表来指定要连接到仪表板块的元素。要连接到向量、矩阵或数组的元素，请指定元素索引，例如，
3.或(1、3)．要连接到总线或结构中的元素，请在总线或结构层次结构的上下文中指定元素，方法是使用圆点来指示层次结构中的不同级别。省略顶层。例如，指定a.b连接到标量元素b结构或总线的一个嵌套在所选复合变量或参数内。点击应用．
为了帮助理解和调试模型，您可以在模拟期间将仪表板块连接到模型中的变量和参数。
请注意
要查看连接表中的工作区变量，请使用更新模型图Ctrl + D．
提示
还可以使用绑定模式选择或更改要控制的变量或块参数。使用实例进入绑定模式。
如果您处于设计模式，请单击编辑按钮。设计属性检查器的选项卡。
单击画布中的仪表板块。如果仪表盘块没有连接，连接
仪表盘块上出现一个省略号。如果仪表板块已经连接，则只显示省略号。如果仪表盘块未连接，单击连接．如果仪表板块已连接，则在省略号上暂停。在展开的操作菜单中，单击连接．在任何一种情况下，都将显示用于连接的参数和变量列表。
使用实例以绑定模式连接仪表盘块。
从列表中选择要连接的变量或参数。
单击，退出绑定模式完成连接
在仪表盘上。
编程使用
若要以编程方式将仪表板块连接到可调参数或变量，请使用Simulink.HMI.ParamSourceInfo对象。的Simulink.HMI.ParamSourceInfo对象包含四个属性。有些属性适用于将仪表板块连接到参数。有些属性适用于将仪表板块连接到变量。并非所有字段都有连接的值，因为给定的仪表板块连接到一个参数或一个变量。
块参数:绑定 |
类型:Simulink.HMI.ParamSourceInfo |
默认值:［］ |
标签-显示连接元件名称的标签位置
隐藏(默认)|底|前
可以在位于块顶部或底部的标签中显示指示板块连接的元素的名称，也可以隐藏该标签。如果希望标签可见，请指定块的位置。如果不希望标签可见，请指定隐藏．
请注意
当仪表板块未连接到元素时，标签为空白。
编程使用
块参数:LabelPosition |
| 类型:特征向量 |
价值观:“隐藏”|“底”|“高级” |
默认值:“隐藏” |
锁定长宽比-选项保持块纵横比
在(默认)|从
启用此选项可在调整Simulink画布中的块大小时保持纵横比。
提示
当长宽比被锁定时，添加一个新的背景图像将改变块的长宽比以匹配背景图像。
当长宽比未锁定时，添加新的背景图像不会改变块的比例，而是拉伸或缩放背景图像以适应块的大小。
州-价值与标签的配对
标量和字符向量
每个州对一个状态值与一个状态标签．当块处于给定状态时，它分配状态值对于连接的变量或参数的状态。您可以使用状态标签显示分配给块上连接的变量或参数的值，或提供描述性文本标签。
缺省情况下，开关有两种状态，分别对应于每个开关位置:
在
从状态时，块为连接的变量或参数赋值0．在
在状态时，块为连接的变量或参数赋值1．
您可以使用可定制的开关块来设计状态数大于或等于1的开关。要添加新状态，请单击+按钮。若要删除当前状态，请单击-按钮。
提示
在设计模式下，除了值和标签，还可以为状态配置各种其他参数。例如，您可以选择当交换机处于状态时将出现在交换机上的图像。在设计模式下配置参数。
进入设计模式。在属性检查器中设计选项卡，单击编辑按钮。
在设计选项卡，打开州组件，展开选择状态部分，然后从下拉菜单中选择要配置的状态。
为所选状态配置参数值，可以使用块上方的工具栏或州组件设计选项卡在属性检查器。
编程使用
配置州属性的值州形参作为包含两个带字段的元素的结构数组:
价值—状态的标量double值。标签—用于作为开关位置标签的字符串或字符数组。
leftState。价值= 0; leftState.Label =“关闭”；rightState。Value = 1;rightState。标签=“上”；switchStates = [leftState];
块参数:州 |
| 类型:结构的两元阵列 |
设计
若要自定义仪表板块，请打开“属性检查器”，单击设计选项卡，单击编辑．
开关锁定长宽比-选项保持块纵横比
在(默认)|从
启用此选项可在调整Simulink画布中的块大小时保持纵横比。
提示
当长宽比被锁定时，添加一个新的背景图像将改变块的长宽比以匹配背景图像。
当长宽比未锁定时，添加新的背景图像不会改变块的比例，而是拉伸或缩放背景图像以适应块的大小。
选择状态—状态管理和配置
标量和字符向量
每个州对一个状态值与一个状态标签．当块处于给定状态时，它分配状态值对于连接的变量或参数的状态。您可以使用状态标签显示分配给块上连接的变量或参数的值，或提供描述性文本标签。
缺省情况下，开关有两种状态，分别对应于每个开关位置:
在
从状态时，块为连接的变量或参数赋值0．在
在状态时，块为连接的变量或参数赋值1．
您可以使用可定制的开关块来设计状态数大于或等于1的开关。要添加新状态，请单击+按钮。若要删除当前状态，请单击X按钮。
中配置状态州组件，展开选择状态部分并选择状态。
中所选状态的值、标签文本和各种其他参数州组件设计选项卡在属性检查器。例如，您可以选择当交换机处于状态时将出现在交换机上的图像。
中参数值所做的所有更改州组件仅应用于所选状态。中配置不同的状态选择状态节中，在下拉菜单中选择状态。中配置该状态的参数值州组件。
提示
或者，你可以:
使用设计模式下出现在开关块上方的工具栏配置所选状态的参数
属性配置块状态的值和标签文本参数选项卡在属性检查器
编程使用
配置州属性的值州形参作为包含两个带字段的元素的结构数组:
价值—状态的标量double值。标签—用于作为开关位置标签的字符串或字符数组。
leftState。价值= 0; leftState.Label =“关闭”；rightState。Value = 1;rightState。标签=“上”；switchStates = [leftState];
块参数:州 |
| 类型:结构的两元阵列 |
价值-状态值
标量
每个州对一个状态值与一个状态标签．指定状态值控件中选择的状态设计选项卡。
文本-状态标签文本
字符串|字符数组
每个州对一个状态值与一个状态标签．属性的文本状态标签中所选状态的设计选项卡。
标签的颜色-按钮标签字体颜色
[r g b]向量
从标准颜色调色板中为按钮标签选择字体颜色，或指定自定义颜色。控件中所选状态的按钮标签应用的颜色选择状态部份州组件设计选项卡。
标签X偏移量-文本中心从块左边缘的水平偏移
标量
对象中心的水平偏移量状态标签从块的左边缘作为块宽度的比例。相对于文本位置时的偏移量为0，带负值的偏移量将文本向左移动，带正值的偏移量将文本向右移动。
标签Y偏移量-文本中心从块的上边缘的垂直偏移
标量
对象中心的垂直偏移量状态标签从块的顶部边缘作为块的高度的比率。相对于文本位置时的偏移量为0，带负值的偏移量将文本向上移动，带正值的偏移量将文本向下移动。
图像X偏移量-图像左边缘与块左边缘的水平偏移
标量
指定图像的左边缘与块的左边缘的水平偏移量，作为块宽度的比率。相对于图像位置时的偏移量为0，负值的偏移量将图像向左移动，正值的偏移量将图像向右移动。
例子:1
图像Y偏移-图像的上边缘与块的上边缘的垂直偏移
标量
指定图像的上边缘与块的上边缘的垂直偏移量，作为块高度的比率。相对于图像位置时的偏移量为0，偏移量为负值时，图像向上移动，偏移量为正值时，图像向下移动。
例子:1
宽度-图像宽度
标量
指定图像宽度为块宽度的比率。
例子:0．5
高度-图像高度
标量
指定图像高度为块高度的比率。
例子:0．5
锁定长宽比-选项保持图像纵横比
在(默认)|从
启用此选项可在使用属性检查器调整图像大小时保持纵横比。
单击“区域X偏移量”-点击区域左边缘与块左边缘的水平偏移
标量
指定单击区域的左边缘与块的左边缘的水平偏移量，作为块宽度的比率。相对于图像位置时的偏移量为0，负值的偏移量将图像向左移动，正值的偏移量将图像向右移动。
例子:1
单击“区域Y偏移量”-点击区域的上边缘与块的上边缘的垂直偏移
标量
指定单击区域的上边缘与块的上边缘之间的垂直偏移量，作为块高度的比率。相对于图像位置时的偏移量为0，偏移量为负值时，图像向上移动，偏移量为正值时，图像向下移动。
例子:1
宽度-点击区域宽度
标量
指定点击区域宽度为块宽度的比率。
例子:0．5
高度-点击区域高度
标量
指定单击区域高度为块高度的比例。
例子:0．5
使用背景色-选项指定纯块背景颜色
从(默认)|在
对于块背景，您可以提供背景图像或选择纯色。若要选择纯色背景，请选择此参数。若要提供背景图像，请清除此参数。
请注意
控件更改背景颜色格式选项卡将删除背景图像并启用使用背景色参数。
例子:在
颜色-块背景色
[r g b]向量
若要选择纯色背景颜色，请启用使用背景色参数。然后，从标准颜色的调色板中选择背景色，或指定自定义颜色。
提示
还可以指定背景颜色在格式选项卡中的Simulink工具条。
要指定块文本的颜色，请使用字体颜色参数。
编程使用
指定写成BackgroundColor参数作为块的参数1——- - - - - -3.[r g b]值为0而且1它被格式化为字符串或字符向量。
块参数:写成BackgroundColor |
| 类型:字符向量|字符串 |
价值观:[r g b]向量 |
不透明度-块背景不透明度
1(默认)|标量
指定块背景不透明度为从0到1的标量值。
例子:0．5
刀尖圆弧半径-区域的角半径与块背景颜色
标量
指定块背景色所覆盖区域的角半径为两个块尺寸(宽度或高度)中较小尺寸的一半之比。
例子:０．２５
图像X偏移量-图像左边缘与块左边缘的水平偏移
标量
指定图像的左边缘与块的左边缘的水平偏移量，作为块宽度的比率。相对于图像位置时的偏移量为0，负值的偏移量将图像向左移动，正值的偏移量将图像向右移动。
例子:1
图像Y偏移-图像的上边缘与块的上边缘的垂直偏移
标量
指定图像的上边缘与块的上边缘的垂直偏移量，作为块高度的比率。相对于图像位置时的偏移量为0，偏移量为负值时，图像向上移动，偏移量为正值时，图像向下移动。
例子:1
宽度-图像宽度
标量
指定图像宽度为块宽度的比率。
例子:0．5
高度-图像高度
标量
指定图像高度为块高度的比率。
例子:0．5
锁定长宽比-选项保持图像纵横比
在(默认)|从
启用此选项可在使用属性检查器调整图像大小时保持纵横比。
模型的例子
块特征
数据类型 |
|
直接引线 |
|
多维信号 |
|
适应信号 |
|
讨论二阶导数过零检测 |
|
扩展功能
版本历史
R2021b中引入
您也可以从以下列表中选择一个网站: