包含其他控件并显示一组数据的控件。
Description
库控件可以显示数据源中的多个记录，每个记录可以包含多种类型的数据。 例如，使用 库 控件显示多个联系人，其中每个项目都显示包含姓名、地址和每个联系人的电话号码的联系人信息。
每个数据字段显示在 库 控件内的单独控件中。 还可以在其模板中配置这些控件。 该模板显示为库内的第一项：
- 在水平/横向方向 的库 控件的左边缘。
- 在垂直/纵向方向的 库 控件顶部。
在模板中所做的任何更改都会反映在 库 控件中。
提供了用于在库中显示图像和文本的预定义模板，以及用于可变高度项的库。
局限性
库控件具有以下限制：
- 如果用户在加载所有项之前滚动 灵活高度 库控件，则完成数据加载后，当前处于视图中的项可能会被下推和退出视图。 若要避免此问题，请使用标准 库 控件而不是 灵活高度 变体。
- 库中不支持以下控件：
- 如果后者已在另一个库内，则不能在另一个库中添加库。 嵌套的最大级别为 2。
- 最小 TemplateSize 为 1。 这可能会导致 库中 的控件因不考虑模板大小而偏离其预期的 X 或 Y 值。
- 如果从数据自动生成应用，保存应用，然后重新打开它，则浏览库可能不会立即显示任何数据。 若要解决此问题，请在搜索框中键入至少一个字符，然后删除键入的文本。 然后，库将按预期显示数据。
- 如果库包含 ComboBox、DatePicker、Slider 或 Toggle 控件，其规则修补
OnChange了库所在的数据源或集合，则可能会导致意外或降低性能。 这是因为，OnChange修补库数据源的规则可以创建永不结束的修补和重新加载周期。 为了避免此问题，建议不要在将这些控件放置在库中时使用OnChange规则。
键属性
默认值 – 启动应用时要从库中选择的数据源中的项或记录。
项 – 显示在控件（如库、列表或图表）中的数据源。
已选择 – 所选项。
其他属性
AccessibleLabel – 库的标签（而不是它包含的项目）用于屏幕阅读器。 应描述项列表。
AllItems – 库中加载的项。 这可能小于数据源的实际 项 数。 滚动库时可能会加载更多项。 AllItems 还包含每个库项中使用的控件。
AllItemsCount - 库中加载的项计数。 这可能小于数据源的实际 项 数。 滚动库时可能会加载更多项。
BorderColor – 控件边框的颜色。
BorderStyle – 控件的边框是 Solid、 Dashed、 Dotted 还是 None。
BorderThickness – 控件边框的粗细。
DelayItemLoading - 在屏幕首次加载之前延迟加载项目（行）。
DisplayMode – 控件是否允许用户输入（编辑）、仅显示数据（视图）或已禁用（已禁用）。
填充 – 控件的背景色。
高度 – 控件的上边缘和下边缘之间的距离。
ItemAccessibleLabel – 屏幕阅读器的每个库项的标签。 应描述每个项是什么。
LoadingSpinner （无、 控件 或 数据） - 无时，不会显示微调器。 控件时 |当呈现传递导致可见空行时，将显示数据旋转器。
LoadingSpinnerColor - 加载微调器的填充颜色。 默认值设置为 BorderColor。
NavigationStep – 如果库 的 ShowNavigation 属性设置为 true ，则库滚动的距离，并且用户在该库的任一端选择导航箭头。
可选择 – 是否可以选择库项。 如果设置为 true，屏幕阅读器会将库标识为可选择列表。 通过选择某个项来选择它。 设置为 false 时，屏幕阅读器会将库标识为常规列表，选择项不会将其选中。
ShowNavigation – 箭头是否显示在库的每个末尾，以便用户可以通过选择箭头滚动浏览库中的项。
ShowScrollbar – 当用户将鼠标悬停在库上时是否显示滚动条。
TemplateFill – 库的背景色。
TemplatePadding – 库中项之间的距离。
TemplateSize – 垂直/纵向样式库的模板高度。 或者采用水平/横向方向的库模板的宽度。 最小大小为 1。
切换 – 当用户将鼠标悬停在库中的项上时，视觉效果（Pop、 Push 或 None）。
可见 – 控件是显示还是隐藏。
宽度 – 控件的左边缘和右边缘之间的距离。
WrapCount – 基于水平布局或垂直布局显示每行或每列的项目数。
X – 控件的左边缘与其父容器或屏幕的左边缘之间的距离。
Y – 控件的上边缘与父容器或屏幕的上边缘之间的距离。
相关函数
重置（ 控制 ） - 将库重置回其初始状态。 初始状态包括滚动到第一个项目，然后选择第一个项目或默认值（如果存在）。
注释
重置 控件不会以递归方式重置库的所有子级。
例子
显示和筛选数据
从用户获取数据
辅助功能指南
颜色对比度
如果单击库项中的任意位置进行选择，则必须在以下两者之间有足够的颜色对比度：
- BorderColor 和库外的颜色（如果有边框）。
- 填充 库外的颜色（如果没有边框）。
屏幕阅读器支持
AccessibleLabel 必须存在。
注释
屏幕阅读器将在库中的项发生更改时报出。 还提到了 AccessibleLabel 。 这为公告提供了上下文，当同一屏幕上有多个库时，这更加重要。
当库项包含多个控件时，请使用 ItemAccessibleLabel 显示库项的内容。
如果希望用户选择库项，请将 Selectable 的值设置为 true 。 否则，请将该值设置为 false。
当库项包含多个控件时，请使用 ItemAccessibleLabel 提供库项内容的摘要。
应适当设置可选择项，具体取决于用户是否打算选择库项。
键盘支持
请考虑将 ShowScrollbar 设置为 true。 在大多数触摸屏设备上，滚动条在滚动开始之前不会显示。
如果单击库项中的任意位置是为了选择它，则键盘用户还必须选择库项。 例如，添加一个按钮，该按钮的 OnSelect 属性设置为 Select（Parent）。