readium-navigator/org.readium.r2.navigator.preferences/OptionalRangePreferenceDelegate

OptionalRangePreferenceDelegate

class OptionalRangePreferenceDelegate<T : Comparable<T>>(getValue: () -> T?, getEffectiveValue: () -> T?, getIsEffective: () -> Boolean, updateValue: (T?) -> Unit, defaultValue: T, valueFormatter: (T) -> String, val supportedRange: ClosedRange<T>, progressionStrategy: ProgressionStrategy<T>) : PreferenceDelegate<T?> , OptionalRangePreference<T>

Constructors

constructor(getValue: () -> T?, getEffectiveValue: () -> T?, getIsEffective: () -> Boolean, updateValue: (T?) -> Unit, defaultValue: T, valueFormatter: (T) -> String, supportedRange: ClosedRange<T>, progressionStrategy: ProgressionStrategy<T>)

Properties

effectiveValue

open override val effectiveValue: T?

The value that will be effectively used by the navigator if preferences are submitted as they are.

isEffective

open override val isEffective: Boolean

If this preference will be effectively used by the navigator if preferences are submitted as they are.

supportedRange

open override val supportedRange: ClosedRange<T>

value

open override val value: T?

The current value of the preference.

Functions

clear

fun <T> Preference<T>.clear()

Unset the preference.

decrement

open override fun decrement()

Decrement the preference value from its current value or a default value.

flipped

fun Preference<Boolean>.flipped(): Preference<Boolean>

Returns a new preference with its boolean value flipped.

formatValue

open override fun formatValue(value: T): String

Format value in a way suitable for display, including unit if relevant.

increment

open override fun increment()

Increment the preference value from its current value or a default value.

map

fun <T, V> Preference<T>.map(from: (T) -> V, to: (V) -> T): Preference<V>

Creates a new Preference object wrapping the receiver and converting its value from and to the target type V.

set

open override fun set(value: T?)

Set the preference to value. A null value means unsetting the preference.

toggle

fun Preference<Boolean>.toggle()

Toggle the preference value. A default value is taken as the initial one if the preference is currently unset.

withSupportedValues

fun <T> Preference<T>.withSupportedValues(vararg supportedValues: T): EnumPreference<T>

fun <T> Preference<T>.withSupportedValues(supportedValues: List<T>): EnumPreference<T>

Creates a new EnumPreference object wrapping the receiver with the provided supportedValues.