CommandBar.DynamicOverflowItemsChanging Événement

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Se produit lorsque des éléments sont déplacés vers ou en dehors du menu de dépassement de capacité.

// Register
event_token DynamicOverflowItemsChanging(TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;

// Revoke with event_token
void DynamicOverflowItemsChanging(event_token const* cookie) const;

// Revoke with event_revoker
CommandBar::DynamicOverflowItemsChanging_revoker DynamicOverflowItemsChanging(auto_revoke_t, TypedEventHandler<CommandBar, DynamicOverflowItemsChangingEventArgs const&> const& handler) const;

public event TypedEventHandler<CommandBar,DynamicOverflowItemsChangingEventArgs> DynamicOverflowItemsChanging;

function onDynamicOverflowItemsChanging(eventArgs) { /* Your code */ }
commandBar.addEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
commandBar.removeEventListener("dynamicoverflowitemschanging", onDynamicOverflowItemsChanging);
- or -
commandBar.ondynamicoverflowitemschanging = onDynamicOverflowItemsChanging;

Public Custom Event DynamicOverflowItemsChanging As TypedEventHandler(Of CommandBar, DynamicOverflowItemsChangingEventArgs) 

<CommandBar DynamicOverflowItemsChanging="eventhandler"/>

Type d'événement

TypedEventHandler<CommandBar,DynamicOverflowItemsChangingEventArgs>

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 les données d’événement, consultez DynamicOverflowItemsChangingEventArgs.

À 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

L’événement 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, ne connectez pas cet événement 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 cet événement avant de l’utiliser.

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

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.CommandBar", "DynamicOverflowItemsChanging"))
    {
        commandBar1.DynamicOverflowItemsChanging += CommandBar1_DynamicOverflowItemsChanging;
    }
}

Voir aussi

• DynamicOverflowItemsChangingEventArgs
• Barre de l’application et barre de commandes