ListView 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將資料集合顯示為垂直清單的 ItemsView<TVisual>。
[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._ListViewRenderer))]
public class ListView : Xamarin.Forms.ItemsView<Xamarin.Forms.Cell>, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.ListView>, Xamarin.Forms.IListViewControllertype ListView = class
inherit ItemsView<Cell>
interface IListViewController
interface IViewController
interface IVisualElementController
interface IElementController
interface IElementConfiguration<ListView>- 繼承
- 屬性
- 實作
備註
下列範例顯示基本用途：
using System;
using System.Collections.Generic;
using Xamarin.Forms;
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 |
識別 HasUnevenRowsProperty 屬性。 |
| HeaderProperty |
Header 屬性的備份存放區。 |
| HeaderTemplateProperty |
HeaderTemplate 屬性的備份存放區。 |
| HorizontalScrollBarVisibilityProperty |
HorizontalScrollBarVisibility 欄位的備份存放區。 |
| IsGroupingEnabledProperty |
識別 IsGroupingEnabledProperty 屬性。 |
| IsPullToRefreshEnabledProperty |
IsPullToRefreshEnabled 屬性的備份存放區。 |
| IsRefreshingProperty |
IsRefreshing 屬性的備份存放區。 |
| RefreshCommandProperty |
RefreshCommand 屬性的備份存放區。 |
| RefreshControlColorProperty |
RefreshControlColor 欄位的備份存放區。 |
| RowHeightProperty |
RowHeightProperty 屬性的備份存放區。 |
| SelectedItemProperty |
識別 SelectedItemProperty 屬性。 |
| SelectionModeProperty |
SelectionMode 屬性的備份存放區。 |
| SeparatorColorProperty |
SeparatorColor 屬性的備份存放區。 |
| SeparatorVisibilityProperty |
SeparatorVisibility 屬性的備份存放區。 |
| VerticalScrollBarVisibilityProperty |
VerticalScrollBarVisibility 欄位的備份存放區。 |
屬性
| AnchorX |
取得或設定任何轉換內中心點的 X 元件 (相對於項目界限)。 這是可繫結屬性。 (繼承來源 VisualElement) |
| AnchorY |
取得或設定任何轉換內中心點的 Y 元件 (相對於項目界限)。 這是可繫結屬性。 (繼承來源 VisualElement) |
| AutomationId |
取得或設定值，允許自動化架構尋找此項目並與之互動。 (繼承來源 Element) |
| Background |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 VisualElement) |
| BackgroundColor |
取得或設定將會填滿 VisualElement 背景的色彩。 這是可繫結屬性。 (繼承來源 VisualElement) |
| Batched |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| Behaviors |
取得與此元素關聯的行為清單。 這是可繫結屬性。 (繼承來源 VisualElement) |
| BindingContext |
取得或設定物件，這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。 (繼承來源 BindableObject) |
| Bounds |
取得項目的界限。 (繼承來源 VisualElement) |
| CachingStrategy |
供 Xamarin.Forms 平台內部使用。 |
| class |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 NavigableElement) |
| ClassId |
取得或設定值，用來識別語意類似項目的集合。 (繼承來源 Element) |
| Clip |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 VisualElement) |
| DisableLayout |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| Dispatcher |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 BindableObject) |
| EffectControlProvider |
供 Xamarin.Forms 平台內部使用。 (繼承來源 Element) |
| Effects |
套用至此項目的效果清單。 (繼承來源 Element) |
| FlowDirection |
取得或設定配置流程方向。 (繼承來源 VisualElement) |
| Footer |
取得或設定字串、繫結或將在清單檢視底端顯示的檢視。 |
| FooterElement |
供 Xamarin.Forms 平台內部使用。 |
| FooterTemplate |
取得或設定資料範本，用來格式化資料物件以顯示在清單檢視底端。 |
| GestureController |
取得檢視的軌跡控制器。 (繼承來源 View) |
| GestureRecognizers |
與此檢視建立關聯的筆勢辨識器集合。 (繼承來源 View) |
| GroupDisplayBinding |
取得或設定用於顯示群組標頭的繫結。 |
| GroupHeaderTemplate |
取得或設定群組標頭的 DataTemplate。 |
| GroupShortNameBinding |
取得或設定要以群組捷徑清單顯示名稱的繫結。 |
| HasUnevenRows |
取得或設定布林值，指出此 ListView 項目是否有不平均的資料列。 |
| Header |
取得或設定字串、繫結或將在清單檢視頂端顯示的檢視。 |
| HeaderElement |
供 Xamarin.Forms 平台內部使用。 |
| HeaderTemplate |
取得或設定資料範本，用來格式化資料物件以顯示在清單檢視頂端。 |
| Height |
取得此項目的目前呈現高度。 這是唯讀的可繫結屬性。 (繼承來源 VisualElement) |
| HeightRequest |
取得或設定此項目所需的高度覆寫項。 (繼承來源 VisualElement) |
| HorizontalOptions |
取得或設定 LayoutOptions，定義如何在配置循環配置項目。 這是可繫結屬性。 (繼承來源 View) |
| HorizontalScrollBarVisibility |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 |
| Id |
取得值，可用來在應用程式執行期間唯一識別項目。 (繼承來源 Element) |
| InputTransparent |
取得或設定值，這個值指出是否應該在使用者互動週期中包含此項目。 這是可繫結屬性。 (繼承來源 VisualElement) |
| IsEnabled |
取得或設定值，這個值指出使用者介面中是否已啟用此項目。 這是可繫結屬性。 (繼承來源 VisualElement) |
| IsFocused |
取得值，這個值指出此項目目前是否為焦點。 這是可繫結屬性。 (繼承來源 VisualElement) |
| IsGroupingEnabled |
取得或設定是否啟用 ListView 的群組。 |
| IsInNativeLayout |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| IsNativeStateConsistent |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| IsPlatformEnabled |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| IsPullToRefreshEnabled |
取得或設定值，告知使用者是否可以向下撥動以重新整理應用程式。 |
| IsRefreshing |
取得或設定值，告知目前是否正在重新整理清單檢視。 |
| IsTabStop |
取得或設定值，這個值表示此元素是否包含於索引標籤巡覽。 這是可繫結屬性。 (繼承來源 VisualElement) |
| IsVisible |
取得或設定值，這個值會決定此項目是否應成為視覺化樹狀結構的一部分。 這是可繫結屬性。 (繼承來源 VisualElement) |
| ItemsSource |
取得或設定要樣板化和顯示的項目來源。 (繼承來源 ItemsView<TVisual>) |
| ItemTemplate |
取得或設定要套用至 ItemsSource 的 DataTemplate。 (繼承來源 ItemsView<TVisual>) |
| LogicalChildren |
供 Xamarin.Forms 平台內部使用。 (繼承來源 Element) |
| Margin |
取得或設定檢視的邊界。 (繼承來源 View) |
| MinimumHeightRequest |
取得或設定值，這個值會覆寫項目在配置期間要求的最小高度。 (繼承來源 VisualElement) |
| MinimumWidthRequest |
取得或設定值，這個值會覆寫項目在配置期間要求的最小寬度。 (繼承來源 VisualElement) |
| Navigation |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 NavigableElement) |
| NavigationProxy |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 NavigableElement) |
| Opacity |
取得或設定套用至項目 (呈現時) 的不透明度值。 這是可繫結屬性。 (繼承來源 VisualElement) |
| Parent |
取得或設定項目的父項目。 (繼承來源 Element) |
| ParentView |
已淘汰.
取得即此項目最接近上階的項目，而此項目是 VisualElement。 (繼承來源 Element) |
| Platform |
已淘汰.
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 Element) |
| RealParent |
供 Xamarin.Forms 平台內部使用。 (繼承來源 Element) |
| RefreshAllowed |
供 Xamarin.Forms 平台內部使用。 |
| 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 |
取得或設定值，告知項目之間的分隔符號是否可見。 |
| Style |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 NavigableElement) |
| StyleClass |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 NavigableElement) |
| StyleId |
取得或設定使用者定義值來唯一識別項目。 (繼承來源 Element) |
| TabIndex |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 VisualElement) |
| TemplatedItems |
取得樣板化項目清單。 (繼承來源 ItemsView<TVisual>) |
| TranslationX |
取得或設定項目的 X 轉譯差異。 (繼承來源 VisualElement) |
| TranslationY |
取得或設定項目的 Y 轉譯差異。 (繼承來源 VisualElement) |
| Triggers |
取得與此項目建立關聯的觸發程序清單。 這是可繫結屬性。 (繼承來源 VisualElement) |
| VerticalOptions |
取得或設定 LayoutOptions，定義如何在配置循環配置項目。 這是可繫結屬性。 (繼承來源 View) |
| VerticalScrollBarVisibility |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 |
| Visual |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 VisualElement) |
| Width |
取得此項目的目前呈現寬度。 這是唯讀的可繫結屬性。 (繼承來源 VisualElement) |
| WidthRequest |
取得或設定此項目所需的寬度覆寫項。 (繼承來源 VisualElement) |
| X |
取得此項目的目前 X 位置。 這是唯讀的可繫結屬性。 (繼承來源 VisualElement) |
| Y |
取得此項目的目前 Y 位置。 這是唯讀的可繫結屬性。 (繼承來源 VisualElement) |
方法
事件
| BatchCommitted |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| BindingContextChanged |
每當 BindingContext 屬性變更時引發。 (繼承來源 BindableObject) |
| ChildAdded |
只要將子項目新增至項目時就發生。 (繼承來源 Element) |
| ChildRemoved |
只要從項目移除子項目時就發生。 (繼承來源 Element) |
| ChildrenReordered |
在 VisualElement 的子系已重新排序時發生。 (繼承來源 VisualElement) |
| DescendantAdded |
只要將子項目新增至項目樹狀子目錄時即發生。 (繼承來源 Element) |
| DescendantRemoved |
只要從項目樹狀子目錄移除子項目時即發生。 (繼承來源 Element) |
| FocusChangeRequested |
供 Xamarin.Forms 平台內部使用。 (繼承來源 VisualElement) |
| Focused |
在項目取得焦點時發生。 (繼承來源 VisualElement) |
| ItemAppearing |
將項目的視覺效果表示新增至視覺效果配置時發生。 |
| ItemDisappearing |
從視覺效果配置移除項目的視覺效果表示時發生。 |
| ItemSelected |
選取新項目時所引發的事件。 |
| ItemTapped |
點選項目時所引發的事件。 |
| MeasureInvalidated |
視覺項目配置失效時所引發的事件。 (繼承來源 VisualElement) |
| PlatformSet |
已淘汰.
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 (繼承來源 Element) |
| PropertyChanged |
在屬性變更時引發。 (繼承來源 BindableObject) |
| PropertyChanging |
在屬性即將變更時引發。 (繼承來源 BindableObject) |
| Refreshing |
清單檢視重新整理時所引發的事件。 |
| Scrolled |
將資料集合顯示為垂直清單的 ItemsView<TVisual>。 |
| ScrollToRequested |
供 Xamarin.Forms 平台內部使用。 |
| SizeChanged |
當這個項目的 Width 或 Height 屬性變更值時發生。 (繼承來源 VisualElement) |
| Unfocused |
在項目失去焦點時發生。 (繼承來源 VisualElement) |
明確介面實作
| IDynamicResourceHandler.SetDynamicResource(BindableProperty, String) |
供 Xamarin.Forms 平台內部使用。 (繼承來源 BindableObject) |
| IElementController.SetValueFromRenderer(BindableProperty, Object) |
供 Xamarin.Forms 平台內部使用。 (繼承來源 Element) |
| IGestureController.CompositeGestureRecognizers |
供 Xamarin.Forms 平台內部使用。 (繼承來源 View) |
| IItemsView<TVisual>.CreateDefault(Object) |
使用 |
| IItemsView<TVisual>.SetupContent(TVisual, Int32) |
僅供內部使用。 (繼承來源 ItemsView<TVisual>) |
| IItemsView<TVisual>.UnhookContent(TVisual) |
僅供內部使用。 (繼承來源 ItemsView<TVisual>) |
| INameScope.RegisterName(String, Object) |
僅供內部使用。 (繼承來源 Element) |
| ITemplatedItemsView<TVisual>.ListProxy |
這個介面供平台轉譯器內部使用。 (繼承來源 ItemsView<TVisual>) |
| ITemplatedItemsView<TVisual>.TemplatedItems |
這個介面供平台轉譯器內部使用。 (繼承來源 ItemsView<TVisual>) |
| IVisualElementController.EffectiveFlowDirection |
取得平台上項目的有效視覺流程方向，並將地區設定和邏輯流程設定納入考量。 (繼承來源 VisualElement) |
| IVisualElementController.InvalidateMeasure(InvalidationTrigger) |
此方法供內部使用。 (繼承來源 VisualElement) |