Pivot.IsHeaderItemsCarouselEnabled Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene o imposta un valore che indica se l'intestazione selezionata viene spostata nella prima posizione.

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

Valore della proprietà

Boolean

bool

true se l'intestazione selezionata passa alla prima posizione; false se le intestazioni mantengono sempre la stessa posizione. Il valore predefinito è True.

Commenti

Questa proprietà ha un effetto solo quando lo spazio del pivot non è sufficiente per visualizzare tutte le intestazioni. Se lo spazio è disponibile, tutte le intestazioni vengono visualizzate indipendentemente da questa impostazione della proprietà.

Per impostazione predefinita, l'intestazione Pivot selezionata passa sempre alla prima posizione (all'estrema sinistra) e alle intestazioni carousel. L'utente può eseguire la panoramica all'infinito e il contenuto esegue il wrapping dall'inizio verso il retro.

Quando questa proprietà è false, le intestazioni pivot mantengono sempre la stessa posizione. Lo scorrimento è abilitato per visualizzare le intestazioni che non rientrano nel riquadro di visualizzazione.

Compatibilità tra versioni

La proprietà IsHeaderItemsCarouselEnabled non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.

Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.

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