Pivot.IsHeaderItemsCarouselEnabled Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui indique si l’en-tête sélectionné passe à la première position.

public:
 property bool IsHeaderItemsCarouselEnabled { bool get(); void set(bool value); };

bool IsHeaderItemsCarouselEnabled();

void IsHeaderItemsCarouselEnabled(bool value);

public bool IsHeaderItemsCarouselEnabled { get; set; }

var boolean = pivot.isHeaderItemsCarouselEnabled;
pivot.isHeaderItemsCarouselEnabled = boolean;

Public Property IsHeaderItemsCarouselEnabled As Boolean

<Pivot IsHeaderItemsCarouselEnabled="bool" />

Valeur de propriété

Boolean

bool

true si l’en-tête sélectionné passe à la première position ; false si les en-têtes conservent toujours la même position. La valeur par défaut est true.

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Cette propriété n’a d’effet que lorsque le pivot n’a pas suffisamment d’espace pour afficher tous les en-têtes. Si l’espace est disponible, tous les en-têtes sont affichés, quel que soit ce paramètre de propriété.

Par défaut, l’en-tête pivot sélectionné se déplace toujours à la première position (à gauche) et le carrousel d’en-têtes. L’utilisateur peut effectuer un panoramique à l’infini et le contenu est simplement encapsulé de l’avant vers l’arrière.

Lorsque cette propriété a la valeur false, les en-têtes pivot conservent toujours la même position. Le défilement est activé pour afficher les en-têtes qui ne correspondent pas à la fenêtre d’affichage.

Compatibilité des versions

La propriété IsHeaderItemsCarouselEnabled n’est pas disponible avant Windows 10 version 1607. Si le paramètre « version minimale de la plateforme » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions précédentes de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

<Pivot x:Name="pivot1" Loaded="Pivot_Loaded">
    ...
</Pivot>

private void Pivot_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Pivot", "IsHeaderItemsCarouselEnabled"))
    {
        pivot1.IsHeaderItemsCarouselEnabled = false;
    }
}