Button

Artifact: androidx.wear.tiles:tiles-material

View Source

Added in 1.1.0

Deprecated in 1.2.0

---

Kotlin |Java

class Button : LayoutElementBuilders.LayoutElement

---

This class is deprecated.

Use the new class androidx.wear.protolayout.material.Button which provides the same API and functionality.

Tiles component Button that represents clickable button with the given content.

The Button is circular in shape. The recommended sizes are defined in ButtonDefaults.

The recommended set of ButtonColors styles can be obtained from ., e.g. PRIMARY_COLORS to get a color scheme for a primary Button.

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.:

Button button = new Button...
Box box = new Box.Builder().addContent(button).build();

Button myButton = (Button) box.getContents().get(0);

will fail.

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

Button myButton = Button.fromLayoutElement(box.getContents().get(0));

Summary

Nested types
class Button.Builder : LayoutElementBuilders.LayoutElement.Builder Builder class for Button.

Public functions
java-static Button?	fromLayoutElement(element: LayoutElementBuilders.LayoutElement) Returns Button 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 Button.
ButtonColors	getButtonColors() Returns button color of this Button.
ModifiersBuilders.Clickable	getClickable() Returns click event action associated with this Button.
CharSequence?	getContentDescription() Returns content description for this Button.
LayoutElementBuilders.LayoutElement?	getCustomContent() Returns the custom content of this Button if it has been added.
String?	getIconContent() Returns the icon content of this Button if it has been added.
String?	getImageContent() Returns the image content of this Button if it has been added.
DimensionBuilders.ContainerDimension	getSize() Returns size for this Button.
String?	getTextContent() Returns the text content of this Button if it has been added.

Public functions

fromLayoutElement

Added in 1.1.0

Deprecated in 1.2.0

java-static fun fromLayoutElement(element: LayoutElementBuilders.LayoutElement): Button?

Returns Button 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 Button. Otherwise, it will return null.

getButtonColors

Added in 1.1.0

Deprecated in 1.2.0

fun getButtonColors(): ButtonColors

Returns button color of this Button.

getClickable

Added in 1.1.0

Deprecated in 1.2.0

fun getClickable(): ModifiersBuilders.Clickable

Returns click event action associated with this Button.

getContentDescription

Added in 1.1.0

Deprecated in 1.2.0

fun getContentDescription(): CharSequence?

Returns content description for this Button.

getCustomContent

Added in 1.1.0

Deprecated in 1.2.0

fun getCustomContent(): LayoutElementBuilders.LayoutElement?

Returns the custom content of this Button if it has been added. Otherwise, it returns null.

getIconContent

Added in 1.1.0

Deprecated in 1.2.0

fun getIconContent(): String?

Returns the icon content of this Button if it has been added. Otherwise, it returns null.

getImageContent

Added in 1.1.0

Deprecated in 1.2.0

fun getImageContent(): String?

Returns the image content of this Button if it has been added. Otherwise, it returns null.

getSize

Added in 1.1.0

Deprecated in 1.2.0

fun getSize(): DimensionBuilders.ContainerDimension

Returns size for this Button.

getTextContent

Added in 1.1.0

Deprecated in 1.2.0

fun getTextContent(): String?

Returns the text content of this Button if it has been added. Otherwise, it returns null.