AppBarButton.DynamicOverflowOrder 屬性

定義

命名空間:

Windows.UI.Xaml.Controls

取得或設定此專案移至 CommandBar 溢位功能表的順序。

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

屬性值

Int32

int

此專案相對於其他專案移至溢位功能表的順序。

實作

DynamicOverflowOrder

Windows 需求

裝置系列	Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

如需詳細資訊和指導方針，請參閱 應用程式行和命令列 一文。

從 Windows 10 1607 版開始，CommandBar引進了動態溢位功能。 根據預設， PrimaryCommands 會在命令列寬度變更時自動移入或移出溢位區域，例如，當使用者調整其應用程式視窗的大小時。 您可以將 IsDynamicOverflowEnabled 屬性設定為 false ，以停用此行為。

動態溢位只會影響命令的 UI 呈現，它不會將命令從PrimaryCommands 集合移至 SecondaryCommands。

只有當這個專案位於 CommandBar.PrimaryCommands 集合中，而 CommandBar.IsDynamicOverflowEnabled 為 true時，此屬性才會生效。

您可以將相同的 DynamicOverflowOrder 值指派給多個元素。 具有相同值的專案同時移入和移出溢位區域。

版本相容性

DynamicOverflowOrder 屬性在 Windows 10 1607 版之前無法使用。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程式碼。

注意

當您的應用程式編譯Windows 10版本 1607 並在 1607 版 (或更新版本) 上執行時，可以使用動態溢位。 當您的應用程式針對舊版編譯或在舊版上執行時，無法使用動態溢位。

若要避免在舊版Windows 10上執行應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別，在設定此屬性之前檢查此屬性是否存在。

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