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 で導入)

注釈

このプロパティは、ピボットにすべてのヘッダーを表示するのに十分な領域がない場合にのみ有効です。 スペースが使用可能な場合、このプロパティ設定に関係なく、すべてのヘッダーが表示されます。

既定では、選択した ピボット ヘッダーは常に最初の位置 (左端) に移動し、ヘッダーカルーセルは移動します。 ユーザーは無限にパンでき、コンテンツは前から後ろまでラップするだけです。

このプロパティが false の場合、 ピボット ヘッダーは常に同じ位置を保持します。 ビューポートに収まらないヘッダーを表示するには、スクロールが有効になっています。

バージョンの互換性

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