CommandBar.IsDynamicOverflowEnabled Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert ab, der angibt, ob primäre Befehle automatisch in das Überlaufmenü verschoben werden, wenn der Platz begrenzt ist, oder legt diesen fest.

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"/>

Eigenschaftswert

Boolean

bool

TRUE , wenn primäre Befehle automatisch in das Überlaufmenü verschoben werden, wenn der Platz begrenzt ist; Andernfalls false. Der Standardwert ist true.

Hinweise

Weitere Informationen und Richtlinien finden Sie im Artikel Befehlsleiste .

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, es werden keine Befehle aus der PrimaryCommands-Auflistung in SecondaryCommands verschoben.

Versionskompatibilität

Die IsDynamicOverflowEnabled-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Hinweis

Dynamischer Überlauf ist verfügbar, wenn Ihre App für Windows 10, Version 1607, kompiliert wird und unter Version 1607 (oder höher) ausgeführt wird. Dynamischer Überlauf ist nicht verfügbar, wenn Ihre App für eine frühere Version kompiliert wird oder unter einer früheren Version ausgeführt wird.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, verwenden Sie diese Eigenschaft nicht, ohne zuerst eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie verwenden.

<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;
    }
}