ScrollViewer.HorizontalSnapPointsType Propriété

  • Référence

Définition

Espace de noms:
Windows.UI.Xaml.Controls
Modifier

Obtient ou définit une valeur qui déclare comment le comportement de manipulation réagit aux points d’ancrage le long de l’axe horizontal.

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" />

Valeur de propriété

SnapPointsType

Valeur de l’énumération. La valeur par défaut est None , mais peut être définie via un modèle de contrôle.

Exemples

Ce code XAML provient du modèle par défaut d’un contrôle Hub . Un hub a une partie ScrollViewer qui entoure un ItemsStackPanel pour son contenu. Hub utilise la valeur Facultatif pour son comportement d’alignement dans les deux dimensions (bien que VerticalScrollMode soit désactivé dans les états visuels de départ) et désactive ZoomMode. Notez comment les propriétés SnapPointsAlignment sont également définies en tant qu’attributs ici.

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

Remarques

Pour les actions panoramiques, il existe souvent des arrêts naturels. Les points d’ancrage permettent d’indiquer où se trouvent ces emplacements. Ensuite, lorsqu’un utilisateur effectue un balayage, le résultat de la manipulation favorise ce point naturel à l’aide du comportement exprimé par une valeur SnapPointsType .

**Points de proximité (Facultatif et OptionalSingle) : ** Lorsqu’un utilisateur va arrêter naturellement la manipulation à proximité d’un point d’ancrage, les points de proximité aident l’utilisateur à se trouver à l’endroit d’arrêt naturel. Étant donné que l’utilisateur doit se trouver à proximité du point d’ancrage pour qu’il s’arrête là, l’utilisateur doit parfois effectuer un autre balayage pour atteindre un point d’ancrage.

**Points d’ancrage obligatoires (Obligatoire et MandatorySingle) : ** Contrairement à la proximité, les points d’ancrage obligatoires garantissent que le contenu est ajusté pour toujours atterrir sur un point d’ancrage. Même si l’utilisateur relâche la manipulation à mi-chemin entre deux points d’ancrage, il se déplace toujours vers l’un des points d’ancrage.

Pour voir vous-même les effets des points d’ancrage sur le comportement de ScrollViewer , obtenez l’exemple de défilement, de panoramique et de zoom XAML. Exécutez l’exemple sur un appareil tactile (et non sur le simulateur). Essayez les valeurs SnapPointsType lorsque vous affichez la page d’exemple « Panoramique avec des points d’ancrage » de l’exemple.

Pour en savoir plus sur le mouvement de balayage et le mouvement panoramique, consultez la section « Comportements de mouvement panoramique » de Recommandations pour le mouvement panoramique.

La valeur par défaut de None est la valeur par défaut de l’énumération. Si elle est définie, cette propriété est souvent définie en tant qu’attribut dans une partie de modèle XAML, ou en tant que setter de style. Chaque contrôle peut éventuellement définir cela différemment. L’obtention de la valeur au moment de l’exécution fournit la valeur provenant des styles et modèles appliqués.

S’applique à

Voir aussi