一个控件,允许用户从提供的选项中进行选择,支持搜索和多选。
Description
组合框控件允许您显示项集合供用户选择。 通过 SelectMultiple 属性配置单选或多重选择模式。 此控件的关键属性是 Items、DefaultSelectedItems、SelectedItems、SelectMultiple 和 IsSearchable。
一般
Items – 包含控件中显示的项的数据源。 如果源具有多列,请将控件的 Value 属性设置为要显示的数据列。
在 PowerFX 函数中使用控件的 SearchText 属性可以动态筛选大型数据集。
例如:Items = Filter(<dataset>, StartsWith(<column name>, Combobox.SearchText))
AccessibleLabel – 屏幕阅读器标签。
Visible - 控件是显示还是隐藏。
行为
SelectMultiple – 允许用户选择一个项或多个项。
IsSearchable – 允许用户在选择前先搜索项。
DisplayMode – 指定此控件是否允许用户输入 (Edit)、仅显示数据 (View),或被禁用 (Disabled)。
大小和位置
X – 控件左边缘与其父容器(如果没有父容器,则为屏幕)左边缘之间的距离。
Y – 控件上边缘与其父容器(如果没有父容器,则为屏幕)上边缘之间的距离。
Width - 控件左边缘和右边缘之间的距离。
Height - 控件上边缘和下边缘之间的距离。
样式和主题
BasePaletteColor - 应用于控件的调色板。 这会影响呈现主题颜色的控件的所有表面。
Font - 文本中所显示的字体系列的名称。
FontSize - 控件上显示的文本的字号。 如果值为 NULL 或零,则按所选 Fluent 主题驱动字号。
FontColor - 控件中文本的颜色。
FontWeight - 控件中文本的粗细:Bold、Lighter、Normal 或 Semibold。
FontItalic - 控件中的文本是否为斜体。
FontUnderline - 在文本下方显示的线是否在控件上显示。
FontStrikethrough - 贯穿文本的线是否在控件上显示。
其他属性
OnChange – 当用户更改控件的值时执行的操作。
TextInputPlaceholder – 在未选中项目时向用户显示的说明文本。
MultiValueDelimiter - 如果用户选择多个项,您可以选择在项之间添加哪些分隔符,例如逗号。
ValidationState - 控件有两个状态:错误和无。 当选择错误状态时,控件的边框以红色突出显示。
DefaultSelectedItems – 用户选择不同值之前控件的初始值。