Pivot.IsHeaderItemsCarouselEnabled Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft einen Wert ab, der angibt, ob der ausgewählte Header an die erste Position verschoben wird, oder legt diesen fest.

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

Eigenschaftswert

Boolean

bool

true , wenn der ausgewählte Header an die erste Position verschoben wird; false , wenn Header immer dieselbe Position beibehalten. Der Standardwert ist true.

Hinweise

Diese Eigenschaft wirkt sich nur aus, wenn der Pivot nicht über genügend Platz verfügt, um alle Header anzuzeigen. Wenn Speicherplatz verfügbar ist, werden alle Header unabhängig von dieser Eigenschaftseinstellung angezeigt.

Standardmäßig wird der ausgewählte Pivot-Header immer an die erste Position (ganz links) und das Kopfzeilenkarussell verschoben. Der Benutzer kann unendlich schwenken, und der Inhalt wird einfach von vorne nach hinten umwickelt.

Wenn diese Eigenschaft false ist, behalten die Pivot-Header immer dieselbe Position bei. Der Bildlauf ist aktiviert, um Kopfzeilen anzuzeigen, die nicht in den Viewport passen.

Versionskompatibilität

Die IsHeaderItemsCarouselEnabled-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner ist als die "eingeführte Version", die im Block Anforderungen weiter unten auf dieser Seite angezeigt wird, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Adaptiver Versionscode.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um zu überprüfen, ob diese Eigenschaft vorhanden ist, bevor Sie sie festlegen.

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