用户可以在其中提供的选项之间进行选择的控件。 支持搜索和多重选择。

使用 组合框 控件，可以搜索要选择的项。 由于在服务器端对 SearchField 属性执行搜索，因此性能不受大数据源影响。

单选或多重选择模式是通过 SelectMultiple 属性进行配置。

搜索要选择的项时，可以对所有项修改“数据”窗格中的“布局”设置，选择是显示一个数据值、两个数据值，还是一张图片和两个值（“人员”模板）。

在小屏幕上查看时，项目列表弹出项目将会变为一个全屏控件以提供更好的可用性。

如果要搜索带有 数字 的项，请使用 Text() 函数将数字转换为文本。 例如， Text(12345) 。

人员选取器

若要将 组合框 用作人员选取器，请从“数据”窗格的“布局”设置中选择 人员 模板，并配置要显示的如下人员相关数据属性。

Items – 提供待选选项的数据源。

DefaultSelectedItems – 用户与控件交互前的初始选定项。

Default 属性已弃用，请改为使用 DefaultSelectedItems 。

SelectedItems – 用户交互后的选定项列表。

SelectMultiple – 用户是能选择一个项，还是能选择多个项。

IsSearchable – 用户能否在选择前先搜索项。

IsSearchable 仅可以在包含至少一个文本字段的数据源上启用。 对于要使用搜索委派的查询， Items 表达式必须可委派。 即，不支持 Items 表达式中的 If 语句。

SearchFields – 用户输入文本时，所搜索的数据源的数据字段。

要对多个字段进行搜索，请以此格式设置 SearchFields 属性：["MyFirstColumn", "MySecondColumn"]。 仅支持文本字段。

AccessibleLabel – 屏幕阅读器标签。

BorderColor – 控件边框的颜色。

BorderStyle – 控件边框是 Solid 、 Dashed 、 Dotted 还是 None 。

BorderThickness – 控件边框的粗细。

DisplayFields – 针对搜索返回的每个项显示的字段列表。 通过“属性选项”选项卡中的“数据”窗格进行配置最为简单。

若要更新给定模板中的多个显示字段，请以此格式设置 DisplayFields 属性： ["MyFirstColumn", "MySecondColumn"] 。

DisplayMode – 此控件是允许用户输入 ( Edit )、仅显示数据 ( View )，还是已禁用 ( Disabled )。

FocusedBorderColor – 当聚焦到控件时，控件的边框颜色。

FocusedBorderThickness – 当聚焦到控件时，控件的边框粗细。

Height – 控件上边缘和下边缘之间的距离。

InputTextPlaceholder – 在未选中项目时向最终用户显示的说明文本。

OnChange – 当用户更改选择时要执行的操作。

OnNavigate – 当用户选择一个项目时要执行的操作。

OnSelect – 当用户点击或选择控件时要执行的操作。

TabIndex – 相对于其他控件的键盘导航顺序。

Visible – 控件显示还是隐藏。

Width – 控件左边缘和右边缘之间的距离。

X – 控件左边缘与其父容器（如果没有父容器，则为屏幕）左边缘之间的距离。

Y – 控件上边缘与其父容器（如果没有父容器，则为屏幕）上边缘之间的距离。

弹出项目边框属性由 Border 属性控制。

基本组合框

此示例中的步骤适用于任何 提供表的数据源 ，但要完全遵循这些步骤，请将环境与具有示例数据的 Microsoft Dataverse 数据库配合使用。

First(DataSource)
（可选）在标签中显示选定的帐户名称值
选择插入 > 文本标签，然后选择 Label。
将 Text 属性设置为该表达式，用下面的公式替换 Text：
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
If 语句将查看所选项目的存在方式，并在逗号分隔的标签中显示它们，为空时显示“无选定项”消息。
模拟简单下拉行为
通过将 IsSearchable 设置为 false，并将 SelectMultiple 设置为 false，您可以实现下拉菜单的相同功能。
选择插入 > Input，然后选择 组合框。
在屏幕右侧的属性窗格上，打开选择数据源列表（在Items旁边），然后添加或选择数据源。
在同一窗格中，选择编辑（位于字段旁边）。
在Data窗格中，打开主文本列表，然后选择要在 组合框 控件中显示的列。
将 IsSearchable 属性设置为 false。
将 SelectMultiple 属性设置为 false。
按住 Alt 键，选择向下箭头打开 组合框 控件。
控件将显示您在指定的数据源中指定的列中的数据。
“查找项目”文本已经消失，您将只能选择一个项目。
辅助功能准则
颜色对比度
在以下项之间必须有足够的颜色对比度：
ChevronFill 和 ChevronBackground
ChevronHoverFill 和 ChevronHoverBackground
SelectionColor 和 SelectionFill
SelectionFill 和 Fill
SelectionTagColor 和 SelectionTagFill
这是除标准颜色对比度以外的要求。
屏幕阅读器支持
AccessibleLabel 必须存在。
在触摸屏上，屏幕阅读器用户可以按顺序导航组合框中的内容。 组合框充当一个按钮，在选中时会显示或隐藏其内容。
TabIndex 必须为零或更大，以便键盘用户可以导航到它。
焦点指示器必须清晰可见。 可以使用 FocusedBorderColor 和 FocusedBorderThickness 来实现此目的。
Tab 键可导航到组合框或离开组合框。 箭头键可导航组合框中的内容。 Esc 键在打开时会关闭下拉列表。
			Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.		

        
提交和查看相关反馈