Xamarin.Forms.Core
1.0.0.0
1.1.0.0
1.2.0.0
1.3.0.0
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.ItemsView<Xamarin.Forms.Cell>
Xamarin.Forms.Cell
Xamarin.Forms.IListViewController
Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._ListViewRenderer))
An that displays a collection of data as a vertical list.
![]()
The following example shows a basic use:
people = new List
{
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
}
};
}
}
}
]]>
XAML for Xamarin.Forms supports the following properties for the class:
Property
Value
-
HasUnevenRows
true or false, to indicate whether the items in the list all have the same height.
-
IsGroupingEnabled
true or false, to indicate whether grouping is enabled.
-
RowHeight
An integer that describes the height of the items in the list. This is ignored if HasUnevenRows is true.
Constructor
1.0.0.0
1.1.0.0
1.2.0.0
1.3.0.0
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Creates and initializes a new instance of the class.
Constructor
1.5.0.0
2.0.0.0
A value that indicates how the List View should manage memory when displaying data items using a data template.
Creates and initializes a new instance of the class, with the specified caching strategy.
For memory and performance reasons, application developers should strongly prefer , when possible. See for more details.
When devolopers specify , OnElementChanged events are not raised when cells are recycled. Instead, the cell is retained and its property values change when the binding context is updated to that of an available cell, OnElementPropertyChanged events are raised. Application developers should remember to listen for the correct events, and should note that their renderers will need to be updated if the default behavior changes to in a future release.
Method
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
System.Void
Enters the refreshing state by setting the property to .
To be added.
Method
1.0.0.0
1.1.0.0
1.2.0.0
1.3.0.0
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.Cell
The item to create a default visual for.
Creates an instance of the default visual representation of an item.
A instance with its text set to the string representation of the object ().
This method is called by the templating system when is .
The of the returned object will automatically be set to , there is no
need to set it yourself. If you do, it will be overridden.
Method
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
System.Void
Exits the refreshing state by setting the property to .
To be added.
Property
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
System.Object
Gets or sets the string, binding, or view that will be displayed at the bottom of the list view.
To be added.
To be added.
Field
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.BindableProperty
Backing store for the property.
To be added.
Property
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.DataTemplate
Gets or sets a data template to use to format a data object for display at the bottom of the list view.
To be added.
To be added.
Field
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.BindableProperty
Backing store for the property.
To be added.
Property
1.0.0.0
1.1.0.0
1.2.0.0
1.3.0.0
1.3.5.0
1.4.0.0
1.5.0.0
2.0.0.0
Xamarin.Forms.BindingBase
Gets or sets the binding to use for display the group header.
The instance to apply to grouped lists, or .
This binding can be used to simply set a the text of the group headers without defining a full template and uses the default visuals
of the platform to display it. The binding is applied to the of the group.
This property is mutually exclusive with property. Setting it will set
to .
This example shows an alphabetized list of people, grouped by first initial with the display binding set.
{
public Group (string firstInitial)
{
FirstInitial = firstInitial;
}
public string FirstInitial
{
get;
private set;
}
}
]]>
{
public Group (string firstInitial)
{
FirstInitial = firstInitial;
}
public string FirstInitial
{
get;
private set;
}
}
]]>