ScrollViewer ScrollViewer ScrollViewer Class

Represents a scrollable area that can contain other visible elements.

Syntax

Declaration

public sealed class ScrollViewerpublic sealed class ScrollViewerPublic NotInheritable Class ScrollViewer
<ScrollViewer .../>
-or-
<ScrollViewer ...>
content
</ScrollViewer>

Remarks

ScrollViewer is a container control that lets the user pan and zoom its content.

Scroll viewer control

A ScrollViewer enables content to be displayed in a smaller area than its actual size. When the content of the ScrollViewer is not entirely visible, the ScrollViewer displays scrollbars that the user can use to move the content areas that is visible. The area that includes all of the content of the ScrollViewer is the extent. The visible area of the content is the viewport.

It's typical for a ScrollViewer control to exist as a composite part of other controls. A ScrollViewer part along with the ScrollContentPresenter class for support will display a viewport along with scrollbars only when the host control's layout space is being constrained smaller than the expanded content size. This is often the case for lists, so ListView and GridView templates always include a ScrollViewer. TextBox and RichEditBox also include a ScrollViewer in their templates.

When a ScrollViewer part in a control exists, the host control often has built-in event handling for certain input events and manipulations that enable the content to scroll. For example, a GridView interprets a swipe gesture and this causes the content to scroll horizontally. The input events and raw manipulations that the host control receives are considered handled by the control, and lower-level events such as PointerPressed won't be raised and won't bubble to any parent containers either. You can change some of the built-in control handling by overriding a control class and the On* virtual methods for events, or by retemplating the control. But in either case it's not trivial to reproduce the original default behavior, which is typically there so that the control reacts in expected ways to events and to a user's input actions and gestures. So you should consider whether you really need that input event to fire. You might want to investigate whether there are other input events or gestures that are not being control-handled, and use those in your app or control interaction design.

To make it possible for controls that include a ScrollViewer to influence some of the behavior and properties that are from within the ScrollViewer part, ScrollViewer defines a number of XAML attached properties that can be set in styles and used in template bindings.

ScrollViewer XAML attached properties

ScrollViewer defines the following XAML attached properties:

In order to support XAML processor access to the attached properties, and also to expose equivalent get and set operations to code, each XAML attached property has a pair of Get and Set accessor methods. For example, the GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject) and SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode) methods support and provide the equivalent code-only support for HorizontalScrollMode. Alternatively, you can use the dependency property system to get or set the value of the attached property. Call GetValue(Windows.UI.Xaml.DependencyProperty) or SetValue(Windows.UI.Xaml.DependencyProperty,System.Object), passing the arguments of the dependency property identifier to set, and a reference to the target object on which to get or set the value.

Control style and template

You can modify the default Style and ControlTemplate to give the control a unique appearance. For information about modifying a control's style and template, see Styling controls. The default style, template, and resources that define the look of the control are included in the generic.xaml file. For design purposes, generic.xaml is available in the (Program Files)\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP&lt;SDK version>\Generic folder from a Windows Software Development Kit (SDK) installation. Styles and resources from different versions of the SDK might have different values.

Starting in Windows 10, version 1607 (Windows Software Development Kit (SDK) version 10.0.14393.0), generic.xaml includes resources that you can use to modify the colors of a control in different visual states without modifying the control template. In apps that target this software development kit (SDK) or later, modifying these resources is preferred to setting properties such as Background and Foreground. For more info, see the Light-weight styling section of the Styling controls article.

This table shows the resources used by the ScrollViewer control.

Resource keyDescription
ScrollViewerScrollBarSeparatorBackgroundBackground color of the scrollbar separator

Windows 8 behavior

Gesture handling by track pad devices

For Windows 8, track pad device gestures that were input-handled by a ScrollViewer control part were interpreted as mouse wheel input, and thus would fire a PointerWheelChanged event. Starting with Windows 8.1, ScrollViewer uses an underlying manipulation logic that interprets track pad gestures as actions that the ScrollViewer responds to, and thus the gesture is considered handled by the control and the PointerWheelChanged event is not fired anymore.

If you migrate your app code from Windows 8 to Windows 8.1 you may want to account for this behavior change, because it results in PointerWheelChanged being fired in fewer cases. Also, the behavior that's now built-in to ScrollViewer may be duplicating what your handler would have done.

Apps that were compiled for Windows 8 but running on Windows 8.1 continue to use the Windows 8 behavior.

App UI for On-Screen Keyboard

Windows 8 had an internally implemented logic that would associate a ScrollViewer with the overall app UI whenever the user invokes the On-Screen Keyboard. This On-Screen Keyboard is a specific accessibility feature that users request through the Ease of Access Center. It's not the same as the soft keyboard that can appear in app UI for text input controls, if the system detects no keyboard device. What the internal ScrollViewer does here is to make it possible to scroll the area where the app is, if scrolling it is forced because the keyboard is taking UI space.

Starting with Windows 8.1, the system still has UI/layout behavior when the On-Screen Keyboard appears, but it no longer uses this internally created ScrollViewer. Instead it uses a dedicated internal control that app code can't change or inspect.

Most aspects of this behavior change don't affect apps at all. However, your app might have anticipated this behavior, by providing an implicit Style for ScrollViewer that's meant to change the layout, or by walking the tree with VisualTreeHelper to find this internally created ScrollViewer and alter it at run-time. For an app that is compiled for Windows 8.1 that code won't be useful.

Apps that were compiled for Windows 8 but running on Windows 8.1 continue to use the Windows 8 behavior.

Examples

The following XAML creates a large TextBlock inside a ScrollViewer, along with another copy of the TextBlock for comparison.

<StackPanel>
    <!-- A large TextBlock. -->
    <TextBlock Width="300" TextWrapping="Wrap" Margin="0,0,0,30" 
      Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
    
    <!-- The same large TextBlock, wrapped in a ScrollViewer. -->
    <ScrollViewer Height="200" Width="200" 
                  HorizontalScrollBarVisibility="Auto" 
                  VerticalScrollBarVisibility="Auto">
        <TextBlock Width="300" TextWrapping="Wrap"
            Text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ac mi ipsum. Phasellus vel malesuada mauris. Donec pharetra, enim sit amet mattis tincidunt, felis nisi semper lectus, vel porta diam nisi in augue. Pellentesque lacus tortor, aliquam et faucibus id, rhoncus ut justo. Sed id lectus odio, eget pulvinar diam. Suspendisse eleifend ornare libero, in luctus purus aliquet non. Sed interdum, sem vitae rutrum rhoncus, felis ligula ultrices sem, in eleifend eros ante id neque." />
    </ScrollViewer>
</StackPanel>

Constructors summary

Initializes a new instance of the ScrollViewer class.

Properties summary

Gets or sets a value that determines whether the ScrollViewer uses a bring-into-view scroll behavior when an item in the view gets focus.

Identifies the BringIntoViewOnFocusChange dependency property.

Gets a value that indicates whether the horizontal ScrollBar is visible.

Identifies the ComputedHorizontalScrollBarVisibility dependency property.

Gets a value that indicates whether the vertical ScrollBar is visible.

Identifies the ComputedVerticalScrollBarVisibility dependency property.

Gets the vertical size of all the scrollable content in the ScrollViewer.

Identifier for the ExtentHeight dependency property.

Gets the horizontal size of all the scrollable content in the ScrollViewer.

Identifier for the ExtentWidth dependency property.

Gets the distance the content has been scrolled horizontally.

Identifies the HorizontalOffset dependency property.

Gets or sets a value that indicates whether a horizontal ScrollBar should be displayed.

Identifies the HorizontalScrollBarVisibility dependency property.

Gets or sets a value that determines how manipulation input influences scrolling behavior on the horizontal axis.

Identifies the HorizontalScrollMode dependency property.

Gets or sets a value that indicates how the existing snap points are horizontally aligned versus the initial viewport.

Identifies the HorizontalSnapPointsAlignment dependency property.

Gets or sets a value that declares how manipulation behavior reacts to the snap points along the horizontal axis.

Identifies the HorizontalSnapPointsType dependency property.

Gets or sets a value that determines the deferred scrolling behavior for a ScrollViewer.

Identifies the IsDeferredScrollingEnabled dependency property.

Gets or sets a value that indicates whether the scroll rail is enabled for the horizontal axis.

Identifies the IsHorizontalRailEnabled dependency property.

Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the horizontal axis.

Identifies the IsHorizontalScrollChainingEnabled dependency property.

Gets or sets a value that indicates whether scroll actions should include inertia in their behavior and value.

Identifies the IsScrollInertiaEnabled dependency property.

Gets or sets a value that indicates whether the scroll rail is enabled for the vertical axis.

Identifies the IsVerticalRailEnabled dependency property.

Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the vertical axis.

Identifies the IsVerticalScrollChainingEnabled dependency property.

Gets or sets a value that indicates whether zoom chaining is enabled from this child to its parent.

Identifies the IsZoomChainingEnabled dependency property.

Gets or sets a value that indicates whether zoom actions should include inertia in their behavior and value.

Identifies the IsZoomInertiaEnabled dependency property.

Gets or sets the content of the left header.

Identifies the LeftHeader dependency property.

Gets or sets a value that indicates the maximum permitted run-time value of ZoomFactor.

Identifies the MaxZoomFactor dependency property.

Gets or sets a value that indicates the minimum permitted run-time value of ZoomFactor.

Identifies the MinZoomFactor dependency property.

Gets a value that represents the vertical size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

Identifies the ScrollableHeight dependency property.

Gets a value that represents the horizontal size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

Identifies the ScrollableWidth dependency property.

Gets or sets the content of the top header.

Identifies the TopHeader dependency property.

Gets or sets the content of the top, left header.

Identifies the TopLeftHeader dependency property.

Gets the distance the content has been scrolled vertically.

Identifies the VerticalOffset dependency property.

Gets or sets a value that indicates whether a vertical ScrollBar should be displayed.

Identifies the VerticalScrollBarVisibility dependency property.

Gets or sets a value that determines how manipulation input influences scrolling behavior on the vertical axis.

Identifies the VerticalScrollMode dependency property.

Gets or sets a value that indicates how the existing snap points are vertically aligned versus the initial viewport.

Identifies the VerticalSnapPointsAlignment dependency property.

Gets or sets a value that declares how manipulation behavior reacts to the snap points along the vertical axis.

Identifies the VerticalSnapPointsType dependency property.

Gets the vertical size of the viewable content.

Identifies the ViewportHeight dependency property.

Gets the horizontal size of the viewable content.

Identifies the ViewportWidth dependency property.

Gets a value that indicates the current zoom factor engaged for content scaling.

Identifies the ZoomFactor dependency property.

Gets or sets a value that indicates whether zoom behavior in the ScrollViewer content is enabled.

Identifies the ZoomMode dependency property.

Gets the observable collection of zoom snap point factors that are held by the ScrollViewer.

Identifies the ZoomSnapPoints dependency property.

Gets or sets a value that indicates how zoom snap points are processed for interaction input.

Identifies the ZoomSnapPointsType dependency property.

Methods summary

Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor.

Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor, and optionally disables scrolling animation.

Gets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property from a specified element.

Gets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property from a specified element.

Gets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property from a specified element.

Gets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingInertiaEnabled XAML attached property from a specified element.

Gets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property from a specified element.

Gets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property from a specified element.

Gets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property from a specified element.

Gets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property from a specified element.

Gets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property from a specified element.

Gets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property from a specified element.

Gets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property from a specified element.

Gets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property from a specified element.

Gets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property from a specified element.

Gets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property from a specified element.

Called when the value of properties that describe the size and location of the scroll area change.

Scrolls the content that is within the ScrollViewer to the specified horizontal offset position.

Scrolls the content that is within the ScrollViewer to the specified vertical offset position.

Sets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property on a specified element.

Sets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property on a specified element.

Sets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property on a specified element.

Sets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingEnabled XAML attached property on a specified element.

Sets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property on a specified element.

Sets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property on a specified element.

Sets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property on a specified element.

Sets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property on a specified element.

Sets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property on a specified element.

Sets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property on a specified element.

Sets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property on a specified element.

Sets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property on a specified element.

Sets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property on a specified element.

Sets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property on a specified element.

Sets the effective value of ZoomFactor.

Events summary

Occurs when any direct manipulation of the ScrollViewer finishes.

Occurs when any direct manipulation of the ScrollViewer begins.

Occurs when manipulations such as scrolling and zooming have caused the view to change.

Occurs when manipulations such as scrolling and zooming cause the view to change.

Constructors

  • ScrollViewer()
    ScrollViewer()
    ScrollViewer()
    ScrollViewer()

    Initializes a new instance of the ScrollViewer class.

    public ScrollViewer()public ScrollViewer()Public Function ScrollViewer() As

Properties

  • BringIntoViewOnFocusChange
    BringIntoViewOnFocusChange
    BringIntoViewOnFocusChange
    BringIntoViewOnFocusChange

    Gets or sets a value that determines whether the ScrollViewer uses a bring-into-view scroll behavior when an item in the view gets focus.

    public bool BringIntoViewOnFocusChange { get; set; }public bool BringIntoViewOnFocusChange { get; set; }Public ReadWrite Property BringIntoViewOnFocusChange As bool
    <ScrollViewer BringIntoViewOnFocusChange="bool" />
    -or-
    <object ScrollViewer.BringIntoViewOnFocusChange="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true to use a behavior that brings focused items into view. false to use a behavior that focused items do not automatically scroll into view. The default is true.

    Remarks

    For XAML usage, BringIntoViewOnFocusChange can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.BringIntoViewOnFocusChange attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • BringIntoViewOnFocusChangeProperty
    BringIntoViewOnFocusChangeProperty
    BringIntoViewOnFocusChangeProperty
    BringIntoViewOnFocusChangeProperty

    Identifies the BringIntoViewOnFocusChange dependency property.

    public static DependencyProperty BringIntoViewOnFocusChangeProperty { get; }public static DependencyProperty BringIntoViewOnFocusChangeProperty { get; }Public Static ReadOnly Property BringIntoViewOnFocusChangeProperty As DependencyProperty

    Property Value

  • ComputedHorizontalScrollBarVisibility
    ComputedHorizontalScrollBarVisibility
    ComputedHorizontalScrollBarVisibility
    ComputedHorizontalScrollBarVisibility

    Gets a value that indicates whether the horizontal ScrollBar is visible.

    public Visibility ComputedHorizontalScrollBarVisibility { get; }public Visibility ComputedHorizontalScrollBarVisibility { get; }Public ReadOnly Property ComputedHorizontalScrollBarVisibility As Visibility

    Property Value

  • ComputedHorizontalScrollBarVisibilityProperty
    ComputedHorizontalScrollBarVisibilityProperty
    ComputedHorizontalScrollBarVisibilityProperty
    ComputedHorizontalScrollBarVisibilityProperty

    Identifies the ComputedHorizontalScrollBarVisibility dependency property.

    public static DependencyProperty ComputedHorizontalScrollBarVisibilityProperty { get; }public static DependencyProperty ComputedHorizontalScrollBarVisibilityProperty { get; }Public Static ReadOnly Property ComputedHorizontalScrollBarVisibilityProperty As DependencyProperty

    Property Value

  • ComputedVerticalScrollBarVisibility
    ComputedVerticalScrollBarVisibility
    ComputedVerticalScrollBarVisibility
    ComputedVerticalScrollBarVisibility

    Gets a value that indicates whether the vertical ScrollBar is visible.

    public Visibility ComputedVerticalScrollBarVisibility { get; }public Visibility ComputedVerticalScrollBarVisibility { get; }Public ReadOnly Property ComputedVerticalScrollBarVisibility As Visibility

    Property Value

  • ComputedVerticalScrollBarVisibilityProperty
    ComputedVerticalScrollBarVisibilityProperty
    ComputedVerticalScrollBarVisibilityProperty
    ComputedVerticalScrollBarVisibilityProperty

    Identifies the ComputedVerticalScrollBarVisibility dependency property.

    public static DependencyProperty ComputedVerticalScrollBarVisibilityProperty { get; }public static DependencyProperty ComputedVerticalScrollBarVisibilityProperty { get; }Public Static ReadOnly Property ComputedVerticalScrollBarVisibilityProperty As DependencyProperty

    Property Value

  • ExtentHeight
    ExtentHeight
    ExtentHeight
    ExtentHeight

    Gets the vertical size of all the scrollable content in the ScrollViewer.

    public double ExtentHeight { get; }public double ExtentHeight { get; }Public ReadOnly Property ExtentHeight As double

    Property Value

    • double
      double
      double

      The vertical size of all the scrollable content in the ScrollViewer.

    Remarks

    The extent includes all the content in the ScrollViewer, whether visible or not. The viewport is the visible area of the content.

  • ExtentHeightProperty
    ExtentHeightProperty
    ExtentHeightProperty
    ExtentHeightProperty

    Identifier for the ExtentHeight dependency property.

    public static DependencyProperty ExtentHeightProperty { get; }public static DependencyProperty ExtentHeightProperty { get; }Public Static ReadOnly Property ExtentHeightProperty As DependencyProperty

    Property Value

  • ExtentWidth
    ExtentWidth
    ExtentWidth
    ExtentWidth

    Gets the horizontal size of all the scrollable content in the ScrollViewer.

    public double ExtentWidth { get; }public double ExtentWidth { get; }Public ReadOnly Property ExtentWidth As double

    Property Value

    • double
      double
      double

      The horizontal size of all the scrollable content in the ScrollViewer.

    Remarks

    The extent includes all the content in the ScrollViewer, whether visible or not. The viewport is the visible area of the content.

  • ExtentWidthProperty
    ExtentWidthProperty
    ExtentWidthProperty
    ExtentWidthProperty

    Identifier for the ExtentWidth dependency property.

    public static DependencyProperty ExtentWidthProperty { get; }public static DependencyProperty ExtentWidthProperty { get; }Public Static ReadOnly Property ExtentWidthProperty As DependencyProperty

    Property Value

  • HorizontalOffset
    HorizontalOffset
    HorizontalOffset
    HorizontalOffset

    Gets the distance the content has been scrolled horizontally.

    public double HorizontalOffset { get; }public double HorizontalOffset { get; }Public ReadOnly Property HorizontalOffset As double

    Property Value

    • double
      double
      double

      The distance the content has been scrolled horizontally.

  • HorizontalOffsetProperty
    HorizontalOffsetProperty
    HorizontalOffsetProperty
    HorizontalOffsetProperty

    Identifies the HorizontalOffset dependency property.

    public static DependencyProperty HorizontalOffsetProperty { get; }public static DependencyProperty HorizontalOffsetProperty { get; }Public Static ReadOnly Property HorizontalOffsetProperty As DependencyProperty

    Property Value

  • HorizontalScrollBarVisibility
    HorizontalScrollBarVisibility
    HorizontalScrollBarVisibility
    HorizontalScrollBarVisibility

    Gets or sets a value that indicates whether a horizontal ScrollBar should be displayed.

    public ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }public ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }Public ReadWrite Property HorizontalScrollBarVisibility As ScrollBarVisibility
    <ScrollViewer HorizontalScrollBarVisibility="scrollBarVisibilityMemberName"/>
    -or-
    <object ScrollViewer.HorizontalScrollBarVisibility="scrollBarVisibilityMemberName"/>
    

    Property Value

    Remarks

    For XAML usage, HorizontalScrollBarVisibility can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.HorizontalScrollBarVisibility attached property usage on an element that is a child of a control that supports scrollview implicitly in its template. Controls with a ScrollViewer as part of their composition typically use template binding such that setting the attached property at the level of the control will change the scroll behavior of the ScrollViewer part within the control. Otherwise, it may be necessary to replace the template in order to change the scroll behavior of a ScrollViewer part.

  • HorizontalScrollBarVisibilityProperty
    HorizontalScrollBarVisibilityProperty
    HorizontalScrollBarVisibilityProperty
    HorizontalScrollBarVisibilityProperty

    Identifies the HorizontalScrollBarVisibility dependency property.

    public static DependencyProperty HorizontalScrollBarVisibilityProperty { get; }public static DependencyProperty HorizontalScrollBarVisibilityProperty { get; }Public Static ReadOnly Property HorizontalScrollBarVisibilityProperty As DependencyProperty

    Property Value

  • HorizontalScrollMode
    HorizontalScrollMode
    HorizontalScrollMode
    HorizontalScrollMode

    Gets or sets a value that determines how manipulation input influences scrolling behavior on the horizontal axis.

    public ScrollMode HorizontalScrollMode { get; set; }public ScrollMode HorizontalScrollMode { get; set; }Public ReadWrite Property HorizontalScrollMode As ScrollMode
    <ScrollViewer HorizontalScrollMode="scrollModeMemberName" />
    -or-
    <object ScrollViewer.HorizontalScrollMode="scrollModeMemberName"/>
    

    Property Value

    • A value of the enumeration. The typical default (as set through the default template, not class initialization) is Enabled.

    Remarks

    Scrolling behavior can also be set through a ScrollViewer.HorizontalScrollMode XAML attached property usage, or by calling SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode). This is for cases where the ScrollViewer is implicit, such as when the ScrollViewer exists in the default template for a GridView, and you want to be able to influence the scrolling behavior without accessing template parts. Controls with a ScrollViewer as part of their composition typically use template binding such that setting the attached property at the level of the control will change the scroll behavior of the ScrollViewer part within the control. Otherwise, it may be necessary to replace the template in order to change the scroll behavior of a ScrollViewer part.

  • HorizontalScrollModeProperty
    HorizontalScrollModeProperty
    HorizontalScrollModeProperty
    HorizontalScrollModeProperty

    Identifies the HorizontalScrollMode dependency property.

    public static DependencyProperty HorizontalScrollModeProperty { get; }public static DependencyProperty HorizontalScrollModeProperty { get; }Public Static ReadOnly Property HorizontalScrollModeProperty As DependencyProperty

    Property Value

  • HorizontalSnapPointsAlignment
    HorizontalSnapPointsAlignment
    HorizontalSnapPointsAlignment
    HorizontalSnapPointsAlignment

    Gets or sets a value that indicates how the existing snap points are horizontally aligned versus the initial viewport.

    public SnapPointsAlignment HorizontalSnapPointsAlignment { get; set; }public SnapPointsAlignment HorizontalSnapPointsAlignment { get; set; }Public ReadWrite Property HorizontalSnapPointsAlignment As SnapPointsAlignment
    <ScrollViewer HorizontalSnapPointsAlignment="snapPointsAlignmentMemberName" />
    

    Property Value

  • HorizontalSnapPointsAlignmentProperty
    HorizontalSnapPointsAlignmentProperty
    HorizontalSnapPointsAlignmentProperty
    HorizontalSnapPointsAlignmentProperty

    Identifies the HorizontalSnapPointsAlignment dependency property.

    public static DependencyProperty HorizontalSnapPointsAlignmentProperty { get; }public static DependencyProperty HorizontalSnapPointsAlignmentProperty { get; }Public Static ReadOnly Property HorizontalSnapPointsAlignmentProperty As DependencyProperty

    Property Value

  • HorizontalSnapPointsType
    HorizontalSnapPointsType
    HorizontalSnapPointsType
    HorizontalSnapPointsType

    Gets or sets a value that declares how manipulation behavior reacts to the snap points along the horizontal axis.

    public SnapPointsType HorizontalSnapPointsType { get; set; }public SnapPointsType HorizontalSnapPointsType { get; set; }Public ReadWrite Property HorizontalSnapPointsType As SnapPointsType
    <ScrollViewer HorizontalSnapPointsType="snapPointsTypeMemberName" />
    

    Property Value

    Remarks

    For panning actions, there are often natural stopping places. Snap points provide a way to indicate where these places are. Then, when a user swipes, the manipulation result favors that natural point using behavior as expressed by a SnapPointsType value.

    Proximity points (Optional** and *OptionalSingle*): ** When a user is going to naturally stop the manipulation in the proximity of a snap point, proximity points help the user land at the natural stopping place. Because the user has to land in proximity to the snap point to cause it to stop there, the user will sometimes have to perform another swipe to reach a snap point.

    Mandatory snap points (Mandatory** and *MandatorySingle*): ** In contrast to proximity, mandatory snap points ensure that the content is adjusted to always land on a snap point. Even if the user releases the manipulation halfway between two snap-points, it will always move to one of the snap points.

    To see the effects of snap points on ScrollViewer behavior yourself, get the XAML scrolling, panning and zooming sample. Run the sample on a touch device (not the simulator). Try out the SnapPointsType values when you view the "Panning with snap-points" example page of the sample.

    To learn more about the swipe gesture and panning, see the "Panning behaviors" section of Guidelines for panning.

    The default value of None is the default of the enumeration. If it's set, this property is often set as an attribute in a XAML template part, or as a style Setter. Each control potentially sets this differently. Getting the value at run time will provide the value that came from applied styles and templates.

    Examples

    This XAML is from the default template for a Hub control. A Hub has a ScrollViewer part that surrounds an ItemsStackPanel for its content. Hub uses the Optional value for its snapping behavior in both dimensions (although VerticalScrollMode is disabled in starting visual states) and disables ZoomMode. Note how the SnapPointsAlignment properties are also set as attributes here.

    
    <ControlTemplate TargetType="Hub">
    ...
    <ScrollViewer x:Name="ScrollViewer"
        Grid.RowSpan="2"
        HorizontalScrollMode="Auto"
        HorizontalScrollBarVisibility="Auto"
        VerticalScrollMode="Disabled"
        VerticalScrollBarVisibility="Disabled"
        HorizontalSnapPointsAlignment="Near"
        HorizontalSnapPointsType="Optional"
        VerticalSnapPointsAlignment="Near"
        VerticalSnapPointsType="Optional"
        ZoomMode="Disabled">
      <ItemsStackPanel x:Name="Panel" 
           Orientation="{TemplateBinding Orientation}"
           CacheLength="20" />
    </ScrollViewer>
    ...
    </ControlTemplate>
    
  • HorizontalSnapPointsTypeProperty
    HorizontalSnapPointsTypeProperty
    HorizontalSnapPointsTypeProperty
    HorizontalSnapPointsTypeProperty

    Identifies the HorizontalSnapPointsType dependency property.

    public static DependencyProperty HorizontalSnapPointsTypeProperty { get; }public static DependencyProperty HorizontalSnapPointsTypeProperty { get; }Public Static ReadOnly Property HorizontalSnapPointsTypeProperty As DependencyProperty

    Property Value

  • IsDeferredScrollingEnabled
    IsDeferredScrollingEnabled
    IsDeferredScrollingEnabled
    IsDeferredScrollingEnabled

    Gets or sets a value that determines the deferred scrolling behavior for a ScrollViewer.

    public bool IsDeferredScrollingEnabled { get; set; }public bool IsDeferredScrollingEnabled { get; set; }Public ReadWrite Property IsDeferredScrollingEnabled As bool
    <ScrollViewer IsDeferredScrollingEnabled="bool" />
    -or-
    <object ScrollViewer.IsDeferredScrollingEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if deferred scrolling should occur; otherwise, false.

    Remarks

    Deferred scrolling behavior means that the view does not scroll until a user action is completed. For example, if a region scrolls when the user manipulates a thumb control, and IsDeferredScrollingEnabled is true, the scroll does not occur until the touch point on the thumb is released. In contrast, if IsDeferredScrollingEnabled is false, the region scrolls any time that the touch point selection point along the slider track is moved.

    For XAML usage, IsDeferredScrollingEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsDeferredScrollingEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsDeferredScrollingEnabledProperty
    IsDeferredScrollingEnabledProperty
    IsDeferredScrollingEnabledProperty
    IsDeferredScrollingEnabledProperty

    Identifies the IsDeferredScrollingEnabled dependency property.

    public static DependencyProperty IsDeferredScrollingEnabledProperty { get; }public static DependencyProperty IsDeferredScrollingEnabledProperty { get; }Public Static ReadOnly Property IsDeferredScrollingEnabledProperty As DependencyProperty

    Property Value

  • IsHorizontalRailEnabled
    IsHorizontalRailEnabled
    IsHorizontalRailEnabled
    IsHorizontalRailEnabled

    Gets or sets a value that indicates whether the scroll rail is enabled for the horizontal axis.

    public bool IsHorizontalRailEnabled { get; set; }public bool IsHorizontalRailEnabled { get; set; }Public ReadWrite Property IsHorizontalRailEnabled As bool
    <ScrollViewer IsHorizontalRailEnabled="bool" />
    -or-
    <object ScrollViewer.IsHorizontalRailEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      True to enable the horizontal scroll rail; otherwise, false. The default is true.

  • IsHorizontalRailEnabledProperty
    IsHorizontalRailEnabledProperty
    IsHorizontalRailEnabledProperty
    IsHorizontalRailEnabledProperty

    Identifies the IsHorizontalRailEnabled dependency property.

    public static DependencyProperty IsHorizontalRailEnabledProperty { get; }public static DependencyProperty IsHorizontalRailEnabledProperty { get; }Public Static ReadOnly Property IsHorizontalRailEnabledProperty As DependencyProperty

    Property Value

  • IsHorizontalScrollChainingEnabled
    IsHorizontalScrollChainingEnabled
    IsHorizontalScrollChainingEnabled
    IsHorizontalScrollChainingEnabled

    Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the horizontal axis.

    public bool IsHorizontalScrollChainingEnabled { get; set; }public bool IsHorizontalScrollChainingEnabled { get; set; }Public ReadWrite Property IsHorizontalScrollChainingEnabled As bool
    <ScrollViewer IsHorizontalScrollChainingEnabled="bool" />
    -or-
    <object ScrollViewer.IsHorizontalScrollChainingEnabled="bool"/>
    
    

    Property Value

    • bool
      bool
      bool

      true to enable horizontal scroll chaining from child to parent; otherwise, false.

    Remarks

    For XAML usage, IsHorizontalScrollChainingEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsHorizontalScrollChainingEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsHorizontalScrollChainingEnabledProperty
    IsHorizontalScrollChainingEnabledProperty
    IsHorizontalScrollChainingEnabledProperty
    IsHorizontalScrollChainingEnabledProperty

    Identifies the IsHorizontalScrollChainingEnabled dependency property.

    public static DependencyProperty IsHorizontalScrollChainingEnabledProperty { get; }public static DependencyProperty IsHorizontalScrollChainingEnabledProperty { get; }Public Static ReadOnly Property IsHorizontalScrollChainingEnabledProperty As DependencyProperty

    Property Value

  • IsScrollInertiaEnabled
    IsScrollInertiaEnabled
    IsScrollInertiaEnabled
    IsScrollInertiaEnabled

    Gets or sets a value that indicates whether scroll actions should include inertia in their behavior and value.

    public bool IsScrollInertiaEnabled { get; set; }public bool IsScrollInertiaEnabled { get; set; }Public ReadWrite Property IsScrollInertiaEnabled As bool
    <ScrollViewer IsScrollInertiaEnabled="bool" />
    -or-
    <object ScrollViewer.IsScrollInertiaEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if scroll actions should include inertia in their behavior and value; otherwise, false.

    Remarks

    For XAML usage, IsScrollInertiaEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsScrollInertiaEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsScrollInertiaEnabledProperty
    IsScrollInertiaEnabledProperty
    IsScrollInertiaEnabledProperty
    IsScrollInertiaEnabledProperty

    Identifies the IsScrollInertiaEnabled dependency property.

    public static DependencyProperty IsScrollInertiaEnabledProperty { get; }public static DependencyProperty IsScrollInertiaEnabledProperty { get; }Public Static ReadOnly Property IsScrollInertiaEnabledProperty As DependencyProperty

    Property Value

  • IsVerticalRailEnabled
    IsVerticalRailEnabled
    IsVerticalRailEnabled
    IsVerticalRailEnabled

    Gets or sets a value that indicates whether the scroll rail is enabled for the vertical axis.

    public bool IsVerticalRailEnabled { get; set; }public bool IsVerticalRailEnabled { get; set; }Public ReadWrite Property IsVerticalRailEnabled As bool
    <ScrollViewer IsVerticalRailEnabled="bool" />
    -or-
    <object ScrollViewer.IsVerticalRailEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      True to enable the vertical scroll rail; otherwise, false. The default is true.

  • IsVerticalRailEnabledProperty
    IsVerticalRailEnabledProperty
    IsVerticalRailEnabledProperty
    IsVerticalRailEnabledProperty

    Identifies the IsVerticalRailEnabled dependency property.

    public static DependencyProperty IsVerticalRailEnabledProperty { get; }public static DependencyProperty IsVerticalRailEnabledProperty { get; }Public Static ReadOnly Property IsVerticalRailEnabledProperty As DependencyProperty

    Property Value

  • IsVerticalScrollChainingEnabled
    IsVerticalScrollChainingEnabled
    IsVerticalScrollChainingEnabled
    IsVerticalScrollChainingEnabled

    Gets or sets a value that indicates whether scroll chaining is enabled from this child to its parent, for the vertical axis.

    public bool IsVerticalScrollChainingEnabled { get; set; }public bool IsVerticalScrollChainingEnabled { get; set; }Public ReadWrite Property IsVerticalScrollChainingEnabled As bool
    <ScrollViewer IsVerticalScrollChainingEnabled="bool" />
    -or-
    <object ScrollViewer.IsVerticalScrollChainingEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true to enable vertical scroll chaining from child to parent; otherwise, false.

    Remarks

    For XAML usage, IsVerticalScrollChainingEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsVerticalScrollChainingEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsVerticalScrollChainingEnabledProperty
    IsVerticalScrollChainingEnabledProperty
    IsVerticalScrollChainingEnabledProperty
    IsVerticalScrollChainingEnabledProperty

    Identifies the IsVerticalScrollChainingEnabled dependency property.

    public static DependencyProperty IsVerticalScrollChainingEnabledProperty { get; }public static DependencyProperty IsVerticalScrollChainingEnabledProperty { get; }Public Static ReadOnly Property IsVerticalScrollChainingEnabledProperty As DependencyProperty

    Property Value

  • IsZoomChainingEnabled
    IsZoomChainingEnabled
    IsZoomChainingEnabled
    IsZoomChainingEnabled

    Gets or sets a value that indicates whether zoom chaining is enabled from this child to its parent.

    public bool IsZoomChainingEnabled { get; set; }public bool IsZoomChainingEnabled { get; set; }Public ReadWrite Property IsZoomChainingEnabled As bool
    <ScrollViewer IsZoomChainingEnabled="bool" />
    -or-
    <object ScrollViewer.IsZoomChainingEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true to enable zoom chaining from child to parent; otherwise, false.

    Remarks

    For XAML usage, IsZoomChainingEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsZoomChainingEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsZoomChainingEnabledProperty
    IsZoomChainingEnabledProperty
    IsZoomChainingEnabledProperty
    IsZoomChainingEnabledProperty

    Identifies the IsZoomChainingEnabled dependency property.

    public static DependencyProperty IsZoomChainingEnabledProperty { get; }public static DependencyProperty IsZoomChainingEnabledProperty { get; }Public Static ReadOnly Property IsZoomChainingEnabledProperty As DependencyProperty

    Property Value

  • IsZoomInertiaEnabled
    IsZoomInertiaEnabled
    IsZoomInertiaEnabled
    IsZoomInertiaEnabled

    Gets or sets a value that indicates whether zoom actions should include inertia in their behavior and value.

    public bool IsZoomInertiaEnabled { get; set; }public bool IsZoomInertiaEnabled { get; set; }Public ReadWrite Property IsZoomInertiaEnabled As bool
    <ScrollViewer IsZoomInertiaEnabled="bool" />
    -or-
    <object ScrollViewer.IsZoomInertiaEnabled="bool"/>
    

    Property Value

    • bool
      bool
      bool

      true if zoom actions should include inertia in their behavior and value; otherwise, false.

    Remarks

    For XAML usage, IsZoomInertiaEnabled can either be an attribute on an explicit ScrollViewer element, or a ScrollViewer.IsZoomInertiaEnabled attached property usage on an element that is a child of a control that supports scrollview implicitly in its template.

  • IsZoomInertiaEnabledProperty
    IsZoomInertiaEnabledProperty
    IsZoomInertiaEnabledProperty
    IsZoomInertiaEnabledProperty

    Identifies the IsZoomInertiaEnabled dependency property.

    public static DependencyProperty IsZoomInertiaEnabledProperty { get; }public static DependencyProperty IsZoomInertiaEnabledProperty { get; }Public Static ReadOnly Property IsZoomInertiaEnabledProperty As DependencyProperty

    Property Value

  • LeftHeader
    LeftHeader
    LeftHeader
    LeftHeader

    Gets or sets the content of the left header.

    public UIElement LeftHeader { get; set; }public UIElement LeftHeader { get; set; }Public ReadWrite Property LeftHeader As UIElement
    <ScrollViewer>
      <ScrollViewer.LeftHeader>headerObject</ScrollViewer.LeftHeader>
    </ScrollViewer>
    
    

    Property Value

    Remarks

    The LeftHeader, TopHeader, and TopLeftHeader properties can be set only when ScrollViewer content's HorizontalAlignment is Left and VerticalAlignment is Top.

    The left header scrolls vertically, but not horizontally.

  • LeftHeaderProperty
    LeftHeaderProperty
    LeftHeaderProperty
    LeftHeaderProperty

    Identifies the LeftHeader dependency property.

    public static DependencyProperty LeftHeaderProperty { get; }public static DependencyProperty LeftHeaderProperty { get; }Public Static ReadOnly Property LeftHeaderProperty As DependencyProperty

    Property Value

  • MaxZoomFactor
    MaxZoomFactor
    MaxZoomFactor
    MaxZoomFactor

    Gets or sets a value that indicates the maximum permitted run-time value of ZoomFactor.

    public float MaxZoomFactor { get; set; }public float MaxZoomFactor { get; set; }Public ReadWrite Property MaxZoomFactor As float
    <ScrollViewer MaxZoomFactor="single" />
    

    Property Value

    • float
      float
      float

      The maximum permitted run-time value of ZoomFactor. The default is 10.

  • MaxZoomFactorProperty
    MaxZoomFactorProperty
    MaxZoomFactorProperty
    MaxZoomFactorProperty

    Identifies the MaxZoomFactor dependency property.

    public static DependencyProperty MaxZoomFactorProperty { get; }public static DependencyProperty MaxZoomFactorProperty { get; }Public Static ReadOnly Property MaxZoomFactorProperty As DependencyProperty

    Property Value

  • MinZoomFactor
    MinZoomFactor
    MinZoomFactor
    MinZoomFactor

    Gets or sets a value that indicates the minimum permitted run-time value of ZoomFactor.

    public float MinZoomFactor { get; set; }public float MinZoomFactor { get; set; }Public ReadWrite Property MinZoomFactor As float
    <ScrollViewer MinZoomFactor="single" />
    

    Property Value

    • float
      float
      float

      The minimum permitted run-time value of ZoomFactor. The default is 0.1.

  • MinZoomFactorProperty
    MinZoomFactorProperty
    MinZoomFactorProperty
    MinZoomFactorProperty

    Identifies the MinZoomFactor dependency property.

    public static DependencyProperty MinZoomFactorProperty { get; }public static DependencyProperty MinZoomFactorProperty { get; }Public Static ReadOnly Property MinZoomFactorProperty As DependencyProperty

    Property Value

  • ScrollableHeight
    ScrollableHeight
    ScrollableHeight
    ScrollableHeight

    Gets a value that represents the vertical size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

    public double ScrollableHeight { get; }public double ScrollableHeight { get; }Public ReadOnly Property ScrollableHeight As double

    Property Value

    • double
      double
      double

      The vertical size of the area that can be scrolled. This property has no default value.

  • ScrollableHeightProperty
    ScrollableHeightProperty
    ScrollableHeightProperty
    ScrollableHeightProperty

    Identifies the ScrollableHeight dependency property.

    public static DependencyProperty ScrollableHeightProperty { get; }public static DependencyProperty ScrollableHeightProperty { get; }Public Static ReadOnly Property ScrollableHeightProperty As DependencyProperty

    Property Value

  • ScrollableWidth
    ScrollableWidth
    ScrollableWidth
    ScrollableWidth

    Gets a value that represents the horizontal size of the area that can be scrolled; the difference between the width of the extent and the width of the viewport.

    public double ScrollableWidth { get; }public double ScrollableWidth { get; }Public ReadOnly Property ScrollableWidth As double

    Property Value

    • double
      double
      double

      The horizontal size of the area that can be scrolled. This property has no default value.

  • ScrollableWidthProperty
    ScrollableWidthProperty
    ScrollableWidthProperty
    ScrollableWidthProperty

    Identifies the ScrollableWidth dependency property.

    public static DependencyProperty ScrollableWidthProperty { get; }public static DependencyProperty ScrollableWidthProperty { get; }Public Static ReadOnly Property ScrollableWidthProperty As DependencyProperty

    Property Value

  • TopHeader
    TopHeader
    TopHeader
    TopHeader

    Gets or sets the content of the top header.

    public UIElement TopHeader { get; set; }public UIElement TopHeader { get; set; }Public ReadWrite Property TopHeader As UIElement
    <ScrollViewer>
      <ScrollViewer.TopHeader>headerObject</ScrollViewer.TopHeader>
    </ScrollViewer>
    
    

    Property Value

    Remarks

    The LeftHeader, TopHeader, and TopLeftHeader properties can be set only when ScrollViewer content's HorizontalAlignment is Left and VerticalAlignment is Top.

    The top header scrolls horizontally, but not vertically.

  • TopHeaderProperty
    TopHeaderProperty
    TopHeaderProperty
    TopHeaderProperty

    Identifies the TopHeader dependency property.

    public static DependencyProperty TopHeaderProperty { get; }public static DependencyProperty TopHeaderProperty { get; }Public Static ReadOnly Property TopHeaderProperty As DependencyProperty

    Property Value

  • TopLeftHeader
    TopLeftHeader
    TopLeftHeader
    TopLeftHeader

    Gets or sets the content of the top, left header.

    public UIElement TopLeftHeader { get; set; }public UIElement TopLeftHeader { get; set; }Public ReadWrite Property TopLeftHeader As UIElement
    <ScrollViewer>
      <ScrollViewer.TopLeftHeader>headerObject</ScrollViewer.TopLeftHeader>
    </ScrollViewer>
    
    

    Property Value

    Remarks

    The LeftHeader, TopHeader, and TopLeftHeader properties can be set only when ScrollViewer content's HorizontalAlignment is Left and VerticalAlignment is Top.

    The top left header doesn't scroll in any direction.

  • TopLeftHeaderProperty
    TopLeftHeaderProperty
    TopLeftHeaderProperty
    TopLeftHeaderProperty

    Identifies the TopLeftHeader dependency property.

    public static DependencyProperty TopLeftHeaderProperty { get; }public static DependencyProperty TopLeftHeaderProperty { get; }Public Static ReadOnly Property TopLeftHeaderProperty As DependencyProperty

    Property Value

  • VerticalOffset
    VerticalOffset
    VerticalOffset
    VerticalOffset

    Gets the distance the content has been scrolled vertically.

    public double VerticalOffset { get; }public double VerticalOffset { get; }Public ReadOnly Property VerticalOffset As double

    Property Value

    • double
      double
      double

      The distance the content has been scrolled vertically.

  • VerticalOffsetProperty
    VerticalOffsetProperty
    VerticalOffsetProperty
    VerticalOffsetProperty

    Identifies the VerticalOffset dependency property.

    public static DependencyProperty VerticalOffsetProperty { get; }public static DependencyProperty VerticalOffsetProperty { get; }Public Static ReadOnly Property VerticalOffsetProperty As DependencyProperty

    Property Value

  • VerticalScrollBarVisibility
    VerticalScrollBarVisibility
    VerticalScrollBarVisibility
    VerticalScrollBarVisibility

    Gets or sets a value that indicates whether a vertical ScrollBar should be displayed.

    public ScrollBarVisibility VerticalScrollBarVisibility { get; set; }public ScrollBarVisibility VerticalScrollBarVisibility { get; set; }Public ReadWrite Property VerticalScrollBarVisibility As ScrollBarVisibility
    <ScrollViewer VerticalScrollBarVisibility="scrollBarVisibilityMemberName"/>
    -or-
    <object ScrollViewer.VerticalScrollBarVisibility="scrollBarVisibilityMemberName"/>
    

    Property Value

    Remarks

    Scrolling behavior can also be set through a ScrollViewer.VerticalScrollBarVisibility XAML attached property usage, or by calling SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility). This is for cases where the ScrollViewer is implicit, such as when the ScrollViewer exists in the default template for a GridView, and you want to be able to influence the scrolling behavior without accessing template parts. Controls with a ScrollViewer as part of their composition typically use template binding such that setting the attached property at the level of the control will change the scroll behavior of the ScrollViewer part within the control. Otherwise, it may be necessary to replace the template in order to change the scroll behavior of a ScrollViewer part.

  • VerticalScrollBarVisibilityProperty
    VerticalScrollBarVisibilityProperty
    VerticalScrollBarVisibilityProperty
    VerticalScrollBarVisibilityProperty

    Identifies the VerticalScrollBarVisibility dependency property.

    public static DependencyProperty VerticalScrollBarVisibilityProperty { get; }public static DependencyProperty VerticalScrollBarVisibilityProperty { get; }Public Static ReadOnly Property VerticalScrollBarVisibilityProperty As DependencyProperty

    Property Value

  • VerticalScrollMode
    VerticalScrollMode
    VerticalScrollMode
    VerticalScrollMode

    Gets or sets a value that determines how manipulation input influences scrolling behavior on the vertical axis.

    public ScrollMode VerticalScrollMode { get; set; }public ScrollMode VerticalScrollMode { get; set; }Public ReadWrite Property VerticalScrollMode As ScrollMode
    <ScrollViewer VerticalScrollMode="scrollModeMemberName" />
    -or-
    <object ScrollViewer.VerticalScrollMode="scrollModeMemberName"/>
    

    Property Value

    • A value of the enumeration. The typical default (as set through the default template, not class initialization) is Enabled.

    Remarks

    Scrolling behavior can also be set through a ScrollViewer.VerticalScrollMode XAML attached property usage, or by calling SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode). This is for cases where the ScrollViewer is implicit, such as when the ScrollViewer exists in the default template for a GridView, and you want to be able to influence the scrolling behavior without accessing template parts. Controls with a ScrollViewer as part of their composition typically use template binding such that setting the attached property at the level of the control will change the scroll behavior of the ScrollViewer part within the control. Otherwise, it may be necessary to replace the template in order to change the scroll behavior of a ScrollViewer part.

  • VerticalScrollModeProperty
    VerticalScrollModeProperty
    VerticalScrollModeProperty
    VerticalScrollModeProperty

    Identifies the VerticalScrollMode dependency property.

    public static DependencyProperty VerticalScrollModeProperty { get; }public static DependencyProperty VerticalScrollModeProperty { get; }Public Static ReadOnly Property VerticalScrollModeProperty As DependencyProperty

    Property Value

  • VerticalSnapPointsAlignment
    VerticalSnapPointsAlignment
    VerticalSnapPointsAlignment
    VerticalSnapPointsAlignment

    Gets or sets a value that indicates how the existing snap points are vertically aligned versus the initial viewport.

    public SnapPointsAlignment VerticalSnapPointsAlignment { get; set; }public SnapPointsAlignment VerticalSnapPointsAlignment { get; set; }Public ReadWrite Property VerticalSnapPointsAlignment As SnapPointsAlignment
    <ScrollViewer VerticalSnapPointsAlignment="snapPointsAlignmentMemberName" />
    

    Property Value

  • VerticalSnapPointsAlignmentProperty
    VerticalSnapPointsAlignmentProperty
    VerticalSnapPointsAlignmentProperty
    VerticalSnapPointsAlignmentProperty

    Identifies the VerticalSnapPointsAlignment dependency property.

    public static DependencyProperty VerticalSnapPointsAlignmentProperty { get; }public static DependencyProperty VerticalSnapPointsAlignmentProperty { get; }Public Static ReadOnly Property VerticalSnapPointsAlignmentProperty As DependencyProperty

    Property Value

  • VerticalSnapPointsType
    VerticalSnapPointsType
    VerticalSnapPointsType
    VerticalSnapPointsType

    Gets or sets a value that declares how manipulation behavior reacts to the snap points along the vertical axis.

    public SnapPointsType VerticalSnapPointsType { get; set; }public SnapPointsType VerticalSnapPointsType { get; set; }Public ReadWrite Property VerticalSnapPointsType As SnapPointsType
    <ScrollViewer VerticalSnapPointsType="snapPointsTypeMemberName" />
    

    Property Value

    Remarks

    For panning actions, there are often natural stopping places. Snap points provide a way to indicate where these places are. Then, when a user swipes, the manipulation result favors that natural point using behavior as expressed by a SnapPointsType value.

    Proximity points (Optional** and *OptionalSingle*): ** When a user is going to naturally stop the manipulation in the proximity of a snap point, proximity points help the user land at the natural stopping place. Because the user has to land in proximity to the snap point to cause it to stop there, the user will sometimes have to perform another swipe to reach a snap point.

    Mandatory snap points (Mandatory** and *MandatorySingle*): ** In contrast to proximity, mandatory snap points ensure that the content is adjusted to always land on a snap point. Even if the user releases the manipulation halfway between two snap-points, it will always move to one of the snap points.

    To see the effects of snap points on ScrollViewer behavior yourself, get the XAML scrolling, panning and zooming sample. Run the sample on a touch device (not the simulator). Try out the SnapPointsType values when you view the "Panning with snap-points" example page of the sample.

    To learn more about the swipe gesture and panning, see the "Panning behaviors" section of Guidelines for panning.

    The default value of None is the default of the enumeration. If it's set, this property is often set as an attribute in a XAML template part, or as a style Setter. Each control potentially sets this differently. Getting the value at run time will provide the value that came from applied styles and templates.

    Examples

    This XAML is from the default template for a Hub control. A Hub has a ScrollViewer part that surrounds an ItemsStackPanel for its content. Hub uses the Optional value for its snapping behavior in both dimensions (although VerticalScrollMode is disabled in starting visual states) and disables ZoomMode. Note how the SnapPointsAlignment properties are also set as attributes here.

    
    <ControlTemplate TargetType="Hub">
    ...
    <ScrollViewer x:Name="ScrollViewer"
        Grid.RowSpan="2"
        HorizontalScrollMode="Auto"
        HorizontalScrollBarVisibility="Auto"
        VerticalScrollMode="Disabled"
        VerticalScrollBarVisibility="Disabled"
        HorizontalSnapPointsAlignment="Near"
        HorizontalSnapPointsType="Optional"
        VerticalSnapPointsAlignment="Near"
        VerticalSnapPointsType="Optional"
        ZoomMode="Disabled">
      <ItemsStackPanel x:Name="Panel" 
           Orientation="{TemplateBinding Orientation}"
           CacheLength="20" />
    </ScrollViewer>
    ...
    </ControlTemplate>
    
  • VerticalSnapPointsTypeProperty
    VerticalSnapPointsTypeProperty
    VerticalSnapPointsTypeProperty
    VerticalSnapPointsTypeProperty

    Identifies the VerticalSnapPointsType dependency property.

    public static DependencyProperty VerticalSnapPointsTypeProperty { get; }public static DependencyProperty VerticalSnapPointsTypeProperty { get; }Public Static ReadOnly Property VerticalSnapPointsTypeProperty As DependencyProperty

    Property Value

  • ViewportHeight
    ViewportHeight
    ViewportHeight
    ViewportHeight

    Gets the vertical size of the viewable content.

    public double ViewportHeight { get; }public double ViewportHeight { get; }Public ReadOnly Property ViewportHeight As double

    Property Value

    • double
      double
      double

      The vertical size of the viewable content.

    Remarks

    The viewport includes all the visible content in the ScrollViewer.

  • ViewportHeightProperty
    ViewportHeightProperty
    ViewportHeightProperty
    ViewportHeightProperty

    Identifies the ViewportHeight dependency property.

    public static DependencyProperty ViewportHeightProperty { get; }public static DependencyProperty ViewportHeightProperty { get; }Public Static ReadOnly Property ViewportHeightProperty As DependencyProperty

    Property Value

  • ViewportWidth
    ViewportWidth
    ViewportWidth
    ViewportWidth

    Gets the horizontal size of the viewable content.

    public double ViewportWidth { get; }public double ViewportWidth { get; }Public ReadOnly Property ViewportWidth As double

    Property Value

    • double
      double
      double

      The horizontal size of the viewable content.

    Remarks

    The viewport includes all the visible content in the ScrollViewer.

  • ViewportWidthProperty
    ViewportWidthProperty
    ViewportWidthProperty
    ViewportWidthProperty

    Identifies the ViewportWidth dependency property.

    public static DependencyProperty ViewportWidthProperty { get; }public static DependencyProperty ViewportWidthProperty { get; }Public Static ReadOnly Property ViewportWidthProperty As DependencyProperty

    Property Value

  • ZoomFactor
    ZoomFactor
    ZoomFactor
    ZoomFactor

    Gets a value that indicates the current zoom factor engaged for content scaling.

    public float ZoomFactor { get; }public float ZoomFactor { get; }Public ReadOnly Property ZoomFactor As float

    Property Value

    • float
      float
      float

      The current zoom factor engaged for content scaling. The default is 1.0, where 1.0 indicates no additional scaling.

    Remarks

    To change the value of this property at run-time or for initialization, use ZoomToFactor(System.Single).

  • ZoomFactorProperty
    ZoomFactorProperty
    ZoomFactorProperty
    ZoomFactorProperty

    Identifies the ZoomFactor dependency property.

    public static DependencyProperty ZoomFactorProperty { get; }public static DependencyProperty ZoomFactorProperty { get; }Public Static ReadOnly Property ZoomFactorProperty As DependencyProperty

    Property Value

  • ZoomMode
    ZoomMode
    ZoomMode
    ZoomMode

    Gets or sets a value that indicates whether zoom behavior in the ScrollViewer content is enabled.

    public ZoomMode ZoomMode { get; set; }public ZoomMode ZoomMode { get; set; }Public ReadWrite Property ZoomMode As ZoomMode
    <ScrollViewer ZoomMode="zoomModeMemberName" />
    -or-
    <object ScrollViewer.ZoomMode="zoomModeMemberName"/>
    

    Property Value

    Remarks

    No default value is listed for this property. Controls that incorporate a ScrollViewer in compositing often set a value for ZoomMode in the default template and starting visual states, and it is this templated value that you will typically start with. Controls with a ScrollViewer as part of their composition typically use template binding such that setting the attached property at the level of the control will change the scroll behavior of the ScrollViewer part within the control. Otherwise, it may be necessary to replace the template in order to change the scroll behavior of a ScrollViewer part.

  • ZoomModeProperty
    ZoomModeProperty
    ZoomModeProperty
    ZoomModeProperty

    Identifies the ZoomMode dependency property.

    public static DependencyProperty ZoomModeProperty { get; }public static DependencyProperty ZoomModeProperty { get; }Public Static ReadOnly Property ZoomModeProperty As DependencyProperty

    Property Value

  • ZoomSnapPoints
    ZoomSnapPoints
    ZoomSnapPoints
    ZoomSnapPoints

    Gets the observable collection of zoom snap point factors that are held by the ScrollViewer.

    public IVector<float> ZoomSnapPoints { get; }public IVector<float> ZoomSnapPoints { get; }Public ReadOnly Property ZoomSnapPoints As IVector<float>

    Property Value

    • A collection of Single values that represent zoom factors as snap points.

  • ZoomSnapPointsProperty
    ZoomSnapPointsProperty
    ZoomSnapPointsProperty
    ZoomSnapPointsProperty

    Identifies the ZoomSnapPoints dependency property.

    public static DependencyProperty ZoomSnapPointsProperty { get; }public static DependencyProperty ZoomSnapPointsProperty { get; }Public Static ReadOnly Property ZoomSnapPointsProperty As DependencyProperty

    Property Value

  • ZoomSnapPointsType
    ZoomSnapPointsType
    ZoomSnapPointsType
    ZoomSnapPointsType

    Gets or sets a value that indicates how zoom snap points are processed for interaction input.

    public SnapPointsType ZoomSnapPointsType { get; set; }public SnapPointsType ZoomSnapPointsType { get; set; }Public ReadWrite Property ZoomSnapPointsType As SnapPointsType
    <ScrollViewer ZoomSnapPointsType="snapPointsTypeMemberName"/>
    

    Property Value

  • ZoomSnapPointsTypeProperty
    ZoomSnapPointsTypeProperty
    ZoomSnapPointsTypeProperty
    ZoomSnapPointsTypeProperty

    Identifies the ZoomSnapPointsType dependency property.

    public static DependencyProperty ZoomSnapPointsTypeProperty { get; }public static DependencyProperty ZoomSnapPointsTypeProperty { get; }Public Static ReadOnly Property ZoomSnapPointsTypeProperty As DependencyProperty

    Property Value

Methods

  • ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single})
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single})
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single})
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single})

    Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor.

    public bool ChangeView(Windows.Foundation.IReference{System.Double} horizontalOffset,Windows.Foundation.IReference{System.Double} verticalOffset,Windows.Foundation.IReference{System.Single} zoomFactor)public bool ChangeView(Windows.Foundation.IReference{System.Double} horizontalOffset,Windows.Foundation.IReference{System.Double} verticalOffset,Windows.Foundation.IReference{System.Single} zoomFactor)Public Function ChangeView(horizontalOffset As Windows.Foundation.IReference{System.Double},verticalOffset As Windows.Foundation.IReference{System.Double},zoomFactor As Windows.Foundation.IReference{System.Single}) As bool

    Parameters

    • horizontalOffset

      A value between 0 and ScrollableWidth that specifies the distance the content should be scrolled horizontally.

    • verticalOffset

      A value between 0 and ScrollableHeight that specifies the distance the content should be scrolled vertically.

    • zoomFactor

      A value between MinZoomFactor and MaxZoomFactor that specifies the required target MaxZoomFactor.

    Returns

    • bool
      bool
      bool

      true if the view is changed; otherwise, false.

    Remarks

    You can set parameter values to null to use this method to scroll only horizontally, only vertically, or to only change the zoom factor.

    Examples

    This code results in a ScrollViewer named myScrollViewer being scrolled to a horizontal offset of 2.

    bool flag = myScrollViewer.ChangeView(2, null, null);
    
  • ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single},System.Boolean)
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single},System.Boolean)
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single},System.Boolean)
    ChangeView(Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Double},Windows.Foundation.IReference{System.Single},System.Boolean)

    Causes the ScrollViewer to load a new view into the viewport using the specified offsets and zoom factor, and optionally disables scrolling animation.

    public bool ChangeView(Windows.Foundation.IReference{System.Double} horizontalOffset,Windows.Foundation.IReference{System.Double} verticalOffset,Windows.Foundation.IReference{System.Single} zoomFactor,System.Boolean disableAnimation)public bool ChangeView(Windows.Foundation.IReference{System.Double} horizontalOffset,Windows.Foundation.IReference{System.Double} verticalOffset,Windows.Foundation.IReference{System.Single} zoomFactor,System.Boolean disableAnimation)Public Function ChangeView(horizontalOffset As Windows.Foundation.IReference{System.Double},verticalOffset As Windows.Foundation.IReference{System.Double},zoomFactor As Windows.Foundation.IReference{System.Single},disableAnimation As System.Boolean) As bool

    Parameters

    • horizontalOffset

      A value between 0 and ScrollableWidth that specifies the distance the content should be scrolled horizontally.

    • verticalOffset

      A value between 0 and ScrollableHeight that specifies the distance the content should be scrolled vertically.

    • zoomFactor

      A value between MinZoomFactor and MaxZoomFactor that specifies the required target MaxZoomFactor.

    • disableAnimation
      System.Boolean
      System.Boolean
      System.Boolean

      true to disable zoom/pan animations while changing the view; otherwise, false. The default is false.

    Returns

    • bool
      bool
      bool

      true if the view is changed; otherwise, false.

    Remarks

    You can set parameter values to null to use this method to scroll only horizontally, only vertically, or to only change the zoom factor.

    Examples

    This code results in a ScrollViewer named myScrollViewer being scrolled to a horizontal offset of 2 without animation.

    bool flag = myScrollViewer.ChangeView(2, null, null, true);
    
  • GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject)
    GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject)
    GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject)
    GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject)

    Gets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property from a specified element.

    public static bool GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject element)public static bool GetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject element)Public Static Function GetBringIntoViewOnFocusChange(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see Remarks for the BringIntoViewOnFocusChange property.

  • GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)

    Gets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property from a specified element.

    public static ScrollBarVisibility GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element)public static ScrollBarVisibility GetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element)Public Static Function GetHorizontalScrollBarVisibility(element As Windows.UI.Xaml.DependencyObject) As ScrollBarVisibility

    Parameters

    Returns

    Remarks

    For more info, see Remarks for the HorizontalScrollBarVisibility property.

  • GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject)

    Gets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property from a specified element.

    public static ScrollMode GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject element)public static ScrollMode GetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject element)Public Static Function GetHorizontalScrollMode(element As Windows.UI.Xaml.DependencyObject) As ScrollMode

    Parameters

    Returns

    Remarks

    For more info, see Remarks for the HorizontalScrollMode property.

  • GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingInertiaEnabled XAML attached property from a specified element.

    public static bool GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsDeferredScrollingEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see Remarks for the IsDeferredScrollingEnabled property.

  • GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property from a specified element.

    public static bool GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsHorizontalRailEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsHorizontalRailEnabled property.

  • GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property from a specified element.

    public static bool GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsHorizontalScrollChainingEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsHorizontalScrollChainingEnabled property.

  • GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property from a specified element.

    public static bool GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsScrollInertiaEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsScrollInertiaEnabled property.

  • GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property from a specified element.

    public static bool GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsVerticalRailEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsVerticalRailEnabled property.

  • GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property from a specified element.

    public static bool GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsVerticalScrollChainingEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsVerticalScrollChainingEnabled property.

  • GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property from a specified element.

    public static bool GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsZoomChainingEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsZoomChainingEnabled property.

  • GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject)
    GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject)

    Gets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property from a specified element.

    public static bool GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject element)public static bool GetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject element)Public Static Function GetIsZoomInertiaEnabled(element As Windows.UI.Xaml.DependencyObject) As bool

    Parameters

    Returns

    • bool
      bool
      bool

      The value of the property, as obtained from the property store.

    Remarks

    For more info, see the IsZoomInertiaEnabled property.

  • GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject)

    Gets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property from a specified element.

    public static ScrollBarVisibility GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element)public static ScrollBarVisibility GetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element)Public Static Function GetVerticalScrollBarVisibility(element As Windows.UI.Xaml.DependencyObject) As ScrollBarVisibility

    Parameters

    Returns

    Remarks

    For more info, see the VerticalScrollBarVisibility property.

  • GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject)
    GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject)

    Gets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property from a specified element.

    public static ScrollMode GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject element)public static ScrollMode GetVerticalScrollMode(Windows.UI.Xaml.DependencyObject element)Public Static Function GetVerticalScrollMode(element As Windows.UI.Xaml.DependencyObject) As ScrollMode

    Parameters

    Returns

    Remarks

    For more info, see the VerticalScrollMode property.

  • GetZoomMode(Windows.UI.Xaml.DependencyObject)
    GetZoomMode(Windows.UI.Xaml.DependencyObject)
    GetZoomMode(Windows.UI.Xaml.DependencyObject)
    GetZoomMode(Windows.UI.Xaml.DependencyObject)

    Gets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property from a specified element.

    public static ZoomMode GetZoomMode(Windows.UI.Xaml.DependencyObject element)public static ZoomMode GetZoomMode(Windows.UI.Xaml.DependencyObject element)Public Static Function GetZoomMode(element As Windows.UI.Xaml.DependencyObject) As ZoomMode

    Parameters

    Returns

    Remarks

    For more info, see the ZoomMode property.

  • InvalidateScrollInfo()
    InvalidateScrollInfo()
    InvalidateScrollInfo()
    InvalidateScrollInfo()

    Called when the value of properties that describe the size and location of the scroll area change.

    public void InvalidateScrollInfo()public void InvalidateScrollInfo()Public Function InvalidateScrollInfo() As void
  • ScrollToHorizontalOffset(System.Double)
    ScrollToHorizontalOffset(System.Double)
    ScrollToHorizontalOffset(System.Double)
    ScrollToHorizontalOffset(System.Double)

    Scrolls the content that is within the ScrollViewer to the specified horizontal offset position.

    public void ScrollToHorizontalOffset(System.Double offset)public void ScrollToHorizontalOffset(System.Double offset)Public Function ScrollToHorizontalOffset(offset As System.Double) As void

    Parameters

    • offset
      System.Double
      System.Double
      System.Double

      The position that the content scrolls to.

  • ScrollToVerticalOffset(System.Double)
    ScrollToVerticalOffset(System.Double)
    ScrollToVerticalOffset(System.Double)
    ScrollToVerticalOffset(System.Double)

    Scrolls the content that is within the ScrollViewer to the specified vertical offset position.

    public void ScrollToVerticalOffset(System.Double offset)public void ScrollToVerticalOffset(System.Double offset)Public Function ScrollToVerticalOffset(offset As System.Double) As void

    Parameters

    • offset
      System.Double
      System.Double
      System.Double

      The position that the content scrolls to.

  • SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the BringIntoViewOnFocusChange dependency property / ScrollViewer.BringIntoViewOnFocusChange XAML attached property on a specified element.

    public static void SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject element,System.Boolean bringIntoViewOnFocusChange)public static void SetBringIntoViewOnFocusChange(Windows.UI.Xaml.DependencyObject element,System.Boolean bringIntoViewOnFocusChange)Public Static Function SetBringIntoViewOnFocusChange(element As Windows.UI.Xaml.DependencyObject,bringIntoViewOnFocusChange As System.Boolean) As void

    Parameters

    Remarks

    For more info, see Remarks for the BringIntoViewOnFocusChange property.

  • SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)

    Sets the value of the HorizontalScrollBarVisibility dependency property / ScrollViewer.HorizontalScrollBarVisibility XAML attached property on a specified element.

    public static void SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollBarVisibility horizontalScrollBarVisibility)public static void SetHorizontalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollBarVisibility horizontalScrollBarVisibility)Public Static Function SetHorizontalScrollBarVisibility(element As Windows.UI.Xaml.DependencyObject,horizontalScrollBarVisibility As Windows.UI.Xaml.Controls.ScrollBarVisibility) As void

    Parameters

    Remarks

    For more info, see Remarks for the HorizontalScrollBarVisibility property.

  • SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)

    Sets the value of the HorizontalScrollMode dependency property / ScrollViewer.HorizontalScrollMode XAML attached property on a specified element.

    public static void SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollMode horizontalScrollMode)public static void SetHorizontalScrollMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollMode horizontalScrollMode)Public Static Function SetHorizontalScrollMode(element As Windows.UI.Xaml.DependencyObject,horizontalScrollMode As Windows.UI.Xaml.Controls.ScrollMode) As void

    Parameters

    Remarks

    For more info, see Remarks for the HorizontalScrollMode property.

  • SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsDeferredScrollingEnabled dependency property / ScrollViewer.IsDeferredScrollingEnabled XAML attached property on a specified element.

    public static void SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isDeferredScrollingEnabled)public static void SetIsDeferredScrollingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isDeferredScrollingEnabled)Public Static Function SetIsDeferredScrollingEnabled(element As Windows.UI.Xaml.DependencyObject,isDeferredScrollingEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see Remarks for the IsDeferredScrollingEnabled property.

  • SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsHorizontalRailEnabled dependency property / ScrollViewer.IsHorizontalRailEnabled XAML attached property on a specified element.

    public static void SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isHorizontalRailEnabled)public static void SetIsHorizontalRailEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isHorizontalRailEnabled)Public Static Function SetIsHorizontalRailEnabled(element As Windows.UI.Xaml.DependencyObject,isHorizontalRailEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsHorizontalRailEnabled property.

  • SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsHorizontalScrollChainingEnabled dependency property / ScrollViewer.IsHorizontalScrollChainingEnabled XAML attached property on a specified element.

    public static void SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isHorizontalScrollChainingEnabled)public static void SetIsHorizontalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isHorizontalScrollChainingEnabled)Public Static Function SetIsHorizontalScrollChainingEnabled(element As Windows.UI.Xaml.DependencyObject,isHorizontalScrollChainingEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsHorizontalScrollChainingEnabled property.

  • SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsScrollInertiaEnabled dependency property / ScrollViewer.IsScrollInertiaEnabled XAML attached property on a specified element.

    public static void SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isScrollInertiaEnabled)public static void SetIsScrollInertiaEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isScrollInertiaEnabled)Public Static Function SetIsScrollInertiaEnabled(element As Windows.UI.Xaml.DependencyObject,isScrollInertiaEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsScrollInertiaEnabled property.

  • SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsVerticalRailEnabled dependency property / ScrollViewer.IsVerticalRailEnabled XAML attached property on a specified element.

    public static void SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isVerticalRailEnabled)public static void SetIsVerticalRailEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isVerticalRailEnabled)Public Static Function SetIsVerticalRailEnabled(element As Windows.UI.Xaml.DependencyObject,isVerticalRailEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsVerticalRailEnabled property.

  • SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsVerticalScrollChainingEnabled dependency property / ScrollViewer.IsVerticalScrollChainingEnabled XAML attached property on a specified element.

    public static void SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isVerticalScrollChainingEnabled)public static void SetIsVerticalScrollChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isVerticalScrollChainingEnabled)Public Static Function SetIsVerticalScrollChainingEnabled(element As Windows.UI.Xaml.DependencyObject,isVerticalScrollChainingEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsVerticalScrollChainingEnabled property.

  • SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsZoomChainingEnabled dependency property / ScrollViewer.IsZoomChainingEnabled XAML attached property on a specified element.

    public static void SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isZoomChainingEnabled)public static void SetIsZoomChainingEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isZoomChainingEnabled)Public Static Function SetIsZoomChainingEnabled(element As Windows.UI.Xaml.DependencyObject,isZoomChainingEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsZoomChainingEnabled property.

  • SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)
    SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject,System.Boolean)

    Sets the value of the IsZoomInertiaEnabled dependency property / ScrollViewer.IsZoomInertiaEnabled XAML attached property on a specified element.

    public static void SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isZoomInertiaEnabled)public static void SetIsZoomInertiaEnabled(Windows.UI.Xaml.DependencyObject element,System.Boolean isZoomInertiaEnabled)Public Static Function SetIsZoomInertiaEnabled(element As Windows.UI.Xaml.DependencyObject,isZoomInertiaEnabled As System.Boolean) As void

    Parameters

    Remarks

    For more info, see the IsZoomInertiaEnabled property.

  • SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)
    SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollBarVisibility)

    Sets the value of the VerticalScrollBarVisibility dependency property / ScrollViewer.VerticalScrollBarVisibility XAML attached property on a specified element.

    public static void SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollBarVisibility verticalScrollBarVisibility)public static void SetVerticalScrollBarVisibility(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollBarVisibility verticalScrollBarVisibility)Public Static Function SetVerticalScrollBarVisibility(element As Windows.UI.Xaml.DependencyObject,verticalScrollBarVisibility As Windows.UI.Xaml.Controls.ScrollBarVisibility) As void

    Parameters

    Remarks

    For more info, see the VerticalScrollBarVisibility property.

  • SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)
    SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ScrollMode)

    Sets the value of the VerticalScrollMode dependency property / ScrollViewer.VerticalScrollMode XAML attached property on a specified element.

    public static void SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollMode verticalScrollMode)public static void SetVerticalScrollMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ScrollMode verticalScrollMode)Public Static Function SetVerticalScrollMode(element As Windows.UI.Xaml.DependencyObject,verticalScrollMode As Windows.UI.Xaml.Controls.ScrollMode) As void

    Parameters

    Remarks

    For more info, see the VerticalScrollMode property.

  • SetZoomMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ZoomMode)
    SetZoomMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ZoomMode)
    SetZoomMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ZoomMode)
    SetZoomMode(Windows.UI.Xaml.DependencyObject,Windows.UI.Xaml.Controls.ZoomMode)

    Sets the value of the ZoomMode dependency property / ScrollViewer.ZoomMode XAML attached property on a specified element.

    public static void SetZoomMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ZoomMode zoomMode)public static void SetZoomMode(Windows.UI.Xaml.DependencyObject element,Windows.UI.Xaml.Controls.ZoomMode zoomMode)Public Static Function SetZoomMode(element As Windows.UI.Xaml.DependencyObject,zoomMode As Windows.UI.Xaml.Controls.ZoomMode) As void

    Parameters

    Remarks

    For more info, see the ZoomMode property.

  • ZoomToFactor(System.Single)
    ZoomToFactor(System.Single)
    ZoomToFactor(System.Single)
    ZoomToFactor(System.Single)

    Sets the effective value of ZoomFactor.

    public void ZoomToFactor(System.Single factor)public void ZoomToFactor(System.Single factor)Public Function ZoomToFactor(factor As System.Single) As void

    Parameters

    • factor
      System.Single
      System.Single
      System.Single

      The zoom factor to set. The factors are based on a norm of 1.0, which represents no zoom applied. The values you can set are also influenced by current values for MinZoomFactor and MaxZoomFactor.

Events

  • DirectManipulationCompleted
    DirectManipulationCompleted
    DirectManipulationCompleted
    DirectManipulationCompleted

    Occurs when any direct manipulation of the ScrollViewer finishes.

    public event EventHandler DirectManipulationCompletedpublic event EventHandler DirectManipulationCompletedPublic Event DirectManipulationCompleted
  • DirectManipulationStarted
    DirectManipulationStarted
    DirectManipulationStarted
    DirectManipulationStarted

    Occurs when any direct manipulation of the ScrollViewer begins.

    public event EventHandler DirectManipulationStartedpublic event EventHandler DirectManipulationStartedPublic Event DirectManipulationStarted
  • ViewChanged
    ViewChanged
    ViewChanged
    ViewChanged

    Occurs when manipulations such as scrolling and zooming have caused the view to change.

    public event EventHandler ViewChangedpublic event EventHandler ViewChangedPublic Event ViewChanged
    <ScrollViewer ViewChanged="eventhandler"/>
    

    Remarks

    ViewChanging fires before ViewChanged.

    In your event handler, use a parameter of type ScrollViewerViewChangedEventArgs for the second parameter of your handler method. ScrollViewerViewChangedEventArgs includes the IsIntermediate property, which reports whether the manipulation that fired the event is completed or still ongoing.

    Not every underlying manipulation will necessarily fire this event. The class logic delays and consolidates intermediate events into a single occurrence in some cases.

  • ViewChanging
    ViewChanging
    ViewChanging
    ViewChanging

    Occurs when manipulations such as scrolling and zooming cause the view to change.

    public event EventHandler ViewChangingpublic event EventHandler ViewChangingPublic Event ViewChanging
    <ScrollViewer ViewChanging="eventhandler"/>
    

    Remarks

    ScrollViewerViewChangingEventArgs includes the IsInertial property, which reports whether the manipulation that is firing the event contains an inertial component.

    Not every underlying manipulation will necessarily fire this event. The ScrollViewer logic delays and consolidates intermediate events into a single occurrence in some cases.

Attributes

Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.ActivatableAttribute
Windows.Foundation.Metadata.ThreadingAttribute
Windows.Foundation.Metadata.StaticAttribute
Windows.Foundation.Metadata.MarshalingBehaviorAttribute
Windows.Foundation.Metadata.WebHostHiddenAttribute
Windows.Foundation.Metadata.ContractVersionAttribute

Details

Assembly

Windows.UI.Xaml.Controls.dll