Attention: Here be dragons

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

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

hscroll

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 ( float value )

  • 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 hscroll

There is currently no description for this theme property. Please help us by contributing one!


StyleBox scroll

Used as background of this ScrollBar.


StyleBox scroll_focus

Used as background when the ScrollBar has the GUI focus.