Partager via


TabView Classe

Définition

Le contrôle TabView permet d’afficher un ensemble d’onglets et leur contenu respectif. Les contrôles d’onglet sont utiles pour afficher plusieurs pages (ou documents) de contenu tout en donnant à l’utilisateur la possibilité de réorganiser, d’ouvrir ou de fermer de nouveaux onglets.

Est-ce le contrôle approprié ?

Utilisez un Contrôle TabView pour aider l’utilisateur à gérer plusieurs pages ou documents d’application dans la même fenêtre.

N’utilisez pas tabView pour afficher un ensemble statique d’onglets que l’utilisateur ne peut pas réorganiser, ouvrir ou fermer. Utilisez un NavigationView (NavigationViewPaneDisplayMode de Top) à la place.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

/// [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
Héritage
TabView
Attributs

Exemples

Conseil

Pour plus d’informations, des conseils de conception et des exemples de code, consultez Affichage tabulation.

L’application WinUI 2 Gallery comprend des exemples interactifs de la plupart des contrôles et fonctionnalités WinUI 2. Procurez-vous l’application sur le Microsoft Store ou le code source sur GitHub.

Exemple TabView de base, similaire à un navigateur web

<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);
}

Remarques

Modèle et style de contrôle

Vous pouvez modifier le Style et le ControlTemplate par défaut pour donner au contrôle une apparence unique. Pour plus d’informations sur la modification du style et du modèle d’un contrôle, consultez Styles XAML. Le style, le modèle et les ressources par défaut qui définissent l’apparence du contrôle sont inclus dans le generic.xaml fichier. À des fins de conception, generic.xaml est installé avec le package NuGet WinUI (Microsoft.UI.Xaml). Par défaut, l'emplacement est \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml. Les styles et les ressources de différentes versions de WinUI peuvent avoir des valeurs différentes.

XAML inclut également des ressources que vous pouvez utiliser pour modifier les couleurs d’un contrôle dans différents états visuels sans modifier le modèle de contrôle. La modification de ces ressources est préférable à la définition de propriétés telles que l’arrière-plan et le premier plan. Pour plus d’informations, consultez la section Styles légers de l’article Styles XAML .

Constructeurs

TabView()

Initialise une nouvelle instance de la classe TabView.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Propriétés

AddTabButtonCommand

Obtient ou définit la commande à appeler lorsque le bouton Ajouter (+) est appuyé.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

AddTabButtonCommandParameter

Obtient ou définit le paramètre à passer à la propriété AddTabButtonCommand.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

AddTabButtonCommandParameterProperty

Identifie la propriété de dépendance AddTabButtonCommandParameter .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

AddTabButtonCommandProperty

Identifie la propriété de dépendance AddButtonCommand.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

AllowDropTabs

Obtient ou définit une valeur qui détermine si TabView peut être une cible de déplacement à des fins de glisser-déplacer.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

AllowDropTabsProperty

Identifie la propriété de dépendance AllowDropTabs .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CanDragTabs

Obtient ou définit une valeur qui indique si les onglets peuvent être déplacés en tant que charge utile de données.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CanDragTabsProperty

Identifie la propriété de dépendance CanDragTabs .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CanReorderTabs

Obtient ou définit une valeur qui indique si les onglets dans tabStrip peuvent être réorganisés via l’interaction utilisateur.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CanReorderTabsProperty

Identifie la propriété de dépendance CanReorderTabs .

Identifie la propriété de dépendance CanReorderTabs.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CloseButtonOverlayMode

Obtient ou définit une valeur qui indique le comportement du bouton Fermer dans les onglets.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

CloseButtonOverlayModeProperty

Identifie la propriété de dépendance CloseButtonOverlayMode .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

IsAddTabButtonVisible

Obtient ou définit si le bouton Ajouter un onglet (+) est visible.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

IsAddTabButtonVisibleProperty

Identifie la propriété de dépendance IsAddTabButtonVisible .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

SelectedIndex

Obtient ou définit l’index de l’élément sélectionné.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

SelectedIndexProperty

Identifie la propriété de dépendance SelectedIndex .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

SelectedItem

Obtient ou définit l’élément sélectionné.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

SelectedItemProperty

Identifie la propriété de dépendance SelectedItem .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItems

Obtient la collection utilisée pour générer les onglets dans le contrôle .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemsProperty

Identifie la propriété de dépendance TabItems .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemsSource

Obtient ou définit une source d’objet utilisée pour générer les onglets dans TabView.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemsSourceProperty

Identifie la propriété de dépendance TabItemsSource .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemTemplate

Obtient ou définit le DataTemplate utilisé pour afficher chaque élément.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemTemplateProperty

Identifie la propriété de dépendance TabItemTemplate .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemTemplateSelector

Obtient ou définit un objet de sélection qui modifie le DataTemplate pour qu’il s’applique au contenu, en fonction du traitement des informations relatives à l’élément de contenu ou à son conteneur au moment de l’exécution.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemTemplateSelectorProperty

Identifie la propriété de dépendance TabItemTemplateSelector .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripFooter

Obtient ou définit le contenu affiché à droite de la bande d’onglets.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripFooterProperty

Identifie la propriété de dépendance TabStripFooter .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripFooterTemplate

Obtient ou définit le DataTemplate utilisé pour afficher le contenu de TabStripFooter.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripFooterTemplateProperty

Identifie la propriété de dépendance TabStripFooterTemplate .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripHeader

Obtient ou définit le contenu affiché à gauche de la bande d’onglets.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripHeaderProperty

Identifie la propriété de dépendance TabStripHeader .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripHeaderTemplate

Obtient ou définit le DataTemplate utilisé pour afficher le contenu de TabStripHeader.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripHeaderTemplateProperty

Identifie la propriété de dépendance TabStripHeaderTemplate .

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabWidthMode

Obtient ou définit la façon dont les onglets doivent être dimensionnés.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabWidthModeProperty

Identifie la propriété de dépendance TabWidthMode.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Méthodes

ContainerFromIndex(Int32)

Retourne le conteneur de l’élément à l’index spécifié dans la collection.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

ContainerFromItem(Object)

Retourne le conteneur correspondant à l’élément spécifié.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

Événements

AddTabButtonClick

Se produit lorsque l’utilisateur a cliqué sur le bouton Ajouter l’onglet (+).

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

SelectionChanged

Se produit lorsque l’onglet actuellement sélectionné change.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabCloseRequested

Déclenché lorsque l’utilisateur tente de fermer un onglet en cliquant sur le bouton x-to-close, CTRL+F4 ou souris.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabDragCompleted

Déclenché lorsque l’utilisateur termine l’action de glisser.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabDragStarting

Se produit lorsqu’une opération de glissement est lancée.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabDroppedOutside

Se produit lorsque l’utilisateur effectue une opération de glisser-déplacer en supprimant un onglet en dehors de la zone TabStrip.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabItemsChanged

Déclenché lorsque la collection d’éléments a changé.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripDragOver

Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec tabStrip comme cible de déplacement potentielle.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

TabStripDrop

Se produit lorsque le système d’entrée signale un événement de suppression sous-jacent avec tabStrip comme cible de déplacement.

Cette documentation s’applique à WinUI 2 pour UWP (pour WinUI dans le SDK d'application Windows, consultez les espaces de noms SDK d'application Windows).

S’applique à

Voir aussi