UIElement.RegisterAsScrollPort(UIElement) UIElement.RegisterAsScrollPort(UIElement) UIElement.RegisterAsScrollPort(UIElement) UIElement.RegisterAsScrollPort(UIElement) Method

Definition

Registers an element as representing a scrollable viewport.

public : static void RegisterAsScrollPort(UIElement element)
static void RegisterAsScrollPort(UIElement element) const;
public static void RegisterAsScrollPort(UIElement element)
Public Shared Sub RegisterAsScrollPort(element As UIElement)

Parameters

element
UIElement UIElement UIElement UIElement

The element to register as a scrollable viewport.

Additional features and requirements

Device family
Windows 10, version 1803 (introduced v10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v6)

Remarks

This method informs the framework that the element's applied clip (either due to layout or an explicitly assigned Clip ) is acting as a viewport and should receive special consideration.

This method is intended for use by custom controls that do not use the platform's native controls to display a scrollable area. For example, a custom scrolling control could be built using InteractionTracker.

Effective Viewport

The Clip of the registered element is recognized by the framework as the bounds of a viewport, which will be used in calculating the property values for the EffectiveViewportChanged event.

System Focus Visuals

By default, the focus visual is fully rendered around the outside of the focused element taking into account all clips. When an element is only partially visible within a viewport the framework needs to disambiguate which clip in the element's ancestor chain represents the viewport. The framework uses this knowledge to correctly apply the viewport clip to the rendered focus visual.

See also

  • P:Windows.UI.Xaml.Controls.Control.UseSystemFocusVisuals - T:Windows.UI.Composition.Interactions.InteractionTracker - E:Windows.UI.Xaml.FrameworkElement.EffectiveViewportChanged - M:Windows.UI.Xaml.FrameworkElement.InvalidateViewport