CommandBar.DynamicOverflowItemsChanging Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn Elemente in oder aus dem Überlaufmenü verschoben werden.
// 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"/>
Ereignistyp
Windows-Anforderungen
Gerätefamilie |
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)
|
Hinweise
Ereignisdaten finden Sie unter DynamicOverflowItemsChangingEventArgs.
Ab Windows 10 Version 1607 führt CommandBar ein dynamisches Überlauffeature ein. PrimaryCommands wird standardmäßig automatisch in oder aus dem Überlaufbereich verschoben, wenn sich die Breite der Befehlsleiste ändert, z. B. wenn Benutzer die Größe ihres App-Fensters ändern. Sie können die IsDynamicOverflowEnabled-Eigenschaft auf false festlegen, um dieses Verhalten zu deaktivieren.
Dynamischer Überlauf wirkt sich nur auf die Darstellung der Befehle auf der Benutzeroberfläche aus. Befehle aus der PrimaryCommands-Auflistung werden nicht nach SecondaryCommands verschoben.
Versionskompatibilität
Das IsDynamicOverflowEnabled-Ereignis ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.
Hinweis
Dynamischer Überlauf ist verfügbar, wenn Ihre App für Windows 10, Version 1607, kompiliert und unter Version 1607 (oder höher) ausgeführt wird. Der dynamische Überlauf ist nicht verfügbar, wenn Ihre App für eine frühere Version kompiliert wird oder in einer früheren Version ausgeführt wird.
Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, verbinden Sie dieses Ereignis nicht, ohne vorher eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob dieses Ereignis vorhanden ist, bevor Sie es verwenden.
<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;
}
}