AutoScroll

Enables scrollbars on a container when the content overflows.

All Wisej containers can scroll their content when the AutoScroll property is set to true (default is false - the content is truncated). When AutoScroll is true, Wisej automatically shows or hides the horizontal or vertical scroll bars, unless the property ScrollBars has a value different than Both.

ScrollBars

Once AutoScroll is true, and the container is able to scroll its content, you can control which scrollbar is visible by setting the ScrollBars property:

• Both (Default). Horizontal and Vertical Scrollbars are shown or hidden as needed.

• None. Scrollbars are never displayed, it's similar to setting AutoScroll = false.

• Horizontal. Only the horizontal scrollbar is shown if needed.

• Vertical. Only the vertical scrollbar is shown if needed.

• Hidden. The scrollbars are never shown but touch scrolling and wheel scrolling is supported. It's usually used for mobile apps when the scrollbars should not be visible.

When in design mode and AutoScroll is true, both scrollbars are always visible regardless of the ScrollBars property.

The browser will always scroll a widget into view when it receives the focus, regardless of the scrollbar settings.

Check whether the horizontal scrollbar using the HorizontalScroll.Visible property, and if the vertical scrollbar is visible using the VerticalScroll.Visible property.

Scroll Position

Regardless of the AutoScroll and ScrollBars properties, Wisej applications can read or set the scroll position (forcing a scroll) of the container using the VerticalScroll.Value and HorizontalScroll.Value properties.

C#

// Scroll the content up to 50 pixels.
// The final scroll amount is limited by the size of the view port (scroll area)
private void button1_Click(object sender, EventArgs e)
{
    this.VerticalScroll.Value = 50;
}

VB.NET

' Scroll the content up to 50 pixels.
' The final scroll amount is limited by the size of the view port (scroll area)
Private Sub Button1_Click(sender As Object, e As EventArgs)

    Me.VerticalScroll.Value = 50

End Sub

Scroll Area & Margins

The scrolling area is calculated to fit the content exactly. If you want to add some margin at the bottom or to the right of the content, use the

Form with AutoScroll = true and no AutoScrollMargin

Form with AutoScroll = true and AutoScrollMargin set to 50,50 pixels

You can also set a minimum size for the viewport (the scrolling area) to make the container scroll the content regardless of the space occupied by the child controls.

Form with AutoScroll = true and AutoScrollMinSize set to 1000,1000 pixels.

Scroll Event

The Scroll event is one of the lazy events (fired only if there is a handler attached). When you handle the event, Wisej will fire it every time the scroll position of either scroll bars (even if set to Hidden) changes.

In the event handler_,_ you can check both the e.OldValue and e.NewValue to determine if the scrollbar was moved up or down, or the e.ScrollOrientation to determine if the Scroll event was fired by the horizontal or vertical scrollbar.

You can also use the e.Type enumeration to determine if the scroll position changed because of a Decrement scroll, an Increment, or if the scroll position was dragged to the First (top or left) position or to the Last (bottom or right) position.

Touch Scrolling

Wisej fully supports touch scrolling and inertia scrolling. When the user swipes a touch device it will initiate the inertia scrolling which will keep scrolling and firing the Scroll event while it slows down.

If the user touches the scroll bar, the scrolling system will NOT process the touch and inertial scrolling and will instead move the scrollbar as the user drags the scrolling knob.

Right to Left Support

When RightToLeft is true, the vertical scrollbar and the corner grip are automatically moved to the left. This is separate from the mirroring feature, which "flips" the layout of the child controls. See Right To Left support.