AppBarButton.IsInOverflow 属性

定义

命名空间:

Windows.UI.Xaml.Controls

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

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。

实现

IsInOverflow

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

另请参阅

• 应用栏和命令栏指南