ScrollViewer.HorizontalSnapPointsType Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

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

Valor de propiedad

SnapPointsType

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

Ejemplos

Este 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. Tenga en cuenta 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 aterrizar en el 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 se establece a menudo como un atributo en un elemento de plantilla XAML o como establecedor de estilo. Cada control puede establecerlo de forma diferente. La obtención del valor en tiempo de ejecución proporcionará el valor que procede de las plantillas y estilos aplicados.

Consulte también

• SnapPointsType
• Muestra de desplazamiento, movimiento panorámico y zoom XAML
• Controles del visor de desplazamiento
• Directrices sobre movimiento panorámico