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 den Benutzer bei der Verwaltung mehrerer App-Seiten oder Dokumente innerhalb desselben Fensters zu unterstützen.

Verwenden Sie keine TabView, um einen statischen Satz 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 im Windows App SDK siehe Windows App SDK Namespaces).

/// [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

[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

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Beispiele

Tipp

Weitere Informationen, Entwurfsleitfäden und Codebeispiele finden Sie unter Registerkartenansicht.

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

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 den Standardstil und die ControlTemplate ändern, um dem Steuerelement ein eindeutiges Erscheinungsbild zu verleihen. Informationen zum Ändern des Stils und der Vorlage eines Steuerelements finden Sie unter XAML-Formatvorlagen. Der Standardstil, die Vorlage und die Ressourcen, die das Erscheinungsbild des Steuerelements definieren, sind in der generic.xaml Datei enthalten. Zu Entwurfszwecken generic.xaml wird mit dem NuGet-Paket WinUI (Microsoft.UI.Xaml) installiert. Standardmäßig ist der Speicherort \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Stile und Ressourcen aus verschiedenen WinUI-Versionen können unterschiedliche Werte aufweisen.

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 bevorzugt, um Eigenschaften wie Hintergrund und Vordergrund festzulegen. Weitere Informationen finden Sie im Abschnitt Leichtes Formatieren des Artikels XAML-Formatvorlagen .

Konstruktoren

TabView()

Initialisiert eine neue instance der TabView-Klasse. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
AddTabButtonCommandParameterProperty	Gibt die Abhängigkeitseigenschaft AddTabButtonCommandParameter an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
AddTabButtonCommandProperty	Gibt die AddButtonCommand-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
AllowDropTabs	Ruft einen Wert ab, der bestimmt, ob die 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 in der 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 in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
CanDragTabsProperty	Gibt die Abhängigkeitseigenschaft CanDragTabs an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
CanReorderTabs	Ruft einen Wert ab, der angibt, ob die Registerkarten im TabStrip durch Benutzerinteraktion neu sortiert werden können, 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).
CanReorderTabsProperty	Gibt die Abhängigkeitseigenschaft CanReorderTabs an. Gibt die Abhängigkeitseigenschaft CanReorderTabs an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
CloseButtonOverlayMode	Ruft einen Wert ab, der das Verhalten der Schaltfläche schließen innerhalb von Registerkarten angibt, 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).
CloseButtonOverlayModeProperty	Identifiziert die CloseButtonOverlayMode-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
IsAddTabButtonVisible	Ruft ab oder legt fest, ob die Registerkarte hinzufügen (+) sichtbar ist. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
SelectedIndexProperty	Gibt die SelectedIndex-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
SelectedItemProperty	Gibt die SelectedItem-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
TabItemsProperty	Gibt die TabItems-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabItemsSource	Ruft eine Objektquelle ab, die zum Generieren der Registerkarten innerhalb der TabView verwendet wird, 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).
TabItemsSourceProperty	Gibt die Abhängigkeitseigenschaft TabItemsSource an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateProperty	Gibt die Abhängigkeitseigenschaft TabItemTemplate an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateSelector	Ruft ein Auswahlobjekt ab, das die DataTemplate ändert, um auf Inhalte anzuwenden, basierend auf der Verarbeitung von Informationen zum Inhaltselement oder seinem Container zur Laufzeit. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabItemTemplateSelectorProperty	Gibt die Abhängigkeitseigenschaft TabItemTemplateSelector an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooterProperty	Gibt die TabStripFooter-Abhängigkeitseigenschaft an. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 im Windows App SDK siehe Windows App SDK Namespaces).
TabStripFooterTemplateProperty	Identifiziert die TabStripFooterTemplate-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im 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 im Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeaderProperty	Identifiziert die TabStripHeader-Abhängigkeitseigenschaft . Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im 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 im Windows App SDK siehe Windows App SDK Namespaces).
TabStripHeaderTemplateProperty	Gibt die TabStripHeaderTemplate-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).
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 im Windows App SDK siehe Windows App SDK Namespaces).
TabWidthModeProperty	Identifiziert die TabWidthMode-Abhängigkeitseigenschaft. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI im 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 in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).

Ereignisse

AddTabButtonClick	Tritt auf, wenn auf die Registerkarte hinzufügen (+) geklickt wurde. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der 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 mausrad klickt. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der 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 in der 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 in der 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 in der 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 in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripDragOver	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit tabStrip als potenziellem Ablageziel meldet. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).
TabStripDrop	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Dropereignis mit tabStrip als Ablageziel meldet. Diese Dokumentation gilt für WinUI 2 für UWP (für WinUI in der Windows App SDK siehe Windows App SDK Namespaces).

Weitere Informationen

• TabViewItem
• TabViewCloseButtonOverlayMode
• Richtlinien für TabView