AppBarButton.DynamicOverflowOrder Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft die Reihenfolge ab, in der dieses Element in das CommandBar-Überlaufmenü verschoben wird, oder legt diese fest.

public:
 property int DynamicOverflowOrder { int get(); void set(int value); };

int DynamicOverflowOrder();

void DynamicOverflowOrder(int value);

public int DynamicOverflowOrder { get; set; }

var int32 = appBarButton.dynamicOverflowOrder;
appBarButton.dynamicOverflowOrder = int32;

Public Property DynamicOverflowOrder As Integer

<AppBarButton DynamicOverflowOrder="int" .../>

Eigenschaftswert

Int32

int

Die Reihenfolge, in der dieses Element relativ zu anderen Elementen in das Überlaufmenü verschoben wird.

Implementiert

DynamicOverflowOrder

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

Weitere Informationen und Richtlinien finden Sie im Artikel App-Leiste und 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. Befehle aus der PrimaryCommands-Auflistung werden nicht nach SecondaryCommands verschoben.

Diese Eigenschaft hat nur auswirkungen, wenn sich dieses Element in der CommandBar.PrimaryCommands-Auflistung befindet und CommandBar.IsDynamicOverflowEnabledtrue ist.

Sie können mehreren Elementen denselben DynamicOverflowOrder-Wert zuweisen. Elemente mit dem gleichen Wert werden gleichzeitig in den Überlaufbereich ein- und aus dem Überlaufbereich verschoben.

Versionskompatibilität

Die DynamicOverflowOrder-Eigenschaft 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, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitprü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 festlegen.

<CommandBar x:Name="commandBar1" Loaded="CommandBar_Loaded">
    <AppBarButton x:Name="appBarButtonCut" Icon="Cut" Label="Cut"/>
    <AppBarButton x:Name="appBarButtonCopy" Icon="Copy" Label="Copy"/>
    <AppBarSeparator x:Name="appBarSeparator1"/>
    <AppBarButton x:Name="appBarButtonPaste" Icon="Paste" Label="Paste"/>
</CommandBar>

private void CommandBar_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}