jMonkeyEngine-wiki/docs/modules/ROOT/pages/jme3/contributions/tonegodgui/spinner.adoc

= spinner
:author: 
:revnumber: 
:revdate: 2016/03/17 20:48
:relfileprefix: ../../../
:imagesdir: ../../..
ifdef::env-github,env-browser[:outfilesuffix: .adoc]



== Spinner Class

The Spinner class provides:

*  A display area for the current step value
*  An increment button
*  A Decrement button
*  It can be set to cycle (when it reaches heighest step value it cycles to index 0, and reversed for decrement.

The Spinner class provides the same 3 common constructors as shown in the <<jme3/contributions/tonegodgui/quickstart#,Quick Start Guide>> with the addition of two extra parameters.

*  The orientation of the Spinner
*  A boolean flag enabling/disabling Spinner cycling.

The additional parameter are appended to the existing parameter list for all 3 constructors, like so:

[source,java]
----

/**
  * Parameters:
  * Screen screen
  * String UID
  * Vector2f position
  * Spinner.Orientation orientation
  * boolean cycle
  */
Spinner spinner1 = new Spinner(
    screen,
    “SomeID”,
    new Vector2f(15, 15),
    Spinner.Orientation.HORIZONTAL,
    true
);

----


=== Abstract Event Methods:

[source,java]
----

public void onChange(int selectedIndex, String value);

----


=== Methods specific to the Spinner class:

[source,java]
----

// Quickly set interval info for both button
spinner1.setInterval(float callsPerSecond);
 
// Adding removing list info
spinner1.addStepValue(String value);
spinner1.removeStepValue(String value);
 
// Quickly populate step values with integers/floats
spinner1.setStepIntegerRange(int min, int max, int inc);
spinner1.setStepFloatRange(float min, float max, float inc);
 
// Retrieval of current selected step
spinner1.getSelectedIndex();

----

You can set the select Spinner's displayed and selected value using:

[source,java]
----

spinner1.setSelectedIndex(int selectedIndex)

----