ScrollViewer.VerticalSnapPointsType プロパティ

定義

名前空間:

Windows.UI.Xaml.Controls

縦軸に沿ったスナップ ポイントに対する操作動作の反応を宣言する値を取得または設定します。

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

SnapPointsType VerticalSnapPointsType();

void VerticalSnapPointsType(SnapPointsType value);

public SnapPointsType VerticalSnapPointsType { get; set; }

var snapPointsType = scrollViewer.verticalSnapPointsType;
scrollViewer.verticalSnapPointsType = snapPointsType;

Public Property VerticalSnapPointsType As SnapPointsType

<ScrollViewer VerticalSnapPointsType="snapPointsTypeMemberName" />

プロパティ値

SnapPointsType

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

例

この XAML は、 ハブ コントロールの既定のテンプレートから取得されます。 ハブには、コンテンツの ItemsStackPanel を囲む ScrollViewer パーツがあります。 ハブ では、両方のディメンションでスナップ動作に Optional 値を使用し (ただし、Visual 状態の開始では 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 スクロール、パン、ズームのサンプル
• スクロール ビューアー コントロール
• パンのガイドライン