Android APIs
public class

RoundRectShape

extends RectShape
java.lang.Object
   ↳ android.graphics.drawable.shapes.Shape
     ↳ android.graphics.drawable.shapes.RectShape
       ↳ android.graphics.drawable.shapes.RoundRectShape

Class Overview

Creates a rounded-corner rectangle. Optionally, an inset (rounded) rectangle can be included (to make a sort of "O" shape). The rounded rectangle can be drawn to a Canvas with its own draw() method, but more graphical control is available if you instead pass the RoundRectShape to a ShapeDrawable.

Summary

Public Constructors
RoundRectShape(float[] outerRadii, RectF inset, float[] innerRadii)
RoundRectShape constructor.
Public Methods
RoundRectShape clone()
Creates and returns a copy of this Object.
void draw(Canvas canvas, Paint paint)
Draw this shape into the provided Canvas, with the provided Paint.
void getOutline(Outline outline)
Compute the Outline of the shape and return it in the supplied Outline parameter.
Protected Methods
void onResize(float w, float h)
Callback method called when resize(float, float) is executed.
[Expand]
Inherited Methods
From class android.graphics.drawable.shapes.RectShape
From class android.graphics.drawable.shapes.Shape
From class java.lang.Object

Public Constructors

public RoundRectShape (float[] outerRadii, RectF inset, float[] innerRadii)

Added in API level 1

RoundRectShape constructor. Specifies an outer (round)rect and an optional inner (round)rect.

Parameters
outerRadii float: An array of 8 radius values, for the outer roundrect. The first two floats are for the top-left corner (remaining pairs correspond clockwise). For no rounded corners on the outer rectangle, pass null.
inset RectF: A RectF that specifies the distance from the inner rect to each side of the outer rect. For no inner, pass null.
innerRadii float: An array of 8 radius values, for the inner roundrect. The first two floats are for the top-left corner (remaining pairs correspond clockwise). For no rounded corners on the inner rectangle, pass null. If inset parameter is null, this parameter is ignored.

Public Methods

public RoundRectShape clone ()

Added in API level 1

Creates and returns a copy of this Object. The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should call super.clone() to create the new instance and then create deep copies of the nested, mutable objects.

Returns
RoundRectShape a copy of this object.
Throws
CloneNotSupportedException

public void draw (Canvas canvas, Paint paint)

Added in API level 1

Draw this shape into the provided Canvas, with the provided Paint. Before calling this, you must call resize(float, float).

Parameters
canvas Canvas: the Canvas within which this shape should be drawn
paint Paint: the Paint object that defines this shape's characteristics

public void getOutline (Outline outline)

Added in API level 21

Compute the Outline of the shape and return it in the supplied Outline parameter. The default implementation does nothing and outline is not changed.

Parameters
outline Outline: The Outline to be populated with the result. Should not be null.

Protected Methods

protected void onResize (float w, float h)

Added in API level 1

Callback method called when resize(float, float) is executed.

Parameters
w float: the new width of the Shape
h float: the new height of the Shape