ScrollViewer.HorizontalSnapPointsType Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que declara como o comportamento da manipulação reage aos pontos de ajuste ao longo do eixo 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 da propriedade

SnapPointsType

Um valor da enumeração. O padrão é Nenhum , mas pode ser definido por meio de um modelo de controle.

Exemplos

Esse XAML é do modelo padrão para um controle hub . Um Hub tem uma parte ScrollViewer que envolve um ItemsStackPanel para seu conteúdo. O Hub usa o valor Opcional para seu comportamento de ajuste em ambas as dimensões (embora VerticalScrollMode esteja desabilitado nos estados visuais iniciais) e desabilite o ZoomMode. Observe como as propriedades SnapPointsAlignment também são definidas como atributos aqui.

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

Comentários

Para ações de movimento panorâmico, geralmente há locais de parada naturais. Os pontos de ajuste fornecem uma maneira de indicar onde esses locais estão. Em seguida, quando um usuário passa o dedo, o resultado da manipulação favorece esse ponto natural usando o comportamento, conforme expresso por um valor SnapPointsType .

**Pontos de proximidade (Opcional e OptionalSingle): ** Quando um usuário vai parar naturalmente a manipulação na proximidade de um ponto de ajuste, os pontos de proximidade ajudam o usuário a pousar no local de parada natural. Como o usuário precisa chegar próximo ao ponto de ajuste para fazer com que ele pare por aí, às vezes o usuário terá que executar outro deslize para chegar a um ponto de ajuste.

**Pontos de ajuste obrigatórios (Obrigatório e ObrigatórioSingle): ** Ao contrário da proximidade, os pontos de ajuste obrigatórios garantem que o conteúdo seja ajustado para sempre chegar a um ponto de ajuste. Mesmo que o usuário libere a manipulação no meio do caminho entre dois pontos de ajuste, ele sempre passará para um dos pontos de ajuste.

Para ver os efeitos dos pontos de ajuste no comportamento do ScrollViewer por conta própria, obtenha o exemplo de rolagem, movimento panorâmico e zoom XAML. Execute o exemplo em um dispositivo sensível ao toque (não no simulador). Experimente os valores snapPointsType ao exibir a página de exemplo "Movimento panorâmico com pontos de ajuste" do exemplo.

Para saber mais sobre o gesto de passar o dedo e o movimento panorâmico, consulte a seção "Comportamentos de movimento panorâmico" de Diretrizes para movimento panorâmico.

O valor padrão de None é o padrão da enumeração . Se estiver definida, essa propriedade geralmente será definida como um atributo em uma parte de modelo XAML ou como um Setter de estilo. Cada controle potencialmente define isso de forma diferente. Obter o valor em tempo de execução fornecerá o valor proveniente de estilos e modelos aplicados.

Confira também

• SnapPointsType
• Amostra de rolagem, movimento panorâmico e aplicação de zoom em XAML
• Controles do visualizador de rolagem
• Diretrizes de movimento panorâmico