Compartir a través de


ScrollViewer.VerticalSnapPointsType Propiedad

Definición

Obtiene o establece un valor que declara cómo reacciona el comportamiento de manipulación a los puntos de acoplamiento a lo largo del eje 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" />

Valor de propiedad

Valor de la enumeración. El valor predeterminado es None , pero puede establecerse a través de una plantilla de control.

Ejemplos

Este CÓDIGO XAML procede de la plantilla predeterminada para un control Hub . Un concentrador tiene una parte ScrollViewer que rodea un ItemsStackPanel para su contenido. Hub usa el valor Opcional para su comportamiento de ajuste en ambas dimensiones (aunque VerticalScrollMode está deshabilitado en los estados visuales iniciales) y deshabilita ZoomMode. Observe cómo las propiedades SnapPointsAlignment también se establecen como atributos aquí.

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

Comentarios

Para las acciones de movimiento panorámico, a menudo hay lugares de detención naturales. Los puntos de acoplamiento proporcionan una manera de indicar dónde están estos lugares. A continuación, cuando un usuario desliza el dedo, el resultado de la manipulación favorece ese punto natural mediante el comportamiento expresado por un valor SnapPointsType .

**Puntos de proximidad (Opcional y OpcionalSingle): ** Cuando un usuario va a detener naturalmente la manipulación en la proximidad de un punto de acoplamiento, los puntos de proximidad ayudan al usuario a llegar al lugar de detención natural. Dado que el usuario tiene que llegar cerca del punto de acoplamiento para que se detenga allí, a veces el usuario tendrá que realizar otro deslizamiento para alcanzar un punto de acoplamiento.

**Puntos de acoplamiento obligatorios (Obligatorio y ObligatorioSingle): ** A diferencia de la proximidad, los puntos de acoplamiento obligatorios garantizan que el contenido se ajuste para que siempre llegue a un punto de acoplamiento. Incluso si el usuario libera la manipulación a mitad de camino entre dos puntos de acoplamiento, siempre se moverá a uno de los puntos de acoplamiento.

Para ver los efectos de los puntos de acoplamiento en el comportamiento de ScrollViewer , obtén el ejemplo de desplazamiento panorámico, movimiento panorámico y zoom xaml. Ejecute el ejemplo en un dispositivo táctil (no en el simulador). Pruebe los valores de SnapPointsType al ver la página de ejemplo "Movimiento panorámico con puntos de acoplamiento" del ejemplo.

Para obtener más información sobre el gesto de deslizar el dedo y el movimiento panorámico, consulte la sección "Comportamientos de movimiento panorámico" de Directrices para el movimiento panorámico.

El valor predeterminado de None es el valor predeterminado de la enumeración. Si se establece, esta propiedad suele establecerse como un atributo en una parte de plantilla XAML o como establecedor de estilo. Cada control puede establecer esto de forma diferente. La obtención del valor en tiempo de ejecución proporcionará el valor que procede de las plantillas y estilos aplicados.

Se aplica a

Consulte también