android.graphics
Class NinePatch

java.lang.Object
  android.graphics.NinePatch

public class NinePatch
extends Object

The NinePatch class permits drawing a bitmap in nine sections. The four corners are unscaled; the four edges are scaled in one axis, and the middle is scaled in both axes. Normally, the middle is transparent so that the patch can provide a selection about a rectangle. Essentially, it allows the creation of custom graphics that will scale the way that you define, when content added within the image exceeds the normal bounds of the graphic. For a thorough explanation of a NinePatch image, read the discussion in the Available Resource Types document.

The Draw 9-patch tool offers an extremely handy way to create your NinePatch images, using a WYSIWYG graphics editor.

Constructor Summary

NinePatch(Bitmap bitmap, byte[] chunk, String srcName)
Create a drawable projection from a bitmap to nine patches.

Method Summary

void	draw(Canvas canvas, Rect location) Draw a bitmap to nine patches.
void	draw(Canvas canvas, RectF location) Draw a bitmap to nine patches.
void	draw(Canvas canvas, Rect location, Paint paint) Draw a bitmap to nine patches.
int	getHeight()
Region	getTransparentRegion(Rect location)
int	getWidth()
boolean	hasAlpha()
static boolean	isNinePatchChunk(byte[] chunk)
void	setPaint(Paint p)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NinePatch

public NinePatch(Bitmap bitmap,
                 byte[] chunk,
                 String srcName)

Create a drawable projection from a bitmap to nine patches.

Parameters:

bitmap - The bitmap describing the patches.

chunk - The 9-patch data chunk describing how the underlying bitmap is split apart and drawn.

srcName - The name of the source for the bitmap. Might be null.

Method Detail

setPaint

public void setPaint(Paint p)

draw

public void draw(Canvas canvas,
                 RectF location)

Draw a bitmap to nine patches.

Parameters:

canvas - A container for the current matrix and clip used to draw the bitmap.

location - Where to draw the bitmap.

draw

public void draw(Canvas canvas,
                 Rect location)

Draw a bitmap to nine patches.

Parameters:

canvas - A container for the current matrix and clip used to draw the bitmap.

location - Where to draw the bitmap.

draw

public void draw(Canvas canvas,
                 Rect location,
                 Paint paint)

Draw a bitmap to nine patches.

Parameters:

canvas - A container for the current matrix and clip used to draw the bitmap.

location - Where to draw the bitmap.

paint - The Paint to draw through.

getWidth

public int getWidth()

getHeight

public int getHeight()

hasAlpha

public final boolean hasAlpha()

getTransparentRegion

public final Region getTransparentRegion(Rect location)

isNinePatchChunk

public static boolean isNinePatchChunk(byte[] chunk)