Share via


ScrollingAnchorRequestedEventArgs Classe

Définition

Fournit des données pour l'événement ScrollView.AnchorRequested.

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
Héritage
Object Platform::Object IInspectable ScrollingAnchorRequestedEventArgs
Attributs

Remarques

Ces arguments d’événement sont utilisés par l’événement ScrollView.AnchorRequested , qui est déclenché lorsque le ScrollView sélectionne un élément à ancrer. Gérez cet événement pour personnaliser cette sélection.

Si le gestionnaire d’événements laisse AnchorElement comme null, le ScrollView sélectionne une ancre parmi la collection AnchorCandidates .

La AnchorCandidates collection est initialisée avec les éléments inscrits en tant que candidats d’ancre. Cette collection initiale de candidats est remplie avec ScrollPresenter des enfants dont la UIElement.CanBeScrollAnchor propriété est définie truesur , et avec des éléments explicitement inscrits auprès de la ScrollView.RegisterAnchorCandidate méthode .

Vous pouvez utiliser AnchorRequested le gestionnaire d’événements pour modifier cette collection afin d’ajuster la liste des candidats pour la demande d’ancre. Une fois exécuté, le ScrollView utilise ses propriétés HorizontalAnchorRatio et VerticalAnchorRatio pour sélectionner une ancre parmi la collection finale AnchorCandidates .

Vous pouvez également utiliser le AnchorRequested gestionnaire d’événements pour définir la propriété AnchorElement , initialisée sur null, afin de forcer l’utilisation d’un élément particulier comme ancre. Dans ce cas, la AnchorCandidates collection est ignorée et le ScrollViewprocessus de sélection est entièrement ignoré.

Propriétés

AnchorCandidates

Obtient la collection des candidats d’éléments d’ancre à partir de laquelle choisir.

AnchorElement

Obtient ou définit l’élément d’ancre sélectionné.

S’applique à

Voir aussi