ScrollViewer.HorizontalSnapPointsType Eigenschaft

Definition

Ruft einen Wert ab, der deklariert, wie das Bearbeitungsverhalten auf die Andockpunkte 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

Ein Wert aus der Enumeration. Der Standardwert ist Keine , kann aber ü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 umschließt. Hub verwendet den Optional-Wert für sein Andockverhalten in beiden Dimensionen (obwohl VerticalScrollMode in startvisualen Zustä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. Andockpunkte bieten eine Möglichkeit, anzugeben, wo sich diese Orte befinden. Wenn ein Benutzer dann wischt, begünstigt das Bearbeitungsergebnis diesen natürlichen Punkt, indem das Verhalten verwendet wird, das durch einen SnapPointsType-Wert ausgedrückt wird.

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

**Obligatorische Andockpunkte (Mandatory und MandatorySingle): ** Im Gegensatz zur Nähe stellen obligatorische Andockpunkte sicher, dass der Inhalt angepasst wird, um immer auf einem Andockpunkt zu landen. Selbst wenn der Benutzer die Bearbeitung auf halbem Weg zwischen zwei Andockpunkten freigibt, wird er immer zu einem der Andockpunkte verschoben.

Um die Auswirkungen von Andockpunkten 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 Andockpunkten" des Beispiels anzeigen.

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

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:

Weitere Informationen