AppBarSeparator.DynamicOverflowOrder 属性

  • 参考

定义

命名空间:
Microsoft.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 = appBarSeparator.dynamicOverflowOrder;
appBarSeparator.dynamicOverflowOrder = int32;
Public Property DynamicOverflowOrder As Integer
<AppBarSeparator DynamicOverflowOrder="int" .../>

属性值

Int32

int

此项相对于其他项移动到溢出菜单的顺序。

实现

DynamicOverflowOrder

注解

有关详细信息和指南，请参阅 命令栏 一文。

从 Windows 10 版本 1607 开始，CommandBar 引入了动态溢出功能。 默认情况下，当命令栏宽度发生变化时， PrimaryCommands 会自动移入或移出溢出区域，例如，当用户调整其应用窗口的大小时。 可以将 IsDynamicOverflowEnabled 属性设置为 false 以禁用此行为。

动态溢出仅影响命令的 UI 表示形式，它不会将命令从 PrimaryCommands 集合移动到 SecondaryCommands。

仅当此元素位于 CommandBar.PrimaryCommands 集合中并且 CommandBar.IsDynamicOverflowEnabled为 true 时，此属性才有效。

可以将相同的 DynamicOverflowOrder 值分配给多个元素。 具有相同值的元素同时移入和移出溢出区域。

版本兼容性

DynamicOverflowOrder 属性在 Windows 10 版本 1607 之前不可用。 如果 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.AppBarSeparator", "DynamicOverflowOrder"))
    {
        commandBar1.IsDynamicOverflowEnabled = true;
        appBarButtonCut.DynamicOverflowOrder = 1;
        appBarButtonCopy.DynamicOverflowOrder = 2;
        appBarSeparator1.DynamicOverflowOrder = 2;
        appBarButtonPaste.DynamicOverflowOrder = 3;
    }
}

适用于