ScrollViewer.VerticalSnapPointsType Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml.Controls
Modifica

Ottiene o imposta un valore che dichiara il modo in cui il comportamento di manipolazione reagisce ai punti di ancoraggio lungo l'asse verticale.

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

Valore della proprietà

SnapPointsType

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 racchiude itemsStackPanel per il relativo contenuto. Hub usa il valore Facoltativo per il comportamento di allineamento in entrambe le dimensioni (anche se VerticalScrollMode è disabilitato negli stati di visualizzazione iniziale) e disabilita ZoomMode. Si noti che anche le proprietà SnapPointsAlignment vengono impostate 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 ancoraggio consentono di indicare dove si trovano questi punti. Quindi, quando un utente scorre rapidamente, il risultato della manipolazione favorisce il punto naturale usando il comportamento espresso da un valore SnapPointsType .

**Punti di prossimità (facoltativi e facoltativi): ** Quando un utente interrompe naturalmente la manipolazione in prossimità di un punto di ancoraggio, i punti di prossimità aiutano l'utente a atterrare nel luogo di arresto naturale. Poiché l'utente deve atterrare in prossimità del punto di ancoraggio per impedirne l'arresto, a volte l'utente dovrà eseguire un altro scorrimento rapido per raggiungere un punto di ancoraggio.

**Punti di ancoraggio obbligatori (Obbligatorio e ObbligatorioSingle): ** A differenza della prossimità, i punti di ancoraggio obbligatori assicurano che il contenuto venga regolato in modo che venga sempre impostato su un punto di ancoraggio. Anche se l'utente rilascia la manipolazione a metà tra due punti di ancoraggio, passerà sempre a uno dei punti di ancoraggio.

Per visualizzare manualmente gli effetti dei punti di ancoraggio sul comportamento di ScrollViewer , ottieni l'esempio di scorrimento, panoramica e zoom XAML. 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 ancoraggio" 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 è l'impostazione predefinita dell'enumerazione . Se è impostata, questa proprietà viene spesso impostata come attributo in una parte del modello XAML o come setter di stile. Ogni controllo imposta questo valore in modo diverso. Ottenere il valore in fase di esecuzione fornirà il valore proveniente da stili e modelli applicati.

Si applica a

Vedi anche