TabbedPage 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。
public ref class TabbedPage : Microsoft::Maui::Controls::MultiPage<Microsoft::Maui::Controls::Page ^>, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::TabbedPage ^>, Microsoft::Maui::ITabbedView[Microsoft.Maui.Controls.ContentProperty("Children")]
public class TabbedPage : Microsoft.Maui.Controls.MultiPage<Microsoft.Maui.Controls.Page>, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.TabbedPage>, Microsoft.Maui.ITabbedView[<Microsoft.Maui.Controls.ContentProperty("Children")>]
type TabbedPage = class
inherit MultiPage<Page>
interface IElementConfiguration<TabbedPage>
interface ITabbedView
interface IView
interface IElement
interface ITransformPublic Class TabbedPage
Inherits MultiPage(Of Page)
Implements IElementConfiguration(Of TabbedPage), ITabbedView- 继承
- 继承
- 属性
- 实现
注解
选项卡式页面的用户界面由选项卡列表和较大的详细信息区域组成。 在 iOS 上，选项卡的列表显示在屏幕的底部，而详细信息区域显示在上方。 在 Android 和 Windows 手机上，选项卡显示在屏幕顶部。 如果用户的集合太大而无法容纳在一个屏幕上，则用户可以滚动屏幕顶部的选项卡集合。
应用开发人员可以通过两种方式之一创建选项卡式页面。 首先，应用程序开发人员可以将单个类或其子类的对象列表分配给该属性，ItemsSource并为属性分配一个DataTemplateItemTemplate属性，以返回最不派生类型的对象的页。 其次，应用开发人员可以向属性添加一 Page 系列对象 Children 。 下面的代码示例中显示了这两种方法。
以下示例代码演示如何通过向属性分配DataTemplateItemTemplate特定类型来显示数据。 请注意如何 NamedColorPage 通过绑定其字段来获取其 ColorProperty 颜色。
using System;
using Microsoft.Maui.Controls;
namespace MinimalTabbed
{
class TabbedPageDemoPage : TabbedPage
{
public TabbedPageDemoPage ()
{
this.Title = "TabbedPage";
this.ItemsSource = new NamedColor[] {
new NamedColor ("Red", Color.Red),
new NamedColor ("Yellow", Color.Yellow),
new NamedColor ("Green", Color.Green),
new NamedColor ("Aqua", Color.Aqua),
new NamedColor ("Blue", Color.Blue),
new NamedColor ("Purple", Color.Purple)
};
this.ItemTemplate = new DataTemplate (() => {
return new NamedColorPage ();
});
}
}
// Data type:
class NamedColor
{
public NamedColor (string name, Color color)
{
this.Name = name;
this.Color = color;
}
public string Name { private set; get; }
public Color Color { private set; get; }
public override string ToString ()
{
return Name;
}
}
// Format page
class NamedColorPage : ContentPage
{
public NamedColorPage ()
{
// This binding is necessary to label the tabs in
// the TabbedPage.
this.SetBinding (ContentPage.TitleProperty, "Name");
// BoxView to show the color.
BoxView boxView = new BoxView {
WidthRequest = 100,
HeightRequest = 100,
HorizontalOptions = LayoutOptions.Center
};
boxView.SetBinding (BoxView.ColorProperty, "Color");
// Build the page
this.Content = boxView;
}
}
}
以下示例创建包含两 ContentPage 个实例的选项卡式视图。
class TabbedPageDemoPage2 : TabbedPage
{
public TabbedPageDemoPage2 ()
{
this.Title = "TabbedPage";
this.Children.Add (new ContentPage
{
Title = "Blue",
Content = new BoxView
{
Color = Color.Blue,
HeightRequest = 100f,
VerticalOptions = LayoutOptions.Center
},
}
);
this.Children.Add (new ContentPage {
Title = "Blue and Red",
Content = new StackLayout {
Children = {
new BoxView { Color = Color.Blue },
new BoxView { Color = Color.Red}
}
}
});
}
}
构造函数
| TabbedPage() |
新建具有默认值的 TabbedPage 元素。 |
字段
| ActionSheetSignalName |
内部消息传送系统用于显示操作表的标识符。 (继承自 Page) |
| AlertSignalName |
内部消息系统用来显示警报对话框的标识符。 (继承自 Page) |
| BarBackgroundColorProperty |
的可绑定属性 BarBackgroundColor。 |
| BarBackgroundProperty |
的可绑定属性 BarBackground。 |
| BarTextColorProperty |
的可绑定属性 BarTextColor。 |
| BusySetSignalName |
内部消息传送系统用来设置 IsBusy的标识符。 (继承自 Page) |
| ControlsTabbedPageMapper |
已过时.
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 |
| PromptSignalName |
内部消息传送系统用来显示提示对话框的标识符。 (继承自 Page) |
| SelectedTabColorProperty |
的可绑定属性 SelectedTabColor。 |
| transientNamescope |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 Element) |
| UnselectedTabColorProperty |
的可绑定属性 UnselectedTabColor。 |
属性
| AnchorX |
获取或设置任何转换操作的中心点的 X 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnchorY |
获取或设置任何转换操作的中心点的 Y 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AutomationId |
获取或设置允许自动化框架查找此元素并与其交互的值。 (继承自 Element) |
| Background |
获取或设置 Brush 将用于填充元素背景的元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| BackgroundColor |
获取或设置 Color 将填充元素的背景。 这是一种可绑定属性。 (继承自 VisualElement) |
| BackgroundImageSource |
获取或设置 ImageSource 将用作此页面的背景。 这是一种可绑定属性。 (继承自 Page) |
| BarBackground |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 |
| BarBackgroundColor |
获取或设置栏的背景色。 |
| BarTextColor |
获取或设置栏上的文本颜色。 |
| Batched |
获取一个值，该值指示对此元素进行了批处理更改。 (继承自 VisualElement) |
| Behaviors |
获取与此元素关联的对象列表 Behavior 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| BindingContext |
获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。 这是一种可绑定属性。 (继承自 BindableObject) |
| Bounds |
获取与设备无关的单元中元素的边界。 (继承自 VisualElement) |
| Children |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| class |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
| ContainerArea |
获取或设置此页面包含的区域。 (继承自 Page) |
| CurrentPage |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
| DisableLayout |
获取一个值，该值指示此元素的布局已禁用。 (继承自 VisualElement) |
| Dispatcher |
获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject) |
| EffectControlProvider |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Effects |
获取或设置将在运行时应用于元素的样式和属性。 (继承自 Element) |
| FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
| Frame |
获取或设置此元素驻留在屏幕上的框架。 (继承自 VisualElement) |
| Handler |
获取或设置与此 IViewHandler 元素关联的项。 (继承自 VisualElement) |
| Height |
获取此元素的当前呈现高度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素的所需高度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| IconImageSource |
获取或设置 ImageSource 要用于与此页关联的图标。 这是一种可绑定属性。 (继承自 Page) |
| Id |
获取一个值，该值可用于在应用程序运行过程中唯一标识元素。 (继承自 Element) |
| IgnoresContainerArea |
获取或设置一个值，该值确定是否忽略 。ContainerArea 这是一种可绑定属性。 (继承自 Page) |
| InputTransparent |
获取或设置一个值，该值指示此元素在用户交互期间是否响应命中测试。 这是一种可绑定属性。 (继承自 VisualElement) |
| InternalChildren |
获取此页面中包含的子元素的内部集合。 (继承自 Page) |
| IsBusy |
获取或设置页面繁忙状态。 这会导致特定于平台的全局活动指示器显示忙碌状态。 这是一种可绑定属性。 (继承自 Page) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabledCore |
此值表示累积 IsEnabled 值。 重写此属性的所有类型都需要在值更改时调用 RefreshIsEnabledProperty（） 方法。 (继承自 VisualElement) |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsInPlatformLayout |
获取或设置一个值，该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
| IsLoaded |
指示元素是否已连接到主对象树。 (继承自 VisualElement) |
| IsPlatformEnabled |
获取或设置一个值，该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
| IsPlatformStateConsistent |
获取或设置一个值，该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
| IsVisible |
获取或设置一个值，该值确定此元素在屏幕上是否可见，并在布局中占用空间。 这是一种可绑定属性。 (继承自 VisualElement) |
| ItemsSource |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| ItemTemplate |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| LogicalChildren |
已过时.
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 Element) |
| MaximumHeightRequest |
获取或设置元素在布局期间请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaximumWidthRequest |
获取或设置元素在布局期间请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MenuBarItems |
MenuBarItem获取以特定于平台的方式实现的此页面的对象。 (继承自 Page) |
| MinimumHeightRequest |
获取或设置元素在布局期间请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置元素在布局期间请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| Navigation |
获取负责处理基于堆栈的导航的对象。 (继承自 NavigableElement) |
| NavigationProxy |
获取转换为 Navigation . NavigationProxy. (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 此值的范围为 0 到 1;超出此范围的值将设置为最接近的有效值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Padding |
获取或设置页面内容与其边框之间的间距。 这是一种可绑定属性。 (继承自 Page) |
| Parent |
获取或设置此元素的父 Element 级。 (继承自 Element) |
| RealParent |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| Scale |
获取或设置应用于元素的比例因子。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| SelectedItem |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| SelectedTabColor |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 |
| Shadow |
获取或设置元素强制转换的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
| Style |
获取或设置此元素的唯 Style 一值。 (继承自 NavigableElement) |
| StyleClass |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| Title |
获取或设置页面的标题。 (继承自 Page) |
| ToolbarItems |
ToolbarItem获取以特定于平台的方式实现的此页面的对象。 (继承自 Page) |
| TranslationX |
获取或设置元素的 X 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| TranslationY |
获取或设置元素的 Y 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的对象列表 TriggerBase 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| UnselectedTabColor |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 |
| Visual |
获取或设置替代 IVisual 元素的视觉外观的实现。 这是一种可绑定属性。 (继承自 VisualElement) |
| Width |
获取此元素的当前宽度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素的所需宽度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| Window |
Window获取与元素关联的项。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| X |
获取此元素的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| ZIndex |
获取或设置布局中元素的前向后 z 索引。 这是一种可绑定属性。 (继承自 VisualElement) |
方法
事件
| Appearing |
当此页面在屏幕上直观显示时引发。 (继承自 Page) |
| BatchCommitted |
通过调用 BatchCommit()提交一批属性更改时发生。 (继承自 VisualElement) |
| BindingContextChanged |
当 BindingContext 属性的值更改时发生。 (继承自 BindableObject) |
| ChildAdded |
每当将子元素添加到元素时引发。 (继承自 Element) |
| ChildRemoved |
每当从元素中删除子元素时引发。 (继承自 Element) |
| ChildrenReordered |
当此元素的子元素的顺序发生更改时发生。 (继承自 VisualElement) |
| CurrentPageChanged |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| DescendantAdded |
每当将子元素添加到元素的子树时引发。 (继承自 Element) |
| DescendantRemoved |
每当从元素子树中删除子元素时引发。 (继承自 Element) |
| Disappearing |
当此页面在视觉上从屏幕中消失时引发。 (继承自 Page) |
| FocusChangeRequested |
已过时.
请求焦点更改时发生。 (继承自 VisualElement) |
| Focused |
当此元素处于焦点时发生。 (继承自 VisualElement) |
| HandlerChanged |
每当元素的处理程序发生更改时引发。 (继承自 Element) |
| HandlerChanging |
每当元素的处理程序开始更改时引发。 (继承自 Element) |
| LayoutChanged |
当此页面的子级（因此可能是布局）发生更改时引发。 (继承自 Page) |
| Loaded |
在构造元素并将其添加到平台可视化树时发生。 (继承自 VisualElement) |
| MeasureInvalidated |
当元素的当前度量值失效时发生。 (继承自 VisualElement) |
| NavigatedFrom |
在页面导航离开后引发。 (继承自 Page) |
| NavigatedTo |
导航到页面后引发。 (继承自 Page) |
| NavigatingFrom |
在离开页面之前引发。 (继承自 Page) |
| PagesChanged |
显示屏幕顶部多个选项卡的 MultiPage<T>，其中每个都将内容加载到屏幕上。 (继承自 MultiPage<T>) |
| ParentChanged |
每当元素的父级发生更改时引发。 (继承自 Element) |
| ParentChanging |
每当元素开始更改时引发。 (继承自 Element) |
| PropertyChanged |
在属性值更改时发生。 (继承自 BindableObject) |
| PropertyChanging |
在属性值更改时发生。 (继承自 BindableObject) |
| SizeChanged |
当元素的大小发生更改时发生。 (继承自 VisualElement) |
| Unfocused |
当此元素未聚焦时发生。 (继承自 VisualElement) |
| Unloaded |
当元素不再连接到平台可视化树时发生。 (继承自 VisualElement) |
