ScrollViewer.VerticalSnapPointsType 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 vertical.

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

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 Optional pour son comportement d’alignement dans les deux dimensions (bien que VerticalScrollMode soit désactivé dans les états visuels de démarrage) 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 de panoramique, il existe souvent des arrêts naturels. Les points d’ancrage permettent d’indiquer où se trouvent ces endroits. Ensuite, lorsqu’un utilisateur effectue un balayage, le résultat de la manipulation favorise ce point naturel à l’aide d’un comportement exprimé par une valeur SnapPointsType .

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

**Points d’ancrage obligatoires (Obligatoire et ObligatoireSingle) : ** 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 libère 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 l’exemple de page « Panoramique avec des points d’ancrage » de l’exemple.

Pour en savoir plus sur le mouvement de balayage et le panoramique, consultez la section « Comportements de panoramique » de Recommandations pour le 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 un composant de modèle XAML ou en tant que setter de style. Chaque contrôle peut 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