ScrollViewer.HorizontalSnapPointsType Proprietà

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

Valore della proprietà

Valore dell'enumerazione. Il valore predefinito è Nessuno , ma potrebbe essere impostato tramite un modello di controllo.

Esempio

Questo CODICE XAML proviene dal modello predefinito per un controllo Hub . Un hub ha una parte ScrollViewer che circonda un oggetto ItemsStackPanel per il relativo contenuto. Hub usa il valore Facoltativo per il comportamento di snapping in entrambe le dimensioni (anche se VerticalScrollMode è disabilitato negli stati visivi iniziali) e disabilita ZoomMode. Si noti come le proprietà SnapPointsAlignment sono impostate anche come attributi qui.

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

Commenti

Per le azioni di panoramica, ci sono spesso luoghi di arresto naturale. I punti di snap forniscono un modo per indicare dove si trovano queste posizioni. Quindi, quando un utente scorre, il risultato della manipolazione favorisce il comportamento naturale usando il comportamento espresso da un valore SnapPointsType .

**Punti di prossimità (Facoltativo e FacoltativoSingle): ** Quando un utente interrompe naturalmente la manipolazione nella prossimità di un punto di snap, i punti di prossimità consentono all'utente di entrare nella posizione di arresto naturale. Poiché l'utente deve atterrare in prossimità del punto di snap per causare l'arresto, l'utente a volte dovrà eseguire un altro scorrimento rapido per raggiungere un punto di snap.

**Punti di snap obbligatori (Obbligatorio e ObbligatorioSingle) : ** In contrasto con la prossimità, i punti di snap obbligatori assicurano che il contenuto venga modificato in modo che il contenuto venga sempre impostato su un punto di snap. Anche se l'utente rilascia la manipolazione a metà tra due punti di snap, verrà sempre spostata in uno dei punti di snap.

Per visualizzare gli effetti dei punti di snap sul comportamento di ScrollViewer , ottenere l'esempio di scorrimento XAML, panoramica e zoom. Eseguire l'esempio in un dispositivo touch (non nel simulatore). Provare i valori SnapPointsType quando si visualizza la pagina di esempio "Panoramica con punti di snap" dell'esempio.

Per altre informazioni sul movimento di scorrimento rapido e sulla panoramica, vedere la sezione "Comportamenti di panoramica" di Linee guida per la panoramica.

Il valore predefinito none è il valore predefinito dell'enumerazione. Se è impostato, questa proprietà viene spesso impostata come attributo in una parte del modello XAML o come setter di stile. Ogni controllo imposta in modo diverso questo controllo. Ottenere il valore in fase di esecuzione fornirà il valore proveniente da stili e modelli applicati.

Si applica a

Vedi anche

• SnapPointsType
• Esempio di scorrimento, panoramica e zoom con XAML
• Controlli visualizzatore a scorrimento
• Linee guida per la panoramica