CommandBar.IsDynamicOverflowEnabled Propriété

Définition

Espace de noms:

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

Remarques

Pour plus d’informations et pour obtenir des instructions, consultez l’article 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 de plateforme minimale » 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 tenir compte de cela. Pour plus d’informations, consultez Code adaptatif de version.

Notes

Le dépassement de capacité dynamique est disponible lorsque votre application est compilée pour Windows 10, version 1607 et s’exécutant 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 qu’elle 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 effectuer au préalable 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;
    }
}