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 クラスの新しいインスタンスを作成して初期化します。 |
フィールド
プロパティ
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 |
要素がメイン オブジェクト ツリーに接続されているかどうかを示します。 (継承元 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) |
メソッド
イベント
BatchCommitted |
プロパティ変更のバッチが を呼び出 BatchCommit()してコミットされたときに発生します。 (継承元 VisualElement) |
BindingContextChanged |
BindingContext プロパティの値が変化したときに発生します。 (継承元 BindableObject) |
ChildAdded |
子要素が 要素に追加されるたびに発生します。 (継承元 Element) |
ChildRemoved |
子要素が 要素から削除されるたびに発生します。 (継承元 Element) |
ChildrenReordered |
この要素の子の順序が変更されたときに発生します。 (継承元 VisualElement) |
DescendantAdded |
子要素が要素のサブツリーに追加されるたびに発生します。 (継承元 Element) |
DescendantRemoved |
子要素が要素サブツリーから削除されるたびに発生します。 (継承元 Element) |
FocusChangeRequested |
古い.
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 (継承元 VisualElement) |
Focused |
この要素にフォーカスがある場合に発生します。 (継承元 VisualElement) |
HandlerChanged |
要素のハンドラーが変更されるたびに発生します。 (継承元 Element) |
HandlerChanging |
要素のハンドラーが変更を開始するたびに発生します。 (継承元 Element) |
ItemAppearing |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
ItemDisappearing |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
ItemSelected |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
ItemTapped |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
Loaded |
要素が構築され、オブジェクト ツリーに追加されたときに発生します。 (継承元 VisualElement) |
MeasureInvalidated |
要素の現在のメジャーが無効になったときに発生します。 (継承元 VisualElement) |
ParentChanged |
要素の親が変更されるたびに発生します。 (継承元 Element) |
ParentChanging |
要素の変更が開始されるたびに発生します。 (継承元 Element) |
PropertyChanged |
プロパティ値が変更するときに発生します。 (継承元 BindableObject) |
PropertyChanging |
プロパティ値が変更されようとしている場合に発生します。 (継承元 BindableObject) |
Refreshing |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
Scrolled |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
ScrollToRequested |
データのコレクションを垂直方向の一覧として表示する ItemsView<TVisual> です。 |
SizeChanged |
要素のサイズが変更されたときに発生します。 (継承元 VisualElement) |
Unfocused |
この要素がフォーカスされていない場合に発生します。 (継承元 VisualElement) |
Unloaded |
要素がメイン オブジェクト ツリーに接続されなくなったときに発生します。 (継承元 VisualElement) |
明示的なインターフェイスの実装
拡張メソッド
適用対象
.NET MAUI
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示