ScrollingAnchorRequestedEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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 true
sur , 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 ScrollView
processus 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é. |