ScrollingAnchorRequestedEventArgs 類別

  • 參考

定義

命名空間:
Microsoft.UI.Xaml.Controls
編輯

提供 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
繼承
Object Platform::Object IInspectable ScrollingAnchorRequestedEventArgs
屬性
ContractVersionAttribute MarshalingBehaviorAttribute

備註

ScrollView.AnchorRequested 事件會使用這些事件自變數，此事件會在 選取要錨定的項目時ScrollView引發。 處理此事件以自定義該選取專案。

如果事件處理程式將 AnchorElement 保留為 null， 則 ScrollView 會從 AnchorCandidates 集合中選取錨點。

集合 AnchorCandidates 會使用註冊為錨點候選專案的專案初始化。 該候選專案的初始集合會填入 ScrollPresenter 其 UIElement.CanBeScrollAnchor 屬性設定為 true的子系，並使用明確向方法註冊的專案 ScrollView.RegisterAnchorCandidate 。

您可以使用 AnchorRequested 事件處理程式來修改該集合，以調整錨點要求的候選項目清單。 執行之後，會 ScrollView 使用 其 HorizontalAnchorRatio 和 VerticalAnchorRatio 屬性來選取最終 AnchorCandidates 集合之間的錨點。

或者，您可以使用 AnchorRequested 事件處理程式，將 AnchorElement 屬性初始化為 null，以強制使用特定元素做為錨點。 在此情況下， AnchorCandidates 會忽略集合，而且 ScrollView會完全略過 的選取程式。

屬性

AnchorCandidates

取得要挑選的錨點專案候選專案集合。
AnchorElement

取得或設定選取的錨點專案。

適用於

另請參閱