CommandBar.DynamicOverflowItemsChanging Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando gli elementi si spostano nel menu overflow o fuori dal menu di overflow.
// 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"/>
Tipo evento
Commenti
Per i dati dell'evento, vedere DynamicOverflowItemsChangingEventArgs.
A partire da Windows 10, versione 1607, CommandBar introduce una funzionalità di overflow dinamica. Per impostazione predefinita, PrimaryCommands si sposta automaticamente nell'area di overflow perché la larghezza della barra dei comandi cambia, ad esempio quando gli utenti ridimensionano la finestra dell'app. È possibile impostare la proprietà IsDynamicOverflowEnabled su false per disabilitare questo comportamento.
Il overflow dinamico influisce solo sulla presentazione dell'interfaccia utente dei comandi, non sposta i comandi dall'insieme PrimaryCommands a SecondaryCommands.
Compatibilità tra versioni
L'evento IsDynamicOverflowEnabled non è disponibile prima di Windows 10, versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è minore della versione "introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per l'account. Per altre informazioni, vedere Codice adattivo della versione.
Nota
Il overflow dinamico è disponibile quando l'app viene compilata per Windows 10, versione 1607 ed in esecuzione nella versione 1607 (o successiva). Il overflow dinamico non è disponibile quando l'app viene compilata per una versione precedente o è in esecuzione in una versione precedente.
Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non connettersi a questo evento senza prima eseguire un controllo di runtime. In questo esempio viene illustrato come usare la classe ApiInformation per verificare la presenza di questo evento prima di usarla.
<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;
}
}