Pivot.IsHeaderItemsCarouselEnabled Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que indica se o cabeçalho selecionado se move para a primeira posição.

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

Valor da propriedade

Boolean

bool

true se o cabeçalho selecionado for movido para a primeira posição; false se os cabeçalhos sempre mantiverem a mesma posição. O padrão é true.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

Essa propriedade só tem efeito quando o Pivot não tem espaço suficiente para mostrar todos os cabeçalhos. Se o espaço estiver disponível, todos os cabeçalhos serão mostrados independentemente dessa configuração de propriedade.

Por padrão, o cabeçalho dinâmico selecionado sempre se move para a primeira posição (extrema esquerda) e o carrossel de cabeçalhos. O usuário pode se agrupar infinitamente e o conteúdo é encapsulado de frente para trás.

Quando essa propriedade é falsa, os cabeçalhos dinâmicos sempre mantêm a mesma posição. A rolagem está habilitada para mostrar cabeçalhos que não se encaixam no visor.

Compatibilidade de versões

A propriedade IsHeaderItemsCarouselEnabled não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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