sk.baka.ambient.views
Class ViewUtils

java.lang.Object
  sk.baka.ambient.views.ViewUtils

public final class ViewUtils
extends java.lang.Object

Utility methods for views. Not thread safe.

Author:

Martin Vysny

Nested Class Summary

static interface

ViewUtils.OnTextSubmit Fired when a text has been successfully entered.

Field Summary

static android.content.DialogInterface.OnClickListener	CANCEL Cancels the dialog on invocation.
android.graphics.Point	measuredText The result of measureTextCache(Paint, String) is stored here.
android.graphics.Point	translated A result of translate* operations is stored here.
(package private) int[]	translatedPoint Here the temporary results of all translate* methods are stored.

Constructor Summary

ViewUtils()

Method Summary

static void	addImage(android.content.Context c, android.text.SpannableStringBuilder s, int resId) Appends an ImageSpan to given builder.
static android.graphics.Point	clone(android.graphics.Point point) Clones given point
static int	getTextHeight(android.graphics.Paint paint, java.lang.String text) Returns the text height.
static int	intMeasureText(android.graphics.Paint paint, java.lang.String text) Measures text with given paint.
static boolean	isCancel(android.view.MotionEvent event) Checks if given event is a MotionEvent.ACTION_CANCEL event.
static boolean	isPenUp(android.view.MotionEvent event) Checks if given event is a MotionEvent.ACTION_UP or MotionEvent.ACTION_CANCEL event.
static android.graphics.Point	measureText(android.graphics.Paint paint, java.lang.String text) Measures given text width/height and returns the result as a point.
static void	measureText(android.graphics.Paint paint, java.lang.String text, android.graphics.Point point) Measures given text width/height and sets them to the given point.
void	measureTextCache(android.graphics.Paint paint, java.lang.String text) Measures given text width/height and sets them to the cached point.
static void	recycleBitmaps(java.util.Collection<android.graphics.Bitmap> bitmaps) Recycles given collection of bitmap.
static android.app.AlertDialog	showOkDialog(android.content.Context context, java.lang.CharSequence caption, java.lang.CharSequence text, int icon) Shows a simple OK dialog.
static android.app.Dialog	showTextEditor(android.content.Context context, java.lang.String submitButtonCaption, java.lang.String cancelButtonCaption, java.lang.String dialogCaption, java.lang.String text, ViewUtils.OnTextSubmit listener) Creates new text dialog with a text enter capability.
static android.app.AlertDialog	showYesNoDialog(android.content.Context context, java.lang.String question, android.content.DialogInterface.OnClickListener yesButtonListener) Shows a simple yes/no question dialog.
void	translateCoordinates(android.graphics.Point point, android.view.View view, android.view.View targetView) Translates given point into target view's coordinate system and stores the result into the translated point.
void	translateCoordinatesToRoot(android.graphics.Point point, android.view.View view) Translates given point into root view's coordinate system.

Methods inherited from class java.lang.Object

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

Field Detail

translatedPoint

final int[] translatedPoint

Here the temporary results of all translate* methods are stored. This is just a cache, to prevent an array creation on each call.

translated

public final android.graphics.Point translated

A result of translate* operations is stored here.

measuredText

public final android.graphics.Point measuredText

The result of measureTextCache(Paint, String) is stored here.

CANCEL

public static final android.content.DialogInterface.OnClickListener CANCEL

Cancels the dialog on invocation.

Constructor Detail

ViewUtils

public ViewUtils()

Method Detail

clone

public static final android.graphics.Point clone(android.graphics.Point point)

Clones given point

Parameters:

point - the point to clone

Returns:

cloned point

recycleBitmaps

public static void recycleBitmaps(java.util.Collection<android.graphics.Bitmap> bitmaps)

Recycles given collection of bitmap. The collection is emptied afterwards.

Parameters:

bitmaps - bitmaps to recycle.

translateCoordinates

public void translateCoordinates(android.graphics.Point point,
                                 android.view.View view,
                                 android.view.View targetView)

Translates given point into target view's coordinate system and stores the result into the translated point.

Parameters:

point - the point to translate. Will not get modified. If null then the translated point data will be taken instead.

view - the point belongs to the coordinate system of this view. If null then the point is an absolute screen position.

targetView - translate the view to this view coordinate system. If null then the point will be returned as an absolute screen position.

translateCoordinatesToRoot

public void translateCoordinatesToRoot(android.graphics.Point point,
                                       android.view.View view)

Translates given point into root view's coordinate system. Does nothing if the supplied view is null.

Parameters:

point - the point to translate. Will not get modified.

view - the point belongs to the coordinate system of this view. If null then the point is an absolute screen position.

getTextHeight

public static int getTextHeight(android.graphics.Paint paint,
                                java.lang.String text)

Returns the text height.

Parameters:

paint - the paint to use

text - the text to measure

Returns:

text height, in pixels.

measureText

public static void measureText(android.graphics.Paint paint,
                               java.lang.String text,
                               android.graphics.Point point)

Measures given text width/height and sets them to the given point.

Parameters:

paint - the paint

text - text to measure

point - overwrites this point.

intMeasureText

public static int intMeasureText(android.graphics.Paint paint,
                                 java.lang.String text)

Measures text with given paint. Correctly handles newlines.

Parameters:

paint - the paint

text - the text to measure

Returns:

text width.

measureText

public static android.graphics.Point measureText(android.graphics.Paint paint,
                                                 java.lang.String text)

Measures given text width/height and returns the result as a point.

Parameters:

paint - the paint

text - text to measure

Returns:

the text sizes

measureTextCache

public void measureTextCache(android.graphics.Paint paint,
                             java.lang.String text)

Measures given text width/height and sets them to the cached point.

Parameters:

paint - the paint

text - text to measure

showTextEditor

public static android.app.Dialog showTextEditor(android.content.Context context,
                                                java.lang.String submitButtonCaption,
                                                java.lang.String cancelButtonCaption,
                                                java.lang.String dialogCaption,
                                                java.lang.String text,
                                                ViewUtils.OnTextSubmit listener)

Creates new text dialog with a text enter capability. When the dialog is submitted the text submit event is fired.

Parameters:

context - the context

submitButtonCaption - the submit button caption, if null then OK will be shown.

cancelButtonCaption - the cancel button caption, if null then Cancel will be shown.

dialogCaption - the dialog caption

text - the text to show in the dialog.

listener - fire events on this listener

Returns:

the dialog instance. The dialog is already shown.

showYesNoDialog

public static android.app.AlertDialog showYesNoDialog(android.content.Context context,
                                                      java.lang.String question,
                                                      android.content.DialogInterface.OnClickListener yesButtonListener)

Shows a simple yes/no question dialog.

Parameters:

context - the context.

question - the question body.

yesButtonListener - invoked when user presses the 'Yes' button.

Returns:

the dialog instance. The dialog is already shown.

showOkDialog

public static android.app.AlertDialog showOkDialog(android.content.Context context,
                                                   java.lang.CharSequence caption,
                                                   java.lang.CharSequence text,
                                                   int icon)

Shows a simple OK dialog.

Parameters:

context - the context.

caption - the dialog caption

text - the text body.

icon - optional dialog icon, may be -1 if it should not be shown.

Returns:

the dialog instance. The dialog is already shown.

isPenUp

public static boolean isPenUp(android.view.MotionEvent event)

Checks if given event is a MotionEvent.ACTION_UP or MotionEvent.ACTION_CANCEL event.

Parameters:

event - the event to check

Returns:

true if pen is up or the motion is canceled, false otherwise.

isCancel

public static boolean isCancel(android.view.MotionEvent event)

Checks if given event is a MotionEvent.ACTION_CANCEL event.

Parameters:

event - the event to check

Returns:

true if the motion is canceled, false otherwise.

addImage

public static void addImage(android.content.Context c,
                            android.text.SpannableStringBuilder s,
                            int resId)

Appends an ImageSpan to given builder.

Parameters:

c - the context

s - the builder

resId - image id.