TabView Klasse

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Das TabView-Steuerelement bietet eine Möglichkeit, eine Reihe von Registerkarten und deren jeweiligen Inhalt anzuzeigen. Registerkartensteuerelemente sind nützlich, um mehrere Seiten (oder Dokumente) von Inhalten anzuzeigen, während sie einem Benutzer die Möglichkeit geben, neue Registerkarten neu anzuordnen, zu öffnen oder zu schließen.

Ist dies das richtige Steuerelement?

Verwenden Sie eine TabView, um dem Benutzer zu helfen, mehrere App-Seiten oder Dokumente innerhalb desselben Fensters zu verwalten.

Verwenden Sie keine TabView, um eine statische Gruppe von Registerkarten anzuzeigen, die der Benutzer nicht neu anordnen, öffnen oder schließen kann. Verwenden Sie stattdessen eine NavigationView (NavigationViewPaneDisplayMode of Top).

Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class TabView : Control

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
class TabView : Control

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class TabView : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class TabView : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
public class TabView : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="TabItems")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class TabView : Control

Public Class TabView
Inherits Control

Vererbung

Control

TabView

Attribute

Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Registerkartenansicht.

Öffnen Sie die WinUI 2-Katalog-App, und sehen Sie sich TabView in Aktion an.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Einfaches TabView-Beispiel, ähnlich einem Webbrowser

<TabView AddTabButtonClick="Tabs_AddTabButtonClick"
         TabCloseRequested="Tabs_TabCloseRequested" />

// Add a new Tab to the TabView
private void Tabs_AddTabButtonClick(TabView sender, TabViewAddTabButtonClickEventArgs e)
{
    var newTab = new TabViewItem();
    newTab.IconSource = new SymbolIconSource() { Symbol = Symbol.Document };
    newTab.Header = "New Document";

    // The Content of a TabViewItem is often a frame which hosts a page.
    Frame frame = new Frame();
    newTab.Content = frame;
    frame.Navigate(typeof(BaconIpsumPage));

    sender.TabItems.Add(newTab);
}

// Remove the requested tab from the TabView
private void Tabs_TabCloseRequested(TabView sender, TabViewTabCloseRequestedEventArgs args)
{
    sender.TabItems.Remove(args.Tab);
}

Hinweise

Steuerelementstil und -vorlage

Sie können die Standardvorlagen Style und ControlTemplate ändern, um dem Steuerelement ein eindeutiges Aussehen zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. XAML enthält auch Ressourcen, mit denen Sie die Farben eines Steuerelements in verschiedenen visuellen Zuständen ändern können, ohne die Steuerelementvorlage zu ändern. Das Ändern dieser Ressourcen wird vorgezogen, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Stile .

Die Ressourcen für dieses Steuerelement sind im Abschnitt ThemeDictionaries der Datei TabView_themeresources.xaml auf GitHub aufgeführt. Der ResourceKey Wert für jeden StaticResource verweist auf einen Pinsel und eine Farbe in der Datei Common_themeresources_any.xaml .

Konstruktoren

TabView()

Initialisiert eine neue Instanz der TabView-Klasse . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Eigenschaften

AddTabButtonCommand	Ruft den Befehl ab, der aufgerufen werden soll, wenn auf die Schaltfläche Hinzufügen (+) getippt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AddTabButtonCommandParameter	Ruft den Parameter ab, der an die AddTabButtonCommand-Eigenschaft übergeben werden soll, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AddTabButtonCommandParameterProperty	Identifiziert die AddTabButtonCommandParameter-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AddTabButtonCommandProperty	Identifiziert die AddButtonCommand-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AllowDropTabs	Ruft einen Wert ab, der bestimmt, ob tabView ein Ablageziel für Drag-and-Drop-Vorgänge sein kann, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
AllowDropTabsProperty	Gibt die AllowDropTabs-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CanDragTabs	Ruft einen Wert ab, der angibt, ob Registerkarten als Datennutzlast gezogen werden können, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CanDragTabsProperty	Identifiziert die CanDragTabs-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CanReorderTabs	Ruft einen Wert ab, der angibt, ob die Registerkarten im TabStrip durch Benutzerinteraktion neu angeordnet werden können, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CanReorderTabsProperty	Identifiziert die CanReorderTabs-Abhängigkeitseigenschaft . Identifiziert die CanReorderTabs-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CloseButtonOverlayMode	Ruft einen Wert ab, der das Verhalten der Schaltfläche zum Schließen innerhalb von Registerkarten angibt, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
CloseButtonOverlayModeProperty	Identifiziert die CloseButtonOverlayMode-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsAddTabButtonVisible	Ruft ab oder legt fest, ob die Schaltfläche zum Hinzufügen (+) sichtbar ist. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
IsAddTabButtonVisibleProperty	Gibt die Abhängigkeitseigenschaft IsAddTabButtonVisible an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectedIndex	Ruft den Index des ausgewählten Elements ab oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectedIndexProperty	Identifiziert die SelectedIndex-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectedItem	Ruft das ausgewählte Element ab oder legt dieses fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectedItemProperty	Identifiziert die SelectedItem-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItems	Ruft die Auflistung ab, die zum Generieren der Registerkarten innerhalb des Steuerelements verwendet wird. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemsProperty	Identifiziert die TabItems-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemsSource	Ruft eine Objektquelle ab, die zum Generieren der Registerkarten in der TabView verwendet wird, oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemsSourceProperty	Identifiziert die TabItemsSource-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplate	Ruft die DataTemplate ab, die zum Anzeigen der einzelnen Elemente verwendet wird, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateProperty	Identifiziert die TabItemTemplate-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateSelector	Ruft ein Auswahlobjekt ab, das die DataTemplate so ändert, dass es auf Inhalte angewendet wird, basierend auf verarbeitungsbezogenen Informationen über das Inhaltselement oder dessen Container zur Laufzeit. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateSelectorProperty	Identifiziert die TabItemTemplateSelector-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooter	Ruft den Inhalt ab, der rechts neben dem Registerkartenstreifen angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooterProperty	Identifiziert die TabStripFooter-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooterTemplate	Ruft die DataTemplate ab, die zum Anzeigen des Inhalts von TabStripFooter verwendet wird, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooterTemplateProperty	Gibt die Abhängigkeitseigenschaft TabStripFooterTemplate an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeader	Ruft den Inhalt ab, der links neben dem Registerkartenstreifen angezeigt wird, oder legt diesen fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeaderProperty	Gibt die Abhängigkeitseigenschaft TabStripHeader an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeaderTemplate	Ruft die DataTemplate ab, die zum Anzeigen des Inhalts von TabStripHeader verwendet wird, oder legt sie fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeaderTemplateProperty	Gibt die Abhängigkeitseigenschaft TabStripHeaderTemplate an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabWidthMode	Ruft die Größe der Registerkarten ab oder legt diese fest. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabWidthModeProperty	Gibt die Abhängigkeitseigenschaft TabWidthMode an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Methoden

ContainerFromIndex(Int32)	Gibt den Container für das Element am angegebenen Index innerhalb der Auflistung zurück. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
ContainerFromItem(Object)	Gibt den Container zurück, der dem angegebenen Element entspricht. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

AddTabButtonClick	Tritt auf, wenn auf die Schaltfläche zum Hinzufügen (+) geklickt wurde. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
SelectionChanged	Tritt auf, wenn sich die aktuell ausgewählte Registerkarte ändert. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabCloseRequested	Wird ausgelöst, wenn der Benutzer versucht, eine Registerkarte zu schließen, indem er auf die Schaltfläche x-to-close, STRG+F4 oder das Mausrad klickt. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabDragCompleted	Wird ausgelöst, wenn der Benutzer die Ziehaktion abgeschlossen hat. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabDragStarting	Tritt auf, wenn ein Ziehvorgang initiiert wird. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabDroppedOutside	Tritt auf, wenn der Benutzer einen Drag and Drop-Vorgang durch Ablegen einer Registerkarte außerhalb des TabStrip-Bereichs abschließt. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabItemsChanged	Wird ausgelöst, wenn sich die Elementauflistung geändert hat. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabStripDragOver	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit tabStrip als potenziellem Ablageziel meldet. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).
TabStripDrop	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drop-Ereignis mit tabStrip als Ablageziel meldet. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• TabViewItem
• TabViewCloseButtonOverlayMode
• Richtlinien für TabView