ListView 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。
public ref class ListView : Microsoft::Maui::Controls::ItemsView<Microsoft::Maui::Controls::Cell ^>, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::ListView ^>, Microsoft::Maui::Controls::IListViewController, Microsoft::Maui::IVisualTreeElementpublic class ListView : Microsoft.Maui.Controls.ItemsView<Microsoft.Maui.Controls.Cell>, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.ListView>, Microsoft.Maui.Controls.IListViewController, Microsoft.Maui.IVisualTreeElementtype ListView = class
inherit ItemsView<Cell>
interface IListViewController
interface IViewController
interface IVisualElementController
interface IElementController
interface IElementConfiguration<ListView>
interface IVisualTreeElementPublic Class ListView
Inherits ItemsView(Of Cell)
Implements IElementConfiguration(Of ListView), IListViewController, IVisualTreeElement- 继承
- 继承
- 实现
注解
以下示例演示了基本用法：
using System;
using System.Collections.Generic;
using Microsoft.Maui.Controls;
namespace FormsGallery
{
class ListViewDemoPage : ContentPage
{
class Person
{
public Person(string name, DateTime birthday, Color favoriteColor)
{
this.Name = name;
this.Birthday = birthday;
this.FavoriteColor = favoriteColor;
}
public string Name { private set; get; }
public DateTime Birthday { private set; get; }
public Color FavoriteColor { private set; get; }
};
public ListViewDemoPage()
{
Label header = new Label
{
Text = "ListView",
FontSize = Device.GetNamedSize (NamedSize.Large, typeof(Label)),
HorizontalOptions = LayoutOptions.Center
};
// Define some data.
List<Person> people = new List<Person>
{
new Person("Abigail", new DateTime(1975, 1, 15), Color.Aqua),
new Person("Bob", new DateTime(1976, 2, 20), Color.Black),
// ...etc.,...
new Person("Yvonne", new DateTime(1987, 1, 10), Color.Purple),
new Person("Zachary", new DateTime(1988, 2, 5), Color.Red)
};
// Create the ListView.
ListView listView = new ListView
{
// Source of data items.
ItemsSource = people,
// Define template for displaying each item.
// (Argument of DataTemplate constructor is called for
// each item; it must return a Cell derivative.)
ItemTemplate = new DataTemplate(() =>
{
// Create views with bindings for displaying each property.
Label nameLabel = new Label();
nameLabel.SetBinding(Label.TextProperty, "Name");
Label birthdayLabel = new Label();
birthdayLabel.SetBinding(Label.TextProperty,
new Binding("Birthday", BindingMode.OneWay,
null, null, "Born {0:d}"));
BoxView boxView = new BoxView();
boxView.SetBinding(BoxView.ColorProperty, "FavoriteColor");
// Return an assembled ViewCell.
return new ViewCell
{
View = new StackLayout
{
Padding = new Thickness(0, 5),
Orientation = StackOrientation.Horizontal,
Children =
{
boxView,
new StackLayout
{
VerticalOptions = LayoutOptions.Center,
Spacing = 0,
Children =
{
nameLabel,
birthdayLabel
}
}
}
}
};
})
};
// Accomodate iPhone status bar.
this.Padding = new Thickness(10, Device.OnPlatform(20, 0, 0), 10, 5);
// Build the page.
this.Content = new StackLayout
{
Children =
{
header,
listView
}
};
}
}
}
构造函数
| ListView() |
创建并初始化 ListView 类的新实例。 |
| ListView(ListViewCachingStrategy) |
创建并初始化 ListView 类的新实例。 |
字段
属性
| AnchorX |
获取或设置任何转换操作的中心点的 X 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnchorY |
获取或设置任何转换操作的中心点的 Y 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AutomationId |
获取或设置允许自动化框架查找此元素并与其交互的值。 (继承自 Element) |
| Background |
获取或设置 Brush 将用于填充元素背景的元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| BackgroundColor |
获取或设置 Color 将填充元素的背景。 这是一种可绑定属性。 (继承自 VisualElement) |
| Batched |
获取一个值，该值指示对此元素进行了批处理更改。 (继承自 VisualElement) |
| Behaviors |
获取与此元素关联的对象列表 Behavior 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| BindingContext |
获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。 这是一种可绑定属性。 (继承自 BindableObject) |
| Bounds |
获取与设备无关的单元中元素的边界。 (继承自 VisualElement) |
| CachingStrategy |
供 Microsoft.Maui.Controls 平台内部使用。 |
| class |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
| DisableLayout |
获取一个值，该值指示此元素的布局已禁用。 (继承自 VisualElement) |
| Dispatcher |
获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject) |
| EffectControlProvider |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Effects |
获取或设置将在运行时应用于元素的样式和属性。 (继承自 Element) |
| FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
| Footer |
获取或设置将显示在列表视图底部的字符串、绑定或视图。 |
| FooterElement |
供 Microsoft.Maui.Controls 平台内部使用。 |
| FooterTemplate |
获取或设置要用于格式化数据对象的数据模板，以在列表视图的底部显示。 |
| Frame |
获取或设置此元素驻留在屏幕上的框架。 (继承自 VisualElement) |
| GestureController |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 View) |
| GestureRecognizers |
与此视图关联的手势识别器的集合。 (继承自 View) |
| GroupDisplayBinding |
获取或设置要用于显示组标头的绑定。 |
| GroupHeaderTemplate |
获取或设置组标头的 DataTemplate。 |
| GroupShortNameBinding |
获取或设置要在分组跳转列表中显示的名称的绑定。 |
| Handler |
获取或设置与此 IViewHandler 元素关联的项。 (继承自 VisualElement) |
| HasUnevenRows |
获取或设置一个布尔值，该值指示此 ListView 元素是否具有不均匀的行。 |
| Header |
获取或设置将显示在列表视图顶部的字符串、绑定或视图。 |
| HeaderElement |
供 Microsoft.Maui.Controls 平台内部使用。 |
| HeaderTemplate |
获取或设置要用于格式化数据对象的数据模板，以在列表视图的顶部显示。 |
| Height |
获取此元素的当前呈现高度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素的所需高度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| HorizontalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| HorizontalScrollBarVisibility |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 |
| Id |
获取一个值，该值可用于在应用程序运行过程中唯一标识元素。 (继承自 Element) |
| InputTransparent |
获取或设置一个值，该值指示此元素在用户交互期间是否响应命中测试。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabledCore |
此值表示累积 IsEnabled 值。 重写此属性的所有类型都需要在值更改时调用 RefreshIsEnabledProperty（） 方法。 (继承自 VisualElement) |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsGroupingEnabled |
获取或设置是否为 ListView 启用分组。 |
| IsInPlatformLayout |
获取或设置一个值，该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
| IsLoaded |
指示元素是否已连接到主对象树。 (继承自 VisualElement) |
| IsPlatformEnabled |
获取或设置一个值，该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
| IsPlatformStateConsistent |
获取或设置一个值，该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
| IsPullToRefreshEnabled |
获取或设置一个值，该值指示用户是否可以向下轻扫以刷新应用程序。 |
| IsRefreshing |
获取或设置一个值，该值指示列表视图当前是否正在刷新。 |
| IsVisible |
获取或设置一个值，该值确定此元素在屏幕上是否可见，并在布局中占用空间。 这是一种可绑定属性。 (继承自 VisualElement) |
| ItemsSource |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 ItemsView<TVisual>) |
| ItemTemplate |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 ItemsView<TVisual>) |
| LogicalChildren |
已过时.
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 Element) |
| Margin |
获取或设置视图的边距。 (继承自 View) |
| MaximumHeightRequest |
获取或设置元素在布局期间请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaximumWidthRequest |
获取或设置元素在布局期间请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumHeightRequest |
获取或设置元素在布局期间请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置元素在布局期间请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| Navigation |
获取负责处理基于堆栈的导航的对象。 (继承自 NavigableElement) |
| NavigationProxy |
获取转换为 Navigation . NavigationProxy. (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 此值的范围为 0 到 1;超出此范围的值将设置为最接近的有效值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Parent |
获取或设置此元素的父 Element 级。 (继承自 Element) |
| RealParent |
供 .NET MAUI 内部使用。 (继承自 Element) |
| RefreshAllowed |
供 Microsoft.Maui.Controls 平台内部使用。 |
| RefreshCommand |
获取或设置在列表视图进入刷新状态时运行的命令。 |
| RefreshControlColor |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RowHeight |
获取或设置一个值，该值表示行的高度。 |
| Scale |
获取或设置应用于元素的比例因子。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| SelectedItem |
获取或设置 ItemsSource 中的当前选定项。 |
| SelectionMode |
获取或设置一个值，用于控制是否可以选择项以及选择多少个项。 |
| SeparatorColor |
获取或设置分隔列表项的栏的颜色。 |
| SeparatorVisibility |
获取或设置一个值，该值指示分隔符在项之间是否可见。 |
| Shadow |
获取或设置元素强制转换的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
| Style |
获取或设置此元素的唯 Style 一值。 (继承自 NavigableElement) |
| StyleClass |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| TemplatedItems |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 ItemsView<TVisual>) |
| TranslationX |
获取或设置元素的 X 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| TranslationY |
获取或设置元素的 Y 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的对象列表 TriggerBase 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| VerticalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| VerticalScrollBarVisibility |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 |
| Visual |
获取或设置替代 IVisual 元素的视觉外观的实现。 这是一种可绑定属性。 (继承自 VisualElement) |
| Width |
获取此元素的当前宽度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素的所需宽度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| Window |
Window获取与元素关联的项。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| X |
获取此元素的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| ZIndex |
获取或设置布局中元素的前向后 z 索引。 这是一种可绑定属性。 (继承自 VisualElement) |
