CommandBar.IsDynamicOverflowEnabled Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Obtient ou définit une valeur qui indique si les commandes principales se déplacent automatiquement vers le menu de dépassement de capacité lorsque l’espace est limité.

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

bool IsDynamicOverflowEnabled();

void IsDynamicOverflowEnabled(bool value);

public bool IsDynamicOverflowEnabled { get; set; }

var boolean = commandBar.isDynamicOverflowEnabled;
commandBar.isDynamicOverflowEnabled = boolean;

Public Property IsDynamicOverflowEnabled As Boolean

<CommandBar IsDynamicOverflowEnabled="bool"/>

Valeur de propriété

Boolean

bool

true si les commandes principales se déplacent automatiquement vers le menu de dépassement de capacité lorsque l’espace est limité ; sinon, false. 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

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.

Compatibilité des versions

La propriété IsDynamicOverflowEnabled 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 antérieures de Windows 10, n’utilisez pas cette propriété sans avoir d’abord effectué une 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 l’utiliser.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    ...
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.CommandBar", "IsDynamicOverflowEnabled"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
    }
}