FieldNumber

public final class FieldNumber extends Field

A 'field_number' type of field, for an editable number.

Constant Summary

double

NO_CONSTRAINT

Inherited Constant Summary

From class com.google.blockly.model.Field

int	TYPE_ANGLE
String	TYPE_ANGLE_STRING
int	TYPE_CHECKBOX
String	TYPE_CHECKBOX_STRING
int	TYPE_COLOR
String	TYPE_COLOR_STRING
int	TYPE_DATE
String	TYPE_DATE_STRING
int	TYPE_DROPDOWN
String	TYPE_DROPDOWN_STRING
int	TYPE_IMAGE
String	TYPE_IMAGE_STRING
int	TYPE_INPUT
String	TYPE_INPUT_STRING
int	TYPE_LABEL
String	TYPE_LABEL_STRING
int	TYPE_NUMBER
String	TYPE_NUMBER_STRING
int	TYPE_UNKNOWN
int	TYPE_VARIABLE
String	TYPE_VARIABLE_STRING

Field Summary

protected static final DecimalFormat

INTEGER_DECIMAL_FORMAT

This formatter is used when precision is a multiple of 1.

Inherited Field Summary

From class android.database.Observable

protected final ArrayList<T>

mObservers

Public Constructor Summary

FieldNumber(String name)

Public Method Summary

FieldNumber	clone()
static FieldNumber	fromJson(JSONObject json)
double	getMaximumValue()
double	getMinimumValue()
NumberFormat	getNumberFormatForLocale(Locale locale) Retrieves (possibly constructing) a NumberFormat configured for both the field constraints and the provided Locale.
double	getPrecision() This returns the precision of the value allowed by this field.
String	getSerializedValue()
double	getValue()
boolean	hasMaximum()
boolean	hasMinimum()
boolean	hasPrecision()
boolean	isInteger()
void	setConstraints(double min, double max, double precision) Sets the constraints on valid number values.
boolean	setFromString(String text) Sets the value from a string.
void	setValue(double newValue) Sets the number in this Field.

Inherited Method Summary

From class com.google.blockly.model.Field

Field	clone()
void	fireValueChanged(String oldValueString, String newValueString) Triggers events (both BlocklyEvent.ChangeEvents and Field.Observers) in response to a value change.
Block	getBlock()
String	getName() Get the name of this field.
abstract String	getSerializedValue()
int	getType() Get the type of this field.
static boolean	isFieldType(String typeString) Checks if the given type name is a known field type.
void	serialize(XmlSerializer serializer) Writes information about the editable parts of the field as XML.
void	setBlock(Block block) Sets the parent block for this field.
abstract boolean	setFromString(String text) Sets the values of the field from a string.

From class android.database.Observable

void	registerObserver(Field.Observer arg0)
void	unregisterAll()
void	unregisterObserver(Field.Observer arg0)

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Constants

public static final double NO_CONSTRAINT

Constant Value: NaN

Fields

protected static final DecimalFormat INTEGER_DECIMAL_FORMAT

This formatter is used when precision is a multiple of 1.

Public Constructors

public FieldNumber (String name)

Parameters

name

Public Methods

public FieldNumber clone ()

public static FieldNumber fromJson (JSONObject json)

Parameters

json

Throws

BlockLoadingException

public double getMaximumValue ()

Returns

• The maximum allowed value for this field.

public double getMinimumValue ()

Returns

• The minimum allowed value for this field.

public NumberFormat getNumberFormatForLocale (Locale locale)

Retrieves (possibly constructing) a NumberFormat configured for both the field constraints and the provided Locale.

Parameters

locale	The locale to construct a number formatter for.

Returns

• A NumberFormat configured for both the field constraints and the Locale.

public double getPrecision ()

This returns the precision of the value allowed by this field. The value must be a multiple of precision. Precision is usually expressed as a power of 10 (e.g., 1, 100, 0.01), though other useful examples might be 5, 20, or 25.

Returns

• The precision allowed for the value.

public String getSerializedValue ()

Returns

• The value serialized into a string.

public double getValue ()

Returns

• The number the user has entered.

public boolean hasMaximum ()

Returns

• True if there's a maximum constraint, false if the maximum is unbounded.

public boolean hasMinimum ()

Returns

• True if there's a minimum constraint, false if the minimum is unbounded.

public boolean hasPrecision ()

Returns

• True if there's a precision applied to the value, false otherwise.

public boolean isInteger ()

Returns

• Whether the precision (and thus the value) is an integer.

public void setConstraints (double min, double max, double precision)

Sets the constraints on valid number values.

Changing the constraints may trigger a BlocklyEvent.ChangeEvent, even if the value does not change.

Parameters

min	The minimum allowed value, inclusive.
max	The maximum allowed value, inclusive.
precision	The precision of allowed values. Valid values are multiples of this number, such as 1, 0.1, 100, or 0.125.

public boolean setFromString (String text)

Sets the value from a string. As long as the text can be parsed as a number, the value will be accepted. The actual value assigned might be modified to fit the min, max, and precision constraints.

Parameters

text	The text value for this field.

Returns

• True if the value parsed without error and the value has been updated.

public void setValue (double newValue)

Sets the number in this Field. The resulting value of this field may differ from newValue to adapt to the assigned min, max, and precision constraints.

Parameters

newValue	The number to replace the field content with.