Forms中的Page表示App中的一个页面。作用类似Android中的Activity,用来呈现一个用户界面,通常不会直接使用Page类,更多是使用Page的子类,最常用的就是ContentPage
.
继承关系图
ContentPage介绍
Page的一个子类,只可以显示一个View(only one child),通常会将一个继承了Layout或Layout<T>的子类作为ContentPage的子视图,如:StackLayout。新建项目中默认使用的就是ContentPage(ContentPage作为XAML文件的根结点)。
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" xmlns:local="clr-namespace:page" x:Class="page.pagePage">
<Label Text="Welcome to Xamarin Forms!" VerticalOptions="Center" HorizontalOptions="Center" />
</ContentPage>
如何指定App显示的哪个Page?找到App.xaml文件,打开关联的
App.xaml.cs
文件,看到在App的构造方法中通过MainPage=new pagePage();
指定要显示的Page,pagePage是我们布局文件对应的类名。
通过CS代码的方式定义Page并显示屏幕上:
MainPage = new ContentPage()
{
Content = new Label()
{
Text = "Welcome to Xamarin Forms!",
HorizontalOptions = LayoutOptions.Center,
VerticalOptions = LayoutOptions.Center
}
};
与默认提供的XAML布局样式相同。
MasterDetailPage 使用介绍
MasterDetailPage管理两个页面,Master显示一个数据列表,Detail显示某一项详情。MasterDetailPage定义了两个Page类型属性Master和Detail,通常我们会将这两个属性赋值为ContentPage对象,但是目前为止,要使MasterDetailPage在Universal Windows Platform能正常使用,必须将Detail属性赋值为NavigationPage类型。MasterDetailPage会根据设备有(phone 或 tablet)不同的显示方式,显示方式由MasterBehavior
属性决定,手机默认为Popover模式,平板或桌面设备默认为Split模式。
同时提供两个bool类型属性IsGestureEnabled
和IsPresented
,IsGestureEnabled表示是否支持滑动切换MasterPage的显示状态,而IsPresented表示MasterPage是否为显示状态。当IsPresented值改变时会触发IsPresentedChanged
事件。
编写示例项目,新建三个Page页面,分别命名为MasterPage和DetailPage1、DetailPage2。MasterPage的CS文件中增加如下代码:
public partial class MasterPage : ContentPage
{
public ListView ListView { get { return menuListView; } }
public MasterPage()
{
InitializeComponent();
menuListView.ItemsSource = new List<ListViewItem>() {
new ListViewItem(){
Title="Detail 1",
TargetPage=typeof(DetailPage1)
},
new ListViewItem(){
Title="Detail 2",
TargetPage=typeof(DetailPage2)
}
};
}
}
public class ListViewItem
{
public string Title { get; set; }
public Type TargetPage { get; set; }
}
定义了一个Model类ListViewItem。MasterPage中除了设置ListView的ItemSource属性外还定义了一个只读属性ListView,方便在MasterDetailPage中访问。
MasterPage XAML文件定义DetailPage1、DetailPage2分别只包含了一个Label显示文本以区分Page。
修改创建项创建的Page文件。
XAML文件修改修改根节点为MasterDetailPage
,IsGestureEnabled和MasterBehavior默认值即刻,定义MasterDetailPage.Master和MasterDetailPage.Detail属性节点,根据需要定义Name属性。需要注意Detail属性赋值了一个NavigationPage实例。
CS文件继承的子类修改为MasterDetailPage,构造函数中增加如下代码:
masterPage.ListView.ItemSelected += (sender, e) =>
{
if (e.SelectedItem == null)
{
return;
}
var item = e.SelectedItem as ListViewItem;
Detail = new NavigationPage((Page)Activator.CreateInstance(item.TargetPage));
masterPage.ListView.SelectedItem = null;
IsPresented = false;
};
Activator.CreateInstance方法用来创建指定类型的实例,更多介绍:http://www.cnblogs.com/lmfeng/archive/2012/01/30/2331666.html
设置SelectedItem = null取消ListView的选中效果,IsPresented = false修改MasterPage的显示状态。
运行效果:
如果DetailPage中仅是数据的变化,可以直接在MasterDetailPage.Master和MasterDetailPage.Detail属性节点中定义Page。
<MasterDetailPage.Master>
<ContentPage>
<!--页面定义-->
</ContentPage>
</MasterDetailPage.Master>
<MasterDetailPage.Detail>
<NavigationPage>
<x:Arguments>
<ContentPage>
<!--页面定义-->
</ContentPage>
</x:Arguments>
</NavigationPage>
</MasterDetailPage.Detail>
tablet设备修改MasterBehavior属性为Split。会有不同效果:
MasterBehavior值为Split时,不允许设置IsPresented的值为false。
TabbedPage 使用介绍
TabbedPage继承抽象类MultiPage<Page>,管理一个Page类集合,每次只有一个Page显示,在TabbedPage的顶部(Android、WP)或底部(iOS)显示一个页卡标签标示每一个Page页面。MultiPage<T>是一个抽象类,定义了TabbedPage的大多属性和事件。
iOS中使用TabbedPage必须为每个标签提供一个图标,由对应页面的Icon属性设置,否则App Store不会通过审核。
TabbedPage从MultiPage<Page>继承一个IList<T>类型属性Children,表示TabbedPage标签页管理Page的集合。MultiPage<Page>还提供了ItemSource和ItemTemplate两个属性定义标签页的Page集合。
MultiPage<Page>定义了两个属性方便应用程序判断用户当前查看哪个页面:CurrentPage和SelectedItem。CurrentPage获取或设置当前显示的页面,SelectedItem表示ItemsSource当前的选中项。
MultiPage<T>定义两个事件:PagesChanged和CurrentPageChanged。当ItemsSource属性改变时会触发PagesChanged事件,CurrentPage改变时触发CurrentPageChanged事件。
修改主页面XAML文件,根节点改为TabbedPage,同时修改继承子类为TabbedPage。
Children属性使用
定义Children Page页面Tab1,Title属性赋值外,iOS平台还要对Icon属性赋值:
<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="pages.Tab1" Title="Tab1">
<ContentPage.Icon>
<OnPlatform x:TypeArguments="FileImageSource" iOS="ico.png"/>
</ContentPage.Icon>
<ContentPage.Padding>
<OnPlatform x:TypeArguments="Thickness" iOS="0,20,0,0"/>
</ContentPage.Padding>
<ContentPage.Content>
<Label Text="Tab1"/>
</ContentPage.Content>
</ContentPage>
类似方式定义Tab2和Tab3。
TabbedPage页面XAML文件修改
<TabbedPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:local="clr-namespace:pages"
x:Class="pages.pagesPage">
<local:Tab1/>
<local:Tab2/>
<local:Tab3/>
</TabbedPage>
对应C#代码:
ItemSource和ItemTemplate使用
有ItemTemplate定义所以该方式用于多个TabPage页面想同时使用,结合Data Binding管理页面数据显示。
如下方式修改TabbedPage页面代码:
定义TabPageMode,初始化TabPageMode集合赋值给ItemsSource属性。新建Tab页面,根据Tab初始化DataTemplate实例赋值ItemTemplate属性。
定义Tab页:
<?xml version="1.0" encoding="UTF-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="pages.Tab" Title="{Binding Title}" Icon="{Binding Icon}">
<ContentPage.Padding>
<OnPlatform x:TypeArguments="Thickness" iOS="0,20,0,0"/>
</ContentPage.Padding>
<ContentPage.Content>
<Label Text="{Binding Content}"/>
</ContentPage.Content>
</ContentPage>
也可以省略Tab页面定义,TabbedPage的XAML中直接定义TabbedPage.ItemTemplate属性节点:
<?xml version="1.0" encoding="utf-8"?>
<TabbedPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
xmlns:local="clr-namespace:pages"
x:Class="pages.pagesPage">
<TabbedPage.ItemTemplate>
<DataTemplate>
<ContentPage Title="{Binding Title}" Icon="{Binding Icon}">
<ContentPage.Padding>
<OnPlatform x:TypeArguments="Thickness" iOS="0,20,0,0"/>
</ContentPage.Padding>
<ContentPage.Content>
<Label Text="{Binding Content}"/>
</ContentPage.Content>
</ContentPage>
</DataTemplate>
</TabbedPage.ItemTemplate>
</TabbedPage>
效果图:
Icon属性只对iOS有效,Android和Windows Phone只是简单的显示文本标签。
NavigationPage 使用介绍
CarouselPage 介绍
CarouselPage支持用户滑动手势的页面,类似gallery。推荐用CarouselView代替CarouselPage。
CarouselView实现轮播图效果:https://blog.xamarin.com/flip-through-items-with-xamarin-forms-carouselview/
网友评论