Attention: Here be dragons (unstable version)

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Redot.

ScrollBar

Inherits: Range < Control < CanvasItem < Node < Object

Inherited By: HScrollBar, VScrollBar

Abstract base class for scrollbars.

Description

Abstract base class for scrollbars, typically used to navigate through content that extends beyond the visible area of a control. Scrollbars are Range-based controls.

Properties

float

custom_step

-1.0

float

step

0.0 (overrides Range)

Theme Properties

Texture2D

decrement

Texture2D

decrement_highlight

Texture2D

decrement_pressed

Texture2D

increment

Texture2D

increment_highlight

Texture2D

increment_pressed

StyleBox

grabber

StyleBox

grabber_highlight

StyleBox

grabber_pressed

StyleBox

scroll

StyleBox

scroll_focus


Signals

scrolling() 🔗

Emitted when the scrollbar is being scrolled.


Property Descriptions

float custom_step = -1.0 🔗

  • void set_custom_step(value: float)

  • float get_custom_step()

Overrides the step used when clicking increment and decrement buttons or when using arrow keys when the ScrollBar is focused.


Theme Property Descriptions

Texture2D decrement 🔗

Icon used as a button to scroll the ScrollBar left/up. Supports custom step using the custom_step property.


Texture2D decrement_highlight 🔗

Displayed when the mouse cursor hovers over the decrement button.


Texture2D decrement_pressed 🔗

Displayed when the decrement button is being pressed.


Texture2D increment 🔗

Icon used as a button to scroll the ScrollBar right/down. Supports custom step using the custom_step property.


Texture2D increment_highlight 🔗

Displayed when the mouse cursor hovers over the increment button.


Texture2D increment_pressed 🔗

Displayed when the increment button is being pressed.


StyleBox grabber 🔗

Used as texture for the grabber, the draggable element representing current scroll.


StyleBox grabber_highlight 🔗

Used when the mouse hovers over the grabber.


StyleBox grabber_pressed 🔗

Used when the grabber is being dragged.


StyleBox scroll 🔗

Used as background of this ScrollBar.


StyleBox scroll_focus 🔗

Used as background when the ScrollBar has the GUI focus.