CommandBar.DynamicOverflowItemsChanging Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque des éléments sont déplacés dans ou hors 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
Remarques
Pour obtenir des 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 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 les versions précédentes 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;
}
}