Pivot.IsHeaderItemsCarouselEnabled Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Obtiene o establece un valor que indica si el encabezado seleccionado se mueve a la primera posición.

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 de propiedad

Boolean

bool

true si el encabezado seleccionado se mueve a la primera posición; false si los encabezados siempre mantienen la misma posición. El valor predeterminado es true.

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Esta propiedad solo tiene un efecto cuando el Pivot no tiene suficiente espacio para mostrar todos los encabezados. Si el espacio está disponible, se muestran todos los encabezados independientemente de esta configuración de propiedad.

De forma predeterminada, el encabezado dinámico seleccionado siempre se mueve a la primera posición (a la izquierda) y el carrusel de encabezados. El usuario puede desplazarse de forma infinita y el contenido simplemente se ajusta de frente a atrás.

Cuando esta propiedad es false, los encabezados dinámicos siempre mantienen la misma posición. El desplazamiento está habilitado para mostrar los encabezados que no caben en la ventanilla.

Compatibilidad de versiones

La propiedad IsHeaderItemsCarouselEnabled no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.

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