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 クラスの新しいインスタンスを作成して初期化します。 |
フィールド
プロパティ
| AnchorX |
すべての変換の中心点の X 座標を、要素の境界からの相対位置で取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| AnchorY |
すべての変換の中心点の Y 座標を、要素の境界からの相対位置で取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| AutomationId |
自動化フレームワークがこの要素を見つけ、対話することを可能にする値を取得または設定します。 (継承元 Element) |
| Background | (継承元 VisualElement) |
| BackgroundColor |
VisualElement の背景を塗りつぶす色を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Batched |
Xamarin.Forms プラットフォームによる内部使用向け。 (継承元 VisualElement) |
| Behaviors |
この要素に関連付けられている動作の一覧を取得します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| BindingContext |
バインドされたプロパティのうち、この BindableObject に属するプロパティの対象となるプロパティが含まれるオブジェクトを取得または設定します。 (継承元 BindableObject) |
| Bounds |
要素の範囲を取得します。 (継承元 VisualElement) |
| CachingStrategy |
Xamarin.Forms プラットフォームによる内部使用向け。 |
| class | (継承元 NavigableElement) |
| ClassId |
意味的に同類の要素の集合を識別するために使用される値を取得または設定します。 (継承元 Element) |
| Clip | (継承元 VisualElement) |
| DisableLayout |
Xamarin.Forms プラットフォームによる内部使用向け。 (継承元 VisualElement) |
| Dispatcher | (継承元 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 | |
| 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 | (継承元 NavigableElement) |
| NavigationProxy | (継承元 NavigableElement) |
| Opacity |
描画時に要素に適用する不透明度値を取得または設定します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| Parent |
要素の親要素を取得または設定します。 (継承元 Element) |
| ParentView |
互換性のために残されています。
この要素の最も近い祖先 (すなわち VisualElement) である要素を取得します。 (継承元 Element) |
| Platform |
互換性のために残されています。
(継承元 Element)
|
| RealParent |
Xamarin.Forms プラットフォームによる内部使用向け。 (継承元 Element) |
| RefreshAllowed |
Xamarin.Forms プラットフォームによる内部使用向け。 |
| RefreshCommand |
リスト ビューが更新状態になった場合に実行されるコマンドを取得または設定します。 |
| RefreshControlColor | |
| 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 | (継承元 NavigableElement) |
| StyleClass | (継承元 NavigableElement) |
| StyleId |
要素を一意に識別するユーザー定義の値を取得または設定します。 (継承元 Element) |
| TabIndex | (継承元 VisualElement) |
| TemplatedItems |
テンプレート化された項目の一覧を取得します。 (継承元 ItemsView<TVisual>) |
| TranslationX |
要素の X 変換差分を取得または設定します。 (継承元 VisualElement) |
| TranslationY |
要素の Y 変換差分を取得または設定します。 (継承元 VisualElement) |
| Triggers |
この要素に関連付けられているトリガーの一覧を取得します。 これはバインド可能なプロパティです。 (継承元 VisualElement) |
| VerticalOptions |
レイアウト サイクルで要素がどのように配置されるかを定義する LayoutOptions を取得または設定します。 これはバインド可能なプロパティです。 (継承元 View) |
| VerticalScrollBarVisibility | |
| Visual | (継承元 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 |
互換性のために残されています。
(継承元 Element)
|
| PropertyChanged |
プロパティが変更されたときに発生します。 (継承元 BindableObject) |
| PropertyChanging |
プロパティが変更されようとしているときに発生します。 (継承元 BindableObject) |
| Refreshing |
リスト ビューが更新されるきに発生するイベントです。 |
| Scrolled | |
| ScrollToRequested |
Xamarin.Forms プラットフォームによる内部使用向け。 |
| SizeChanged |
この要素の Width プロパティまたは Height プロパティの値が変更されると発生します。 (継承元 VisualElement) |
| Unfocused |
要素がフォーカスを失ったときに発生します。 (継承元 VisualElement) |