TabView Classe

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

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

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

Héritage

Control

TabView

Attributs

MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

Exemples

Conseil

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

Ouvrez l’application Galerie WinUI 2 et consultez TabView en action.

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

Voir aussi

• TabViewItem
• TabViewCloseButtonOverlayMode
• Recommandations pour TabView