Pivot.IsHeaderItemsCarouselEnabled プロパティ

定義

名前空間:

Microsoft.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です。

注釈

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

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

このプロパティが 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;
    }
}