UserStyleSetting.LongRangeUserStyleSetting.Builder

class UserStyleSetting.LongRangeUserStyleSetting.Builder

A builder for LongRangeUserStyleSetting.

Summary

Public constructors
Builder(
    id: UserStyleSetting.Id,
    minimumValue: Long,
    maximumValue: Long,
    defaultValue: Long,
    affectsWatchFaceLayers: Collection<WatchFaceLayer>,
    resources: Resources,
    displayNameResourceId: @StringRes Int,
    descriptionResourceId: @StringRes Int
)

This function is deprecated. AndroidX watchface libraries are deprecated, use Watch Face Format instead.

Public functions
UserStyleSetting.LongRangeUserStyleSetting

This function is deprecated. AndroidX watchface libraries are deprecated, use Watch Face Format instead.
UserStyleSetting.LongRangeUserStyleSetting.Builder
setIcon(icon: Icon)

This function is deprecated. AndroidX watchface libraries are deprecated, use Watch Face Format instead.
UserStyleSetting.LongRangeUserStyleSetting.Builder
setIcon(iconProvider: () -> Icon?)

This function is deprecated. AndroidX watchface libraries are deprecated, use Watch Face Format instead.
UserStyleSetting.LongRangeUserStyleSetting.Builder

This function is deprecated. AndroidX watchface libraries are deprecated, use Watch Face Format instead.

Public constructors

Builder

Builder(
    id: UserStyleSetting.Id,
    minimumValue: Long,
    maximumValue: Long,
    defaultValue: Long,
    affectsWatchFaceLayers: Collection<WatchFaceLayer>,
    resources: Resources,
    displayNameResourceId: @StringRes Int,
    descriptionResourceId: @StringRes Int
)

Constructs a builder for LongRangeUserStyleSetting.

Parameters
id: UserStyleSetting.Id

Id for the LongRangeUserStyleSetting, must be unique.
minimumValue: Long

Minimum value (inclusive).
maximumValue: Long

Maximum value (inclusive).
defaultValue: Long

The default value for the constructed LongRangeUserStyleSetting.
affectsWatchFaceLayers: Collection<WatchFaceLayer>

Used by the style configuration UI. Describes which watch face rendering layers this style affects.
resources: Resources

The Resources from which displayNameResourceId and descriptionResourceId are loaded.
displayNameResourceId: @StringRes Int

String resource id for a human readable name for the LongRangeUserStyleSetting, used in the userStyle selection UI.
descriptionResourceId: @StringRes Int

String resource id for a human readable description string displayed under the displayName in the userStyle selection UI.

Public functions

build

Added in 1.3.0-alpha06
Deprecated in 1.3.0-alpha06
fun build(): UserStyleSetting.LongRangeUserStyleSetting

Constructs the LongRangeUserStyleSetting.

setIcon

Added in 1.3.0-alpha06
Deprecated in 1.3.0-alpha06
fun setIcon(icon: Icon): UserStyleSetting.LongRangeUserStyleSetting.Builder

Sets an Icon for use in the companion userStyle selection UI. This gets sent to the companion over bluetooth and should be small (ideally a few kb in size).

setIcon

Added in 1.3.0-alpha06
Deprecated in 1.3.0-alpha06
fun setIcon(iconProvider: () -> Icon?): UserStyleSetting.LongRangeUserStyleSetting.Builder

Sets a provider of an Icon for use in the companion userStyle selection UI. This gets lazily evaluated and is sent to the companion over bluetooth and should be small (ideally a few kb in size). Note this is not guaranteed to be called on the calling thread. Note it will be called shortly after watch face initialization completes.

setWatchFaceEditorData

Added in 1.3.0-alpha06
Deprecated in 1.3.0-alpha06
fun setWatchFaceEditorData(
    watchFaceEditorData: UserStyleSetting.WatchFaceEditorData
): UserStyleSetting.LongRangeUserStyleSetting.Builder

Sets optional data for an on watch face editor, this will not be sent to the companion and its contents may be used in preference to other fields by an on watch face editor.