java.lang.Object
- com.badlogic.gdx.scenes.scene2d.utils.Selection<T>

All Implemented Interfaces:

Disableable, java.lang.Iterable<T>

Direct Known Subclasses:

ArraySelection
```
public class Selection<T>
extends java.lang.Object
implements Disableable, java.lang.Iterable<T>
```
Manages selected objects. Optionally fires a ChangeListener.ChangeEvent on an actor. Selection changes can be vetoed via Event.cancel().

Constructor Summary

Constructors
Constructor Description

Selection()

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`void`	`add(T item)`	Adds the item to the selection.
`void`	`addAll(Array<T> items)`
`protected void`	`changed()`	Called after the selection changes.
`void`	`choose(T item)`	Selects or deselects the specified item based on how the selection is configured, whether ctrl is currently pressed, etc.
`void`	`clear()`
`boolean`	`contains(T item)`
`boolean`	`fireChangeEvent()`	Fires a change event on the selection's actor, if any.
`T`	`first()`	Returns the first selected item, or null.
`T`	`getLastSelected()`	Makes a best effort to return the last item selected, else returns an arbitrary item or null if the selection is empty.
`boolean`	`getMultiple()`
`boolean`	`getRequired()`
`boolean`	`getToggle()`
`boolean`	`hasItems()`	Deprecated. Use `notEmpty()`.
`boolean`	`isDisabled()`
`boolean`	`isEmpty()`
`OrderedSet<T>`	`items()`
`java.util.Iterator<T>`	`iterator()`
`boolean`	`notEmpty()`
`void`	`remove(T item)`
`void`	`removeAll(Array<T> items)`
`void`	`set(T item)`	Sets the selection to only the specified item.
`void`	`setActor(Actor actor)`
`void`	`setAll(Array<T> items)`
`void`	`setDisabled(boolean isDisabled)`	If true, prevents `choose(Object)` from changing the selection.
`void`	`setMultiple(boolean multiple)`	If true, allows `choose(Object)` to select multiple items.
`void`	`setProgrammaticChangeEvents(boolean programmaticChangeEvents)`	If false, only `choose(Object)` will fire a change event.
`void`	`setRequired(boolean required)`	If true, prevents `choose(Object)` from selecting none.
`void`	`setToggle(boolean toggle)`	If true, prevents `choose(Object)` from clearing the selection.
`int`	`size()`
`Array<T>`	`toArray()`
`Array<T>`	`toArray(Array<T> array)`
`java.lang.String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - Selection
```
public Selection()
```
- Method Detail
  - setActor
```
public void setActor(@Null
                     Actor actor)
```
    Parameters:
    
    actor - An actor to fire ChangeListener.ChangeEvent on when the selection changes, or null.
  - choose
```
public void choose(T item)
```
    Selects or deselects the specified item based on how the selection is configured, whether ctrl is currently pressed, etc. This is typically invoked by user interaction.
  - hasItems
```
@Deprecated
public boolean hasItems()
```
    Deprecated.
    Use notEmpty().
  - notEmpty
```
public boolean notEmpty()
```
  - isEmpty
```
public boolean isEmpty()
```
  - size
```
public int size()
```
  - items
```
public OrderedSet<T> items()
```
  - first
```
@Null
public T first()
```
    Returns the first selected item, or null.
  - set
```
public void set(T item)
```
    Sets the selection to only the specified item.
  - setAll
```
public void setAll(Array<T> items)
```
  - add
```
public void add(T item)
```
    Adds the item to the selection.
  - addAll
```
public void addAll(Array<T> items)
```
  - remove
```
public void remove(T item)
```
  - removeAll
```
public void removeAll(Array<T> items)
```
  - clear
```
public void clear()
```
  - changed
```
protected void changed()
```
    Called after the selection changes. The default implementation does nothing.
  - fireChangeEvent
```
public boolean fireChangeEvent()
```
    Fires a change event on the selection's actor, if any. Called internally when the selection changes, depending on setProgrammaticChangeEvents(boolean).
    
    Returns:
    
    true if the change should be undone.
  - contains
```
public boolean contains(@Null
                        T item)
```
    Parameters:
    
    item - May be null (returns false).
  - getLastSelected
```
@Null
public T getLastSelected()
```
    Makes a best effort to return the last item selected, else returns an arbitrary item or null if the selection is empty.
  - iterator
```
public java.util.Iterator<T> iterator()
```
    Specified by:
    
    iterator in interface java.lang.Iterable<T>
  - toArray
```
public Array<T> toArray()
```
  - toArray
```
public Array<T> toArray(Array<T> array)
```
  - setDisabled
```
public void setDisabled(boolean isDisabled)
```
    If true, prevents choose(Object) from changing the selection. Default is false.
    
    Specified by:
    
    setDisabled in interface Disableable
  - isDisabled
```
public boolean isDisabled()
```
    Specified by:
    
    isDisabled in interface Disableable
  - getToggle
```
public boolean getToggle()
```
  - setToggle
```
public void setToggle(boolean toggle)
```
    If true, prevents choose(Object) from clearing the selection. Default is false.
  - getMultiple
```
public boolean getMultiple()
```
  - setMultiple
```
public void setMultiple(boolean multiple)
```
    If true, allows choose(Object) to select multiple items. Default is false.
  - getRequired
```
public boolean getRequired()
```
  - setRequired
```
public void setRequired(boolean required)
```
    If true, prevents choose(Object) from selecting none. Default is false.
  - setProgrammaticChangeEvents
```
public void setProgrammaticChangeEvents(boolean programmaticChangeEvents)
```
    If false, only choose(Object) will fire a change event. Default is true.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class Selection<T>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Constructor Detail

Selection

Method Detail

setActor

choose

hasItems

notEmpty

isEmpty

size

items

first

set

setAll

add

addAll

remove

removeAll

clear

changed

fireChangeEvent

contains

getLastSelected

iterator

toArray

toArray

setDisabled

isDisabled

getToggle

setToggle

getMultiple

setMultiple

getRequired

setRequired

setProgrammaticChangeEvents

toString