com.badlogic.gdx.scenes.scene2d.ui

Class Slider

java.lang.Object

com.badlogic.gdx.scenes.scene2d.Actor

com.badlogic.gdx.scenes.scene2d.ui.Widget

com.badlogic.gdx.scenes.scene2d.ui.ProgressBar

com.badlogic.gdx.scenes.scene2d.ui.Slider

All Implemented Interfaces:

Disableable, Layout

public class Slider
extends ProgressBar

A slider is a horizontal indicator that allows a user to set a value. The slider has a range (min, max) and a stepping between each value the slider represents.

ChangeListener.ChangeEvent is fired when the slider knob is moved. Canceling the event will move the knob to where it was previously.

The preferred height of a slider is determined by the larger of the knob and background. The preferred width of a slider is 140, a relatively arbitrary size.

Author:

mzechner, Nathan Sweet

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Slider.SliderStyle The style for a slider, see Slider.

Nested classes/interfaces inherited from class com.badlogic.gdx.scenes.scene2d.ui.ProgressBar

ProgressBar.ProgressBarStyle

Constructor Summary

Constructors

Constructor and Description
Slider(float min, float max, float stepSize, boolean vertical, Skin skin)
Slider(float min, float max, float stepSize, boolean vertical, Skin skin, String styleName)
Slider(float min, float max, float stepSize, boolean vertical, Slider.SliderStyle style) Creates a new slider.

Method Summary

Methods

Modifier and Type	Method and Description
Slider.SliderStyle	getStyle() Returns the slider's style.
boolean	isDragging() Returns true if the slider is being dragged.
void	setStyle(Slider.SliderStyle style)

Methods inherited from class com.badlogic.gdx.scenes.scene2d.ui.ProgressBar

act, draw, getMaxValue, getMinValue, getPrefHeight, getPrefWidth, getStepSize, getValue, getVisualValue, isDisabled, setAnimateDuration, setAnimateInterpolation, setDisabled, setRange, setSnapToValues, setStepSize, setStyle, setValue

Methods inherited from class com.badlogic.gdx.scenes.scene2d.ui.Widget

getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, invalidate, invalidateHierarchy, layout, needsLayout, pack, setFillParent, setLayoutEnabled, validate

Methods inherited from class com.badlogic.gdx.scenes.scene2d.Actor

addAction, addCaptureListener, addListener, clear, clearActions, clearListeners, clipBegin, clipBegin, clipEnd, debug, drawDebug, fire, getActions, getCaptureListeners, getCenterX, getCenterY, getColor, getDebug, getHeight, getListeners, getName, getOriginX, getOriginY, getParent, getRight, getRotation, getScaleX, getScaleY, getStage, getTop, getTouchable, getUserObject, getWidth, getX, getY, getZIndex, hasParent, hit, isAscendantOf, isDescendantOf, isTouchable, isVisible, localToAscendantCoordinates, localToParentCoordinates, localToStageCoordinates, moveBy, notify, parentToLocalCoordinates, remove, removeAction, removeCaptureListener, removeListener, rotateBy, scaleBy, scaleBy, screenToLocalCoordinates, setBounds, setCenterPosition, setColor, setColor, setDebug, setHeight, setName, setOrigin, setOriginX, setOriginY, setPosition, setRotation, setScale, setScale, setScaleX, setScaleY, setSize, setTouchable, setUserObject, setVisible, setWidth, setX, setY, setZIndex, sizeBy, sizeBy, stageToLocalCoordinates, toBack, toFront, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Slider

public Slider(float min,
      float max,
      float stepSize,
      boolean vertical,
      Skin skin)

Slider

public Slider(float min,
      float max,
      float stepSize,
      boolean vertical,
      Skin skin,
      String styleName)

Slider

public Slider(float min,
      float max,
      float stepSize,
      boolean vertical,
      Slider.SliderStyle style)

Creates a new slider. It's width is determined by the given prefWidth parameter, its height is determined by the maximum of the height of either the slider NinePatch or slider handle TextureRegion. The min and max values determine the range the values of this slider can take on, the stepSize parameter specifies the distance between individual values. E.g. min could be 4, max could be 10 and stepSize could be 0.2, giving you a total of 30 values, 4.0 4.2, 4.4 and so on.

Parameters:

min - the minimum value

max - the maximum value

stepSize - the step size between values

style - the Slider.SliderStyle

Method Detail

setStyle

public void setStyle(Slider.SliderStyle style)

getStyle

public Slider.SliderStyle getStyle()

Returns the slider's style. Modifying the returned style may not have an effect until setStyle(SliderStyle) is called.

Overrides:

getStyle in class ProgressBar

isDragging

public boolean isDragging()

Returns true if the slider is being dragged.