# Print output for @column tags ?> RangeTemplate - Android SDK | Android Developers

Most visited

Recently visited

RangeTemplate

public final class RangeTemplate
extends ControlTemplate

java.lang.Object
   ↳ android.service.controls.templates.ControlTemplate
     ↳ android.service.controls.templates.RangeTemplate


A template for a Control with inputs in a "continuous" range of values.

See also:

Summary

Inherited constants

Public constructors

RangeTemplate(String templateId, float minValue, float maxValue, float currentValue, float stepValue, CharSequence formatString)

Construct a new RangeTemplate.

Public methods

float getCurrentValue()

The current value for this range.

CharSequence getFormatString()

Formatter for generating a user visible String representing the value returned by RangeTemplate#getCurrentValue.

float getMaxValue()

The maximum value for this range.

float getMinValue()

The minimum value for this range.

float getStepValue()

The value of the smallest increment or decrement that can be performed on this range.

int getTemplateType()

The TemplateType associated with this class.

Inherited methods

Public constructors

RangeTemplate

public RangeTemplate (String templateId, 
                float minValue, 
                float maxValue, 
                float currentValue, 
                float stepValue, 
                CharSequence formatString)

Construct a new RangeTemplate. The range must be valid, meaning:

  • minValue < maxValue
  • minValue < currentValue
  • currentValue < maxValue
  • 0 < stepValue

The current value of the Control will be formatted accordingly.

Parameters
templateId String: the identifier for this template object This value cannot be null.

minValue float: minimum value for the input

maxValue float: maximum value for the input

currentValue float: the current value of the Control containing this object.

stepValue float: minimum value of increments/decrements when interacting with this control.

formatString CharSequence: a formatting string as per String#format used to display the currentValue. If null is passed, the "%.1f" is used. This value may be null.

Throws
IllegalArgumentException if the parameters passed do not make a valid range.

Public methods

getCurrentValue

public float getCurrentValue ()

The current value for this range.

Returns
float

getFormatString

public CharSequence getFormatString ()

Formatter for generating a user visible String representing the value returned by RangeTemplate#getCurrentValue.

Returns
CharSequence a formatting string as specified in String#format This value cannot be null.

getMaxValue

public float getMaxValue ()

The maximum value for this range.

Returns
float

getMinValue

public float getMinValue ()

The minimum value for this range.

Returns
float

getStepValue

public float getStepValue ()

The value of the smallest increment or decrement that can be performed on this range.

Returns
float

getTemplateType

public int getTemplateType ()

The TemplateType associated with this class.

Returns
int ControlTemplate#TYPE_RANGE