向实时脚本添加交互式控件
R2026b您可以将滑块、微调器、下拉列表、复选框、编辑字段、按钮、文件浏览器、颜色选择器和日期选择器添加到您的实时脚本，以交互方式控制变量值。当您要与其他人共享实时脚本时，将交互式控件添加到实时脚本中非常有用。通过交互式控件，您可以使用熟悉的用户界面组件设置和更改实时脚本中变量的值。
插入控件
要将控件插入实时脚本中，请转至实时编辑器选项卡，在代码部分中，点击控件。然后，从可用选项中进行选择。要用控件替换现有值，请选择该值或将光标放在其旁边，然后插入控件。控件菜单仅显示所选值的可用选项。要配置控件，请在实时脚本中右键点击控件，然后选择配置控件。
如果您的实时脚本已包含一个控件，在某些情况下，您可以用具有类似功能的另一个控件替换该控件。要将一个控件替换为另一个控件，请右键点击该控件并选择替换为 Control Name。您也可以在实时脚本中选择该控件，转至实时编辑器选项卡，点击控件，然后从可用选项中进行选择。将一个控件替换为另一个控件会保留相关的配置值，如范围和默认值。
下表显示控件的完整列表。
| 控件 | 描述 | 配置详细信息 |
|---|---|---|
按钮
| 使用按钮控件，通过点击按钮以交互方式运行代码。 | 要更改按钮上显示的文本，请在标签部分输入标签文本。 要指定点击按钮时运行的代码，请在执行部分中指定运行选项。有关详细信息，请参阅修改控件执行。 |
复选框
| 使用一个复选框以交互方式将变量值设置为逻辑值 复选框的显示状态（选中或清除）确定其当前值。 | 不适用 |
颜色选择器 (自 R2023b 起)
| 使用颜色选择器以交互方式选择颜色。 颜色选择器中显示的颜色是其当前所选颜色。 | 在格式部分，从可用选项中进行选择，以在颜色选择器中指定颜色格式。有效格式包括：
|
日期选择器 (自 R2024a 起)
| 使用日期选择器以交互方式选择日期。 日期选择器中显示的日期是其当前所选日期。 | 在格式部分，从可用选项中进行选择，以在日期选择器中指定日期格式。 |
下拉列表
| 使用下拉列表，可以通过从项列表中进行选择，以交互方式更改变量的值。 将鼠标悬停在下拉列表中显示的任何项上可查看其值。 | 在项目 > 项目标签字段中，指定要为下拉列表中的每个项显示的文本。 在项目 > 项目值字段中，为下拉列表中的每个项指定值。确保将文本值用单引号或双引号引起来。 您也可以使用变量中存储的值来填充下拉列表中的项目。有关详细信息，请参阅将变量链接到控件值。 |
编辑字段
| 使用一个编辑字段以交互方式将变量值设置为指定类型的输入。 编辑字段中显示的文本和配置的数据类型决定其当前值。 | 在类型部分的数据类型字段中，从可用选项中进行选择，以指定编辑字段中文本的数据类型。 |
文件浏览器 (自 R2023a 起)
| 使用文件浏览器通过打开文件选择对话框以交互方式选择文件，或通过打开文件夹选择对话框以交互方式选择文件夹。 编辑字段中显示的文本决定其当前值。 | 在类型部分中，选择文件以使用文件浏览器选择文件，或选择文件夹以使用文件浏览器选择文件夹。 要在“选择文件”按钮旁边显示文本，请在标签部分输入标签文本。 |
范围滑块 (自 R2024b 起)
| 使用范围滑块以交互方式选择范围，方法是将左右范围滑块移至所需的最小和最大范围值。 范围滑块左侧的值是其当前值。 | 在值部分，指定最小值、最大值和步长，或从下拉列表中选择工作区变量。 有关使用变量指定范围滑块值的详细信息，请参阅将变量链接到控件值。 |
滑块
| 使用一个滑块，可以通过将滑块移至所需的数值，以交互方式更改变量的值。 滑块左侧的值是其当前值。 | 在值部分，指定最小值、最大值和步长，或从下拉列表中选择工作区变量。 有关使用变量指定滑块值的详细信息，请参阅将变量链接到控件值。 |
微调器
| 通过点击值右侧的向上和向下箭头按钮，使用微调器以交互方式增加或减少变量值。也可以在数值编辑字段中为微调器输入数值。 数值编辑字段中的值是微调器的当前值。 | 在值部分，指定最小值、最大值和步长，或从下拉列表中选择工作区变量。 有关使用变量指定微调器值的详细信息，请参阅将变量链接到控件值。 |
状态按钮 (自 R2023b 起)
| 使用状态按钮，通过点击按钮开或关，以交互方式设置逻辑变量值。 状态按钮的显示状态（按下或未按下）确定其当前值。 | 要更改状态按钮上显示的文本，请在标签部分输入标签文本。 |
变量选择器 (自 R2026b 起)
| 使用变量选择器可以通过交互方式选择工作区变量，或将变量的值设置为工作区变量。 所选变量的值就是变量选择器的当前值。 | 要在变量选择器中仅显示特定类型的变量，请在项目 > 数据类型字段中，选择要显示的变量的数据类型。例如，选择逻辑以仅显示逻辑变量，或选择全部以显示所有变量。 要使用正则表达式指定要显示的变量类型，请选择正则表达式，并在下方的文本字段中指定正则表达式。 |
修改控件标签
您可以隐藏实时脚本中的代码，只显示格式化文本、带标签的控件、任务和输出。在共享和导出实时脚本时，隐藏代码非常有用。要隐藏代码，请点击实时脚本右侧的“隐藏代码”按钮 。您也可以转至视图选项卡，在视图部分中，点击隐藏代码。要再次显示代码，请点击“内嵌输出”按钮 或“右侧输出”按钮 。
当代码隐藏时，标签显示在控件旁边。要修改控件的标签，请右键点击该控件并选择配置控件。然后，在标签部分，输入标签文本。标签文本也是所有视图中按钮控件上显示的文本。按 Tab 或 Enter 键，或在控件配置菜单外部点击以返回实时脚本。
指定默认值
您可以设置一些控件的默认值，包括滑块、微调器、下拉列表、复选框、编辑字段、状态按钮、颜色选择器、日期选择器和变量选择器。
要设置控件的默认值，请右键点击该控件并选择配置控件。然后，在默认值部分，通过输入值或从列表中选择工作区变量来指定默认值。列表只显示控件的有效变量。对于下拉列表和变量选择器，从项目列表中选择默认值。
要还原控件的默认值，请右键点击该控件并选择还原默认值。要还原实时脚本中所有控件的默认值，请右键点击实时脚本中的任一控件，然后选择还原所有控件的默认值。
将变量链接到控件值
您可以将工作区变量链接到滑块值、微调器值和下拉项目，以创建动态控件。您也可以将工作区变量链接到滑块、微调器、复选框、编辑字段和状态按钮的默认值。
滑块和微调器
要使用工作区变量指定滑块或微调器的最小值、最大值和步长值，请右键点击控件并选择配置控件。在值部分中，选择变量，然后为最小值、最大值和步长选择工作区变量。下拉列表中只显示具有数值的变量。
如果要选择的变量未列出，请运行实时脚本以在工作区中创建它们。对所选变量的更改会自动反映在滑块或微调器中。
在 R2026a 之前的版本中: 仅支持类型为双精度的数值变量。
下拉列表
要使用工作区变量中存储的值填充下拉列表，请右键点击控件并选择配置控件。然后，在项目部分，从变量列表中选择工作区变量。只有包含字符串数组、分类数组、字符数组、元胞数组或数值数组的变量才会出现在列表中。
如果要选择的变量未列出，请运行实时脚本以在工作区中创建它。对所选变量的更改会自动反映在下拉列表中。
在 R2024b 之前的版本中: 仅支持字符串数组。
例如，创建一个实时脚本，并定义一个包含姓氏列表的变量 lastnames。
lastnames = ["Houston","Vega","Obrien","Potter","Rivera","Hanson","Fowler","Tran","Briggs"];
运行实时脚本以在工作区中创建 lastnames。然后，转至实时编辑器选项卡，在代码部分中，选择控件 > 下拉列表。在控件配置菜单的项目部分中，选择 lastnames 作为变量。
关闭配置菜单以返回到实时脚本。下拉列表现在包含在 lastnames 中定义的姓氏。
如果您在 lastnames、MATLAB® 更新中添加、删除或编辑值，下拉列表中的项会更新。
注意
如果下拉列表中的项目链接到某个变量，而实时脚本在运行时删除了该变量中的一个或多个值，这时如果删除的值中包含所选列表项，就会发生错误。为了最大限度地减少出现此错误的可能性，请避免在实时脚本运行时从链接的变量中删除值。
默认值
要使用工作区变量指定滑块、微调器、复选框、编辑字段或状态按钮的默认值，请右键点击该控件并选择配置控件。在默认值部分中，选择变量，然后选择工作区变量。只有具有该控件值有效值的变量才会出现在下拉列表中。例如，滑块和微调器仅显示具有数值的变量。编辑字段仅显示其值与指定文本数据类型匹配的变量。
当您将控件的默认值设置为工作区变量时，该控件会链接到该变量。控件值会随着变量值的变化而自动更新。该链接会保持活动状态，直到手动更改控件值为止，例如通过移动滑块。
修改控件执行
您可以修改当控件的值发生变化时代码运行的时间和内容。默认情况下，当控件的值发生变化时，MATLAB 会运行当前节中的代码。要配置此行为，请右键点击该控件并选择配置控件。然后，在执行部分，修改表中所述的字段的值。按 Tab 或 Enter 键，或在控件配置菜单外部点击以返回实时脚本。
| 字段 | 选项 |
|---|---|
| 运行位置（仅限滑块和微调器） | 选择以下选项之一来指定代码运行的时间：
|
| 运行 | 选择以下选项之一，以指定当控件的值更改时运行的代码：
提示 在实时脚本中使用按钮控件时，可以考虑将实时脚本中所有其他控件的运行字段设置为无内容。这样，代码仅在用户点击按钮控件时运行。当实时脚本要求在运行代码之前设置多个控件值时，这会很有用。
|
共享实时脚本
实时脚本完成后，可与其他人共享。用户可以在 MATLAB 中打开实时脚本，并以交互方式使用控件来对其进行试验。
如果您将实时脚本作为交互式文档共享，请考虑在共享实时脚本之前隐藏其中的代码。当代码隐藏时，仅显示格式化文本、带标签的控件、任务和输出。如果实时脚本中的任务配置为仅显示代码而不显示控件，则当您隐藏代码时，该任务不会显示。要隐藏代码，请点击实时脚本右侧的“隐藏代码”按钮 。您也可以转至视图选项卡，在视图部分中，点击隐藏代码。
如果您将实时脚本共享为 PDF 文件、Microsoft® Word 文档、HTML 文件、LaTeX 文件、Markdown 文件或 Jupyter® Notebook 文件，MATLAB 会将控件保存为代码。例如，如果 使用多个交互式控件创建实时脚本 示例实时脚本导出为 HTML（使用实时编辑器选项卡上的导出选项），文件浏览器控件将替换为其当前值 ("patients.xls")，下拉列表控件将替换为其当前值 (locationStrings(1))，复选框控件将替换为其当前值 (false)，滑块控件将替换为其当前值 (31)，文本框控件将替换为其当前值 ("e")。滤波数据按钮未显示。
