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 屬性，並將指派 DataTemplate 給 ItemTemplate 屬性，以傳回最低衍生型別對象的頁面。 其次，應用程式開發人員可以將一 Page 連串的物件新增至 Children 屬性。 下列程式代碼範例顯示這兩種方法。
下列範例程式代碼示範如何藉由將 指派 DataTemplate 給 ItemTemplate 屬性來顯示特定型別的數據。 請注意如何 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 |
的 BarBackgroundColorBindable 屬性。 |
| BarBackgroundProperty |
的 BarBackgroundBindable 屬性。 |
| BarTextColorProperty |
的 BarTextColorBindable 屬性。 |
| BusySetSignalName |
內部傳訊系統用來設定 IsBusy的標識碼。 (繼承來源 Page) |
| ControlsTabbedPageMapper |
已淘汰.
MultiPage<T>，顯示畫面頂端的索引標籤陣列，各會將內容載入至畫面。 |
| PromptSignalName |
內部傳訊系統用來顯示提示對話框的標識碼。 (繼承來源 Page) |
| SelectedTabColorProperty |
的 SelectedTabColorBindable 屬性。 |
| transientNamescope |
MultiPage<T>，顯示畫面頂端的索引標籤陣列，各會將內容載入至畫面。 (繼承來源 Element) |
| UnselectedTabColorProperty |
的 UnselectedTabColorBindable 屬性。 |
屬性
| 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 |
取得的NavigationProxy轉換Navigation。 (繼承來源 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) |
