ScrollViewer.HorizontalSnapPointsType プロパティ

定義

名前空間:

Windows.UI.Xaml.Controls

操作動作が横軸に沿ってスナップ ポイントにどのように反応するかを宣言する値を取得または設定します。

public:
 property SnapPointsType HorizontalSnapPointsType { SnapPointsType get(); void set(SnapPointsType value); };

SnapPointsType HorizontalSnapPointsType();

void HorizontalSnapPointsType(SnapPointsType value);

public SnapPointsType HorizontalSnapPointsType { get; set; }

var snapPointsType = scrollViewer.horizontalSnapPointsType;
scrollViewer.horizontalSnapPointsType = snapPointsType;

Public Property HorizontalSnapPointsType As SnapPointsType

<ScrollViewer HorizontalSnapPointsType="snapPointsTypeMemberName" />

プロパティ値

SnapPointsType

列挙体の値。 既定値は None ですが、コントロール テンプレートを使用して設定できます。

例

この XAML は、 ハブ コントロールの既定のテンプレートから取得されます。 ハブには、コンテンツの ItemsStackPanel を囲む ScrollViewer パーツがあります。 ハブ では、両方のディメンションでスナップ動作に Optional 値を使用し ( ただし、VerticalScrollMode は開始ビジュアル状態では無効になっています)、 ZoomMode を無効にします。 ここで、SnapPointsAlignment プロパティも属性として設定されることに注意してください。

<ControlTemplate TargetType="Hub">
...
<ScrollViewer x:Name="ScrollViewer"
    Grid.RowSpan="2"
    HorizontalScrollMode="Auto"
    HorizontalScrollBarVisibility="Auto"
    VerticalScrollMode="Disabled"
    VerticalScrollBarVisibility="Disabled"
    HorizontalSnapPointsAlignment="Near"
    HorizontalSnapPointsType="Optional"
    VerticalSnapPointsAlignment="Near"
    VerticalSnapPointsType="Optional"
    ZoomMode="Disabled">
  <ItemsStackPanel x:Name="Panel" 
       Orientation="{TemplateBinding Orientation}"
       CacheLength="20" />
</ScrollViewer>
...
</ControlTemplate>

注釈

パン操作の場合、多くの場合、自然な停止場所があります。 スナップ ポイントは、これらの場所がどこにあるかを示す方法を提供します。 次に、ユーザーがスワイプすると、操作の結果は 、SnapPointsType 値で表される動作を使用してその自然なポイントを優先します。

**近接ポイント (省略可能 および 省略可能): ** ユーザーがスナップ ポイントの近接で操作を自然に停止する場合、近接ポイントはユーザーが自然な停止場所に着陸するのに役立ちます。 ユーザーはスナップ ポイントに近接してスナップ ポイントに移動して停止する必要があるため、ユーザーはスナップ ポイントに到達するために別のスワイプを実行する必要がある場合があります。

**必須スナップ ポイント (必須 および 必須Single): ** 近接とは対照的に、必須のスナップ ポイントは、コンテンツが常にスナップ ポイントに配置されるように調整されていることを確認します。 ユーザーが 2 つのスナップ ポイント間の途中で操作を解放した場合でも、常にいずれかのスナップ ポイントに移動します。

ScrollViewer の動作に対するスナップ ポイントの効果を自分で確認するには、XAML のスクロール、パン、ズームのサンプルを取得します。 (シミュレーターではなく) タッチ デバイスでサンプルを実行します。 サンプルの [スナップ ポイントを使用したパン] のサンプル ページを表示するときに、 SnapPointsType の値を試してみてください。

スワイプ ジェスチャとパンの詳細については、「パンのガイドライン」の「パン動作」セクション を参照してください。

既定値の None は、列挙体の既定値です。 設定されている場合、このプロパティは XAML テンプレート パーツの属性として、またはスタイル Setter として設定されることがよくあります。 この設定は、各コントロールによって異なる場合があります。 実行時に値を取得すると、適用されたスタイルとテンプレートから取得された値が提供されます。

こちらもご覧ください

• SnapPointsType
• XAML のスクロール、パン、ズームのサンプル
• スクロール ビューアー コントロール
• パンのガイドライン