ScrollViewer.HorizontalSnapPointsType Eigenschaft

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft einen Wert ab, der deklariert, wie das Bearbeitungsverhalten auf die Einrastpunkte entlang der horizontalen Achse reagiert, oder legt diesen fest.

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

Eigenschaftswert

SnapPointsType

Ein Wert aus der Enumeration. Der Standardwert ist Keine , kann jedoch über eine Steuerelementvorlage festgelegt werden.

Beispiele

Dieser XAML-Code stammt aus der Standardvorlage für ein Hub-Steuerelement . Ein Hub verfügt über einen ScrollViewer-Teil , der ein ItemsStackPanel für seinen Inhalt umgibt. Hub verwendet den Wert Optional für sein Einrastverhalten in beiden Dimensionen (obwohl VerticalScrollMode in visuellen Startzuständen deaktiviert ist) und deaktiviert ZoomMode. Beachten Sie, dass die SnapPointsAlignment-Eigenschaften hier auch als Attribute festgelegt werden.

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

Hinweise

Für Schwenkaktionen gibt es oft natürliche Halteplätze. Einrastpunkte bieten eine Möglichkeit, anzugeben, wo sich diese Orte befinden. Wenn ein Benutzer dann wischt, begünstigt das Bearbeitungsergebnis diesen natürlichen Punkt mithilfe eines Verhaltens, das durch einen SnapPointsType-Wert ausgedrückt wird.

**Näherungspunkte (Optional und OptionalSingle): ** Wenn ein Benutzer die Manipulation in der Nähe eines Einrastpunkts auf natürliche Weise beendet, helfen Näherungspunkte dem Benutzer, am natürlichen Haltepunkt zu landen. Da der Benutzer in der Nähe des Einrastpunkts landen muss, damit er dort angehalten wird, muss der Benutzer manchmal einen weiteren Wischen ausführen, um einen Einrastpunkt zu erreichen.

**Obligatorische Einrastpunkte (Obligatorisch und ObligatorischSingle): ** Im Gegensatz zur Nähe stellen obligatorische Einrastpunkte sicher, dass der Inhalt so angepasst wird, dass er immer auf einem Einrastpunkt landet. Selbst wenn der Benutzer die Bearbeitung auf halbem Weg zwischen zwei Snap-Points loslässt, wird er immer zu einem der Anrastpunkte verschoben.

Um die Auswirkungen von Einrastpunkten auf das ScrollViewer-Verhalten selbst zu sehen, rufen Sie das XAML-Beispiel zum Scrollen, Schwenken und Zoomen ab. Führen Sie das Beispiel auf einem Touchgerät (nicht im Simulator) aus. Testen Sie die SnapPointsType-Werte , wenn Sie die Beispielseite "Schwenken mit Snappoints" des Beispiels anzeigen.

Weitere Informationen zur Wischgeste und zum Schwenken finden Sie im Abschnitt "Schwenkverhalten" unter Richtlinien für das Verschieben.

Der Standardwert "None" ist der Standardwert der Enumeration. Wenn sie festgelegt ist, wird diese Eigenschaft häufig als Attribut in einem XAML-Vorlagenteil oder als Stilsetter festgelegt. Jedes Steuerelement legt dies möglicherweise anders fest. Wenn Sie den Wert zur Laufzeit abrufen, wird der Wert bereitgestellt, der aus angewendeten Stilen und Vorlagen stammt.

Gilt für:

Freigeben über