CircularProgressIndicator

Added in 1.1.0
Deprecated in 1.2.0

class CircularProgressIndicator : LayoutElementBuilders.LayoutElement


Tiles component CircularProgressIndicator that represents circular progress indicator which supports a gap in the circular track between startAngle and endAngle. [Progress Indicator doc] (https://developer.android.com/training/wearables/components/progress-indicator)

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

Public functions

java-static CircularProgressIndicator?

Returns CircularProgressIndicator object from the given androidx.wear.tiles.LayoutElementBuilders.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.

CharSequence?

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.

Public functions

fromLayoutElement

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

Returns CircularProgressIndicator object from the given androidx.wear.tiles.LayoutElementBuilders.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.1.0
Deprecated in 1.2.0
fun getCircularProgressIndicatorColors(): ProgressIndicatorColors

Returns main arc color of this CircularProgressIndicator.

getContentDescription

Added in 1.1.0
Deprecated in 1.2.0
fun getContentDescription(): CharSequence?

Returns content description of this CircularProgressIndicator.

getEndAngle

Added in 1.1.0
Deprecated in 1.2.0
fun getEndAngle(): DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

getProgress

Added in 1.1.0
Deprecated in 1.2.0
fun getProgress(): DimensionBuilders.DegreesProp

Returns angle representing progressed part of this CircularProgressIndicator.

getStartAngle

Added in 1.1.0
Deprecated in 1.2.0
fun getStartAngle(): DimensionBuilders.DegreesProp

Returns start angle of this CircularProgressIndicator.

getStrokeWidth

Added in 1.1.0
Deprecated in 1.2.0
fun getStrokeWidth(): DimensionBuilders.DpProp

Returns stroke width of this CircularProgressIndicator.