AppBarButton.IsInOverflow 属性

定义

获取一个值,该值指示此项是否在溢出菜单中。

public:
 property bool IsInOverflow { bool get(); };
bool IsInOverflow();
public bool IsInOverflow { get; }
var boolean = appBarButton.isInOverflow;
Public ReadOnly Property IsInOverflow As Boolean

属性值

Boolean

bool

如果此项位于溢出菜单中,则为 true;否则为 false

实现

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

版本兼容性

在 Windows 10 版本 1607 之前,IsInOverflow 属性不可用。 如果 Microsoft Visual Studio 中应用的“最低平台版本”设置小于本页稍后的“要求”块中显示的“引入版本”,则必须设计和测试应用以考虑到这一点。 有关详细信息,请参阅 版本自适应代码

注意

为 Windows 10 版本 1607 编译应用并在版本 1607 (或更高版本) 上运行时,可以使用动态溢出。 当应用针对以前的版本编译或在以前版本上运行时,动态溢出不可用。

若要避免在以前版本的 Windows 10 上运行应用时出现异常,请不要在未首先执行运行时检查的情况下使用此属性。 此示例演示如何使用 ApiInformation 类在使用此属性之前检查此属性是否存在。

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.AppBarButton", "IsInOverflow"))
{
    bool overflow = appBarButton1.IsInOverflow;
}

适用于

另请参阅