Freigeben über


TabView Klasse

Definition

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).

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

Beispiele

Tipp

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

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).

Gilt für:

Weitere Informationen