AppBarToggleButton.DynamicOverflowOrder Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit l’ordre dans lequel cet élément est déplacé vers le menu de dépassement de la barre de commandes .

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarToggleButton.dynamicOverflowOrder;
appBarToggleButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarToggleButton DynamicOverflowOrder="int" .../>

Valeur de propriété

Int32

int

Ordre dans lequel cet élément est déplacé vers le menu de dépassement de capacité par rapport aux autres éléments.

Implémente

DynamicOverflowOrder

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

Pour plus d’informations et pour obtenir des instructions, consultez l’article Barre de l’application et barre de commandes .

À compter de Windows 10 version 1607, CommandBar introduit une fonctionnalité de dépassement de capacité dynamique. Par défaut, PrimaryCommands se déplace automatiquement dans ou hors de la zone de dépassement de capacité à mesure que la largeur de la barre de commandes change, par exemple, lorsque les utilisateurs redimensionnent leur fenêtre d’application. Vous pouvez définir la propriété IsDynamicOverflowEnabled sur false pour désactiver ce comportement.

Le dépassement de capacité dynamique affecte uniquement la présentation de l’interface utilisateur des commandes. Il ne déplace pas les commandes de la collection PrimaryCommands vers SecondaryCommands.

Cette propriété a un effet uniquement lorsque cet élément se trouve dans la collection CommandBar.PrimaryCommands et que CommandBar.IsDynamicOverflowEnabled a la valeur true.

Vous pouvez affecter la même valeur DynamicOverflowOrder à plusieurs éléments. Les éléments ayant la même valeur se déplacent en même temps dans la zone de dépassement de capacité.

Compatibilité des versions

La propriété DynamicOverflowOrder 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.

Notes

Le dépassement de capacité dynamique est disponible lorsque votre application est compilée pour Windows 10 version 1607 et s’exécute sur la version 1607 (ou ultérieure). Le dépassement de capacité dynamique n’est pas disponible lorsque votre application est compilée pour une version précédente ou s’exécute sur une version précédente.

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.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarToggleButton x:Name="appBarButtonShuffle" Icon="Shuffle" Label="Shuffle"/>
    <AppBarToggleButton x:Name="appBarButtonRepeat" Icon="RepeatAll" Label="Repeat"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarToggleButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonShuffle.DynamicOverflowOrder = 1;
        appBarButtonRepeat.DynamicOverflowOrder = 2;
    }
}