Share via


ScrollingAnchorRequestedEventArgs Klasse

Definition

Stellt Daten für das ScrollView.AnchorRequested-Ereignis bereit.

public ref class ScrollingAnchorRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ScrollingAnchorRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ScrollingAnchorRequestedEventArgs
Public NotInheritable Class ScrollingAnchorRequestedEventArgs
Vererbung
Object Platform::Object IInspectable ScrollingAnchorRequestedEventArgs
Attribute

Hinweise

Diese Ereignisargumente werden vom ScrollView.AnchorRequested-Ereignis verwendet, das ausgelöst wird, wenn ein ScrollView zu verankernde Element ausgewählt wird. Behandeln Sie dieses Ereignis, um diese Auswahl anzupassen.

Wenn der Ereignishandler anchorElement als nullbelässt, wählt scrollView einen Anker aus der AnchorCandidates-Auflistung aus.

Die AnchorCandidates Auflistung wird mit den Elementen initialisiert, die als Ankerkandidaten registriert sind. Diese anfängliche Auflistung von Kandidaten wird mit untergeordneten ScrollPresenter Elementen aufgefüllt, deren UIElement.CanBeScrollAnchor Eigenschaft auf truefestgelegt ist, und mit Elementen, die explizit bei der ScrollView.RegisterAnchorCandidate -Methode registriert sind.

Sie können den Ereignishandler verwenden AnchorRequested , um diese Sammlung zu ändern, um die Liste der Kandidaten für die Ankeranforderung anzupassen. Nach der Ausführung verwendet die ScrollView eigenschaften HorizontalAnchorRatio und VerticalAnchorRatio , um einen Anker aus der endgültigen AnchorCandidates Auflistung auszuwählen.

Alternativ können Sie den AnchorRequested Ereignishandler verwenden, um die AnchorElement-Eigenschaft ( initialisiert auf ) nullfestzulegen, um die Verwendung eines bestimmten Elements als Anker zu erzwingen. In diesem Fall wird die AnchorCandidates Auflistung ignoriert, und der Auswahlprozess der ScrollView"s" wird vollständig übersprungen.

Eigenschaften

AnchorCandidates

Ruft die Auflistung der Ankerelementkandidaten ab, aus der ausgewählt werden soll.

AnchorElement

Ruft das ausgewählte Ankerelement ab oder legt es fest.

Gilt für:

Weitere Informationen