ComplicationsManager

Kotlin |Java

class ComplicationsManager

kotlin.Any
↳	androidx.wear.watchface.ComplicationsManager

The Complications associated with the WatchFace. Dynamic creation of complications isn't supported, however complications can be enabled and disabled, perhaps as part of a user style see androidx.wear.watchface.style.UserStyleSetting.

Summary

Nested classes
abstract	`TapListener`

Public constructors
`<init>(complicationCollection: Collection<Complication>, userStyleRepository: UserStyleRepository)` The Complications associated with the WatchFace.

Public methods
Unit	`addTapListener(tapListener: ComplicationsManager.TapListener)` Adds a TapListener which is called whenever the user interacts with a complication.
Unit	`bringAttentionToComplication(complicationId: Int)` Brings attention to the complication by briefly highlighting it to provide visual feedback when the user has tapped on it.
operator Complication?	`get(id: Int)` Returns the Complication corresponding to id or null.
Complication?	`getBackgroundComplication()` Returns the background complication if there is one or {@code null} otherwise.
Complication?	`getComplicationAt(x: Int, y: Int)` Returns the id of the complication at coordinates x, y or {@code null} if there isn't one.
Unit	`removeTapListener(tapListener: ComplicationsManager.TapListener)` Removes a TapListener previously added by addTapListener.

Properties
Map<Int, Complication>	`complications`

ComplicationsManager(
    complicationCollection: Collection<Complication>, 
    userStyleRepository: UserStyleRepository)

@UiThread fun addTapListener(tapListener: ComplicationsManager.TapListener): Unit

Adds a TapListener which is called whenever the user interacts with a complication.

@UiThread fun bringAttentionToComplication(complicationId: Int): Unit

Brings attention to the complication by briefly highlighting it to provide visual feedback when the user has tapped on it.

Parameters
complicationId: Int	The watch face's ID of the complication to briefly highlight

operator fun get(id: Int): Complication?

Returns the Complication corresponding to id or null.

fun getBackgroundComplication(): Complication?

Returns the background complication if there is one or {@code null} otherwise.

Return
The background complication if there is one or	{@code null} otherwise

fun getComplicationAt(
    x: Int, 
    y: Int
): Complication?

Returns the id of the complication at coordinates x, y or {@code null} if there isn't one.

Parameters
x: Int	The x coordinate of the point to perform a hit test
y: Int	The y coordinate of the point to perform a hit test

Return
The complication at coordinates x,	y or {@code null} if there isn't one

@UiThread fun removeTapListener(tapListener: ComplicationsManager.TapListener): Unit

Removes a TapListener previously added by addTapListener.

val complications: Map<Int, Complication>