Pivot.IsHeaderItemsCarouselEnabled 属性

定义

命名空间:

Windows.UI.Xaml.Controls

获取或设置一个值，该值指示所选标头是否移动到第一个位置。

public:
 property bool IsHeaderItemsCarouselEnabled { bool get(); void set(bool value); };

bool IsHeaderItemsCarouselEnabled();

void IsHeaderItemsCarouselEnabled(bool value);

public bool IsHeaderItemsCarouselEnabled { get; set; }

var boolean = pivot.isHeaderItemsCarouselEnabled;
pivot.isHeaderItemsCarouselEnabled = boolean;

Public Property IsHeaderItemsCarouselEnabled As Boolean

<Pivot IsHeaderItemsCarouselEnabled="bool" />

属性值

Boolean

bool

如果所选标头移动到第一个位置，则为 true;如果标头始终保留相同的位置，则为 false。 默认值为 true。

Windows 要求

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

注解

仅当 Pivot 没有足够的空间显示所有标头时，此属性才有效。 如果空间可用，则无论此属性设置如何，都会显示所有标头。

默认情况下，所选 的 Pivot 标头始终移动到) 最左侧 (第一个位置，并且标头将轮播。 用户可以无限平移，内容只是从前到后环绕。

如果此属性为 false， 则 Pivot 标头始终保留相同的位置。 启用滚动以显示不适合视区中的标题。

版本兼容性

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

若要避免应用在以前版本的 Windows 10 上运行时出现异常，请勿在 XAML 中设置此属性，或者在不执行运行时检查的情况下使用它。 此示例演示如何使用 ApiInformation 类在设置此属性之前检查此属性是否存在。

<Pivot x:Name="pivot1" Loaded="Pivot_Loaded">
    ...
</Pivot>

private void Pivot_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Pivot", "IsHeaderItemsCarouselEnabled"))
    {
        pivot1.IsHeaderItemsCarouselEnabled = false;
    }
}