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::IVisualTreeElement
public class ListView : Microsoft.Maui.Controls.ItemsView<Microsoft.Maui.Controls.Cell>, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.ListView>, Microsoft.Maui.Controls.IListViewController, Microsoft.Maui.IVisualTreeElement
type ListView = class
inherit ItemsView<Cell>
interface IListViewController
interface IViewController
interface IVisualElementController
interface IElementController
interface IElementConfiguration<ListView>
interface IVisualTreeElement
Public 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 类的新实例。 |
字段
FooterProperty |
的 Footer可绑定属性。 |
FooterTemplateProperty |
的 FooterTemplate可绑定属性。 |
GroupHeaderTemplateProperty |
的 GroupHeaderTemplate可绑定属性。 |
HasUnevenRowsProperty |
的 HasUnevenRows可绑定属性。 |
HeaderProperty |
的 Header可绑定属性。 |
HeaderTemplateProperty |
的 HeaderTemplate可绑定属性。 |
HorizontalScrollBarVisibilityProperty |
的 HorizontalScrollBarVisibility可绑定属性。 |
IsGroupingEnabledProperty |
的 IsGroupingEnabled可绑定属性。 |
IsPullToRefreshEnabledProperty |
的 IsPullToRefreshEnabled可绑定属性。 |
IsRefreshingProperty |
的 IsRefreshing可绑定属性。 |
propertyMapper |
表示视图的内部 PropertyMapper。 (继承自 View) |
RefreshCommandProperty |
的 RefreshCommand可绑定属性。 |
RefreshControlColorProperty |
的 RefreshControlColor可绑定属性。 |
RowHeightProperty |
的 RowHeight可绑定属性。 |
SelectedItemProperty |
的 SelectedItem可绑定属性。 |
SelectionModeProperty |
的 SelectionMode可绑定属性。 |
SeparatorColorProperty |
的 SeparatorColor可绑定属性。 |
SeparatorVisibilityProperty |
的 SeparatorVisibility可绑定属性。 |
VerticalScrollBarVisibilityProperty |
的 VerticalScrollBarVisibility可绑定属性。 |
属性
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 |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 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 |
指示元素是否连接到main对象树。 (继承自 VisualElement) |
IsPlatformEnabled |
获取或设置一个值,该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
IsPlatformStateConsistent |
获取或设置一个值,该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
IsPullToRefreshEnabled |
获取或设置一个值,该值指示用户是否可以向下轻扫以刷新应用程序。 |
IsRefreshing |
获取或设置一个值,该值指示列表视图当前是否正在刷新。 |
IsVisible |
获取或设置一个值,该值确定此元素是否在屏幕上可见并占用布局中的空间。 这是一种可绑定属性。 (继承自 VisualElement) |
ItemsSource |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 ItemsView<TVisual>) |
ItemTemplate |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 ItemsView<TVisual>) |
LogicalChildren |
已过时.
供 Microsoft.Maui.Controls 平台内部使用。 (继承自 Element) |
Margin |
获取或设置视图的边距。 (继承自 View) |
MaximumHeightRequest |
获取或设置元素在布局期间将请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
MaximumWidthRequest |
获取或设置元素在布局期间将请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
MinimumHeightRequest |
获取或设置元素在布局期间将请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
MinimumWidthRequest |
获取或设置元素在布局期间将请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
Navigation |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 NavigableElement) |
NavigationProxy |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 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 |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 NavigableElement) |
StyleClass |
以垂直列表的形式显示数据集合的 ItemsView<TVisual>。 (继承自 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) |
方法
事件
显式接口实现
扩展方法
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈