ScrollViewer.RegisterAnchorCandidate(UIElement) Method

Definition

Registers a UIElement as a potential scroll anchor.

public:
 virtual void RegisterAnchorCandidate(UIElement ^ element) = RegisterAnchorCandidate;
void RegisterAnchorCandidate(UIElement const & element);
public void RegisterAnchorCandidate(UIElement element);
Public Sub RegisterAnchorCandidate (element As UIElement)

Parameters

element
UIElement

A UIElement within the subtree of the ScrollViewer.

Implements

Remarks

When an element has CanBeScrollAnchor set to true the framework locates the first IScrollAnchorProvider in that element's chain of ancestors and automatically calls its RegisterAnchorCandidate method. This occurs both when the property is set on an existing element or an element is added to the live tree with the property already set.

Similarly, when the property is set to false (or an element is removed from the visual tree with the property set to true), the framework calls the UnregisterAnchorCandidate on the first IScrollAnchorProvider.

Applies to

See also