HeaderPane
Main
Hide
Share Link
Print

Scrolling

When not all tabs fit in one row, the tabs can scroll. The SftTabs.Scrolling property returns the control's ScrollingClass object, which defines how the tabs scroll.

Scrolling

Scrolling is enabled using the ScrollingClass.Enabled property. Tabs scroll while the control shows a single row of tabs (SftTabs.Rows property) and the SftTabs.FillComplete property is False.

The user scrolls the tabs by clicking the scroll buttons, which repeat while a button is held down, or by turning the mouse wheel while the mouse cursor is on the tab row. When a tab is selected, using the keyboard or by the application, it is scrolled into view.

Scroll Buttons

The ScrollingClass.ScrollButtons property defines when the scroll buttons are shown (see ScrollButtonsEnum): always, only when not all tabs fit, or never. Without scroll buttons, tabs can still be scrolled using the keyboard, the mouse wheel and by the application.

The scroll buttons are located at either end of the tabs (ScrollingClass.ButtonsPosition property). The ScrollingClass.ButtonAlignment, ScrollingClass.FullSize and ScrollingClass.Gap properties define their alignment and size across the tab row and the gap between the two buttons, the ScrollingClass.ButtonAppearance property their appearance. The ScrollingClass.BackwardImage and ScrollingClass.ForwardImage properties replace the built-in arrows with images, and the ScrollingClass.BackwardToolTip and ScrollingClass.ForwardToolTip properties define tooltips for the two buttons.

Scrolling by the Application

The ScrollingClass.Scroll method scrolls the tabs by one tab. The ScrollingClass.ScrollIntoView and TabClass.ScrollIntoView methods scroll a tab into view. The ScrollingClass.FirstVisibleTab property defines the first tab displayed, the ScrollingClass.LastVisibleTab property returns the last tab displayed, and the ScrollingClass.CanScrollBackward and ScrollingClass.CanScrollForward properties return whether the tabs can scroll in either direction.

The Scrolled event occurs after the tabs scrolled.

See Also Tab Control Components