CircularProgressIndicator


class CircularProgressIndicator : LayoutElementBuilders.LayoutElement


ProtoLayout component CircularProgressIndicator that represents circular progress indicator which supports a gap in the circular track between startAngle and endAngle.

The CircularProgressIndicator is a colored arc around the edge of the screen with the given start and end angles, which can describe a full or partial circle. Behind it is an arc with optional gap representing full progress. The recommended sizes are defined in . Unless specified, the CircularProgressIndicator will have the full length.

The recommended set of ProgressIndicatorColors can be obtained from , e.g. DEFAULT_COLORS to get a default color scheme for a CircularProgressIndicator.

When accessing the contents of a container for testing, note that this element can't be simply casted back to the original type, i.e.:

CircularProgressIndicator cpi = new CircularProgressIndicator...
Box box = new Box.Builder().addContent(cpi).build();

CircularProgressIndicator myCpi = (CircularProgressIndicator) box.getContents().get(0);
will fail.

To be able to get CircularProgressIndicator object from any layout element, fromLayoutElement method should be used, i.e.:

CircularProgressIndicator myCpi =
  CircularProgressIndicator.fromLayoutElement(box.getContents().get(0));

Summary

Nested types

Builder class for CircularProgressIndicator

Public functions

java-static CircularProgressIndicator?

Returns CircularProgressIndicator object from the given LayoutElement (e.g. one retrieved from a container's content with container.getContents().get(index)) if that element can be converted to CircularProgressIndicator.

ProgressIndicatorColors

Returns main arc color of this CircularProgressIndicator.

TypeBuilders.StringProp?

Returns content description of this CircularProgressIndicator.

DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

DimensionBuilders.DegreesProp

Returns angle representing progressed part of this CircularProgressIndicator.

DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

DimensionBuilders.DpProp

Returns stroke width of this CircularProgressIndicator.

Boolean

Returns whether there is a margin around this indicator or not.

Public functions

fromLayoutElement

Added in 1.0.0
java-static fun fromLayoutElement(element: LayoutElementBuilders.LayoutElement): CircularProgressIndicator?

Returns CircularProgressIndicator object from the given LayoutElement (e.g. one retrieved from a container's content with container.getContents().get(index)) if that element can be converted to CircularProgressIndicator. Otherwise, it will return null.

getCircularProgressIndicatorColors

Added in 1.0.0
fun getCircularProgressIndicatorColors(): ProgressIndicatorColors

Returns main arc color of this CircularProgressIndicator.

getContentDescription

Added in 1.0.0
fun getContentDescription(): TypeBuilders.StringProp?

Returns content description of this CircularProgressIndicator.

getEndAngle

Added in 1.0.0
fun getEndAngle(): DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

getProgress

Added in 1.0.0
fun getProgress(): DimensionBuilders.DegreesProp

Returns angle representing progressed part of this CircularProgressIndicator.

getStartAngle

Added in 1.0.0
fun getStartAngle(): DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

getStrokeWidth

Added in 1.0.0
fun getStrokeWidth(): DimensionBuilders.DpProp

Returns stroke width of this CircularProgressIndicator.

isOuterMarginApplied

Added in 1.2.0
fun isOuterMarginApplied(): Boolean

Returns whether there is a margin around this indicator or not.