Android - An Open Handset Alliance Project

android.widget
public class

android.widget.ZoomSlider

java.lang.Object
	android.view.View		Drawable.Callback KeyEvent.Callback
		android.widget.ZoomSlider

The ZoomSlider class displays a vertical slider with marks to denote different zoom levels. It can be configured to display various ranges and will dynamically display different marks on the slider based on the given range. The caller must supply a ZoomSlider.OnZoomChangedListener to be notified of changes to the zoom level.

Using ZoomSlider

Instantiate: ZoomSlider zoomSlider = new ZoomSlider();
Create a ZoomSlider.OnZoomChangedListener: OnZoomChangedListener zoomListener = new MyZoomListener();
Set your zoom parameters: zoomSlider.setParams(1, 11, zoomListener);
Display: You can use the ZoomSlider like any other view and add to your existing view or display in a Dialog

Nested Classes

ZoomSlider.OnZoomChangedListener

The OnZoomChangedListener is used as a callback to be notified when the user has changed the zoom level.

Summary

XML Attributes

Attribute name	Related methods
android:current		The current zoom value, this is where the slider will be initially positioned i.e.
android:end		The last value of the zoom range (inclusive) i.e.
android:minSegmentSpace		The minimum amount of spacing between the zoom segments This corresponds to the global attribute resource symbol minSegmentSpace.
android:notifyOnZoom		true if the callback should be called every time the zoom level is changed by the user, false if the callback should only be called after the user has selected a zoom level Must be a boolean value, either "`true`" or "`false`".
android:segment		The color of the segment May be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".
android:segmentLength		The length of segment This corresponds to the global attribute resource symbol segmentLength.
android:segmentWidth		The width of segment This corresponds to the global attribute resource symbol segmentWidth.
android:slider		The color of the slider May be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".
android:sliderLength		The length of slider which shows the currently selected zoom level This corresponds to the global attribute resource symbol sliderLength.
android:sliderWidth		The width of slider which shows the currently selected zoom level This corresponds to the global attribute resource symbol sliderWidth.
android:start		The first value of the zoom range (inclusive) i.e.
android:trackBackground		The background of the track This corresponds to the global attribute resource symbol trackBackground.
android:trackLength		The length of the zoom track on which the slider and segments are displayed This corresponds to the global attribute resource symbol trackLength.
android:zoomInIcon		The icon displayed for zooming in Must be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".
android:zoomInPaddingBottom		The bottom padding for the zoom in icon This corresponds to the global attribute resource symbol zoomInPaddingBottom.
android:zoomInPaddingLeft		The left padding for the zoom in icon This corresponds to the global attribute resource symbol zoomInPaddingLeft.
android:zoomInPaddingRight		The right padding for the zoom in icon This corresponds to the global attribute resource symbol zoomInPaddingRight.
android:zoomInPaddingTop		The top padding for the zoom in icon This corresponds to the global attribute resource symbol zoomInPaddingTop.
android:zoomInPressedIcon		The icon in pressed state displayed for zooming in Must be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".
android:zoomOutIcon		The icon displayed for zooming out Must be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".
android:zoomOutPaddingBottom		The bottom padding for the zoom out icon This corresponds to the global attribute resource symbol zoomOutPaddingBottom.
android:zoomOutPaddingLeft		The left padding for the zoom out icon This corresponds to the global attribute resource symbol zoomOutPaddingLeft.
android:zoomOutPaddingRight		The right padding for the zoom out icon This corresponds to the global attribute resource symbol zoomOutPaddingRight.
android:zoomOutPaddingTop		The top padding for the zoom out icon This corresponds to the global attribute resource symbol zoomOutPaddingTop.
android:zoomOutPressedIcon		The icon in pressed state displayed for zooming out Must be a reference to another resource, in the form "`@[[]+][[]package:]type:name`" or to a theme attribute in the form "`?[[]package:][[]type:]name`".

XML Attributes inherited from class android.view.View

Attribute name	Related methods
android:background	setBackground(int)	A drawable to use as the background.
android:clickable	setClickable(boolean)	Defines whether this view reacts to click events.
android:drawingCacheQuality	setDrawingCacheQuality(int)	Defines the quality of translucent drawing caches.
android:fadingEdge	setVerticalFadingEdgeEnabled(boolean)	Defines which edges should be fadeded on scrolling.
android:fadingEdgeLength	getVerticalFadingEdgeLength()	Defines the length of the fading edges.
android:fitStatusBar		Boolean internal attribute to adjust view layout based on the status bar location.
android:focusType	setFocusType(int)	Sets the circumstances under which this view will take focus.
android:focusable	setFocusable(boolean)	Boolean that controls whether a view can take focus.
android:focusableInTouchMode	setFocusableInTouchMode(boolean)	Boolean that controls whether a view can take focus while in touch mode.
android:freezeDisabled	setFreezeDisabled(boolean)	If set, no icicle will be saved for this view when it is being frozen.
android:id	setId(int)	Supply an identifier name for this view, to later retrieve it with View.findViewById() or Activity.findViewById().
android:nextFocusDown		Defines the next view to give focus to when the next focus is FOCUS_DOWN If the reference refers to a view that does not exist or is part of a hierarchy that is invisible, a RuntimeException will result when the reference is accessed.
android:nextFocusLeft		Defines the next view to give focus to when the next focus is FOCUS_LEFT.
android:nextFocusRight		Defines the next view to give focus to when the next focus is FOCUS_RIGHT If the reference refers to a view that does not exist or is part of a hierarchy that is invisible, a RuntimeException will result when the reference is accessed.
android:nextFocusUp		Defines the next view to give focus to when the next focus is FOCUS_UP If the reference refers to a view that does not exist or is part of a hierarchy that is invisible, a RuntimeException will result when the reference is accessed.
android:padding	setPadding(int,int,int,int)	Sets the padding, in pixels, of all four edges.
android:paddingBottom	setPadding(int,int,int,int)	Sets the padding, in pixels, of the bottom edge; see padding.
android:paddingLeft	setPadding(int,int,int,int)	Sets the padding, in pixels, of the left edge; see padding.
android:paddingRight	setPadding(int,int,int,int)	Sets the padding, in pixels, of the right edge; see padding.
android:paddingTop	setPadding(int,int,int,int)	Sets the padding, in pixels, of the top edge; see padding.
android:scrollX		The initial horizontal scroll offset, in pixels.
android:scrollY		The initial vertical scroll offset, in pixels.
android:scrollbarDefaultDelayBeforeFade		Delay in milliseconds before the scrollbars disappear.
android:scrollbarFadeDuration		Duration in milliseconds of the fade when the scrollbars disappear.
android:scrollbarSize		Sets the width of vertical scrollbars and height of horizontal scrollbars.
android:scrollbarThumbHorizontal		Drawable for horizontal scrollbars' thumb.
android:scrollbarThumbVertical		Drawable for vertical scrollbars' thumb.
android:scrollbarTrackHorizontal		Drawable for horizontal scrollbars' track.
android:scrollbarTrackVertical		Drawable for vertical scrollbars' track.
android:scrollbars		Defines which scrollbars should be displayed on scrolling or not.
android:visibility	setVisibility(int)	Controls the initial visibility of the view.

Constants inherited from class android.view.View

DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, GONE, INVISIBLE, NORMAL_FOCUS, NO_ID, VIEW_LOG_TAG, VISIBLE, WEAK_FOCUS

			Value
int	DRAWING_CACHE_QUALITY_AUTO	Enables automatic quality mode for the drawing cache.	0	0x00000000
int	DRAWING_CACHE_QUALITY_HIGH	Enables high quality mode for the drawing cache.	1048576	0x00100000
int	DRAWING_CACHE_QUALITY_LOW	Enables low quality mode for the drawing cache.	524288	0x00080000
int	FOCUS_BACKWARD	Use with focusSearch(int).	1	0x00000001
int	FOCUS_DOWN	Use with focusSearch(int).	130	0x00000082
int	FOCUS_FORWARD	Use with focusSearch(int).	2	0x00000002
int	FOCUS_LEFT	Use with focusSearch(int).	17	0x00000011
int	FOCUS_RIGHT	Use with focusSearch(int).	66	0x00000042
int	FOCUS_UP	Use with focusSearch(int).	33	0x00000021
int	GONE	This view is invisible, and it doesn't take any space for layout purposes.	8	0x00000008
int	INVISIBLE	This view is invisible, but it still takes up space for layout purposes.	4	0x00000004
int	NORMAL_FOCUS	This view wants keystrokes.	0	0x00000000
int	NO_ID	Used to mark a View that has no ID.	-1	0xffffffff
String	VIEW_LOG_TAG	The logging tag used by this class with android.util.Log.	"View"
int	VISIBLE	This view is visible.	0	0x00000000
int	WEAK_FOCUS	This view wants keystrokes, but only if none of its children has focus.	2	0x00000002

Fields inherited from class android.view.View

mBottom, mContext, mLayoutParams, mLeft, mLocation, mOnClickListener, mOnFocusChangeListener, mOnLongClickListener, mOnPopulateContextMenuListener, mPaddingBottom, mPaddingLeft, mPaddingRight, mPaddingTop, mParent, mRight, mScrollX, mScrollY, mTag, mTop

protected		int	mBottom	The distance in pixels from the top edge of this view's parent to the bottom edge of this view.
protected		Context	mContext	The application environment this view lives in.
protected		LayoutParams	mLayoutParams	The layout parameters associated with this view and used by the parent ViewGroup to determine how this view should be laid out.
protected		int	mLeft	The distance in pixels from the left edge of this view's parent to the left edge of this view.
protected	final	int[]	mLocation	Used to store a pair of coordinates, for instance returned values returned by getLocationInWindow(int[]).
protected		OnClickListener	mOnClickListener	Listener used to dispatch click events.
protected		OnFocusChangeListener	mOnFocusChangeListener	Listener used to dispatch focus change events.
protected		OnLongClickListener	mOnLongClickListener	Listener used to dispatch long click events.
protected		OnPopulateContextMenuListener	mOnPopulateContextMenuListener	Listener used to build the context menu.
protected		int	mPaddingBottom	The bottom padding in pixels, that is the distance in pixels between the bottom edge of this view and the bottom edge of its content.
protected		int	mPaddingLeft	The left padding in pixels, that is the distance in pixels between the left edge of this view and the left edge of its content.
protected		int	mPaddingRight	The right padding in pixels, that is the distance in pixels between the right edge of this view and the right edge of its content.
protected		int	mPaddingTop	The top padding in pixels, that is the distance in pixels between the top edge of this view and the top edge of its content.
protected		ViewParent	mParent	The parent this view is attached to.
protected		int	mRight	The distance in pixels from the left edge of this view's parent to the right edge of this view.
protected		int	mScrollX	The offset, in pixels, by which the content of this view is scrolled horizontally.
protected		int	mScrollY	The offset, in pixels, by which the content of this view is scrolled vertically.
protected		Object	mTag	The view's tag.
protected		int	mTop	The distance in pixels from the top edge of this view's parent to the top edge of this view.

Public Constructors

					ZoomSlider(Context context)
					ZoomSlider(Context context, AttributeSet attrs, Map inflateParams)
					ZoomSlider(Context context, AttributeSet attrs, Map inflateParams, int defStyle)

Public Methods

	void	doZoom(boolean in)
		Move the zoom up or down by 1.
final	int	getCurrent()
final	float	getCurrentPercent()
final	int	getCurrentY()
final	int	getMax()
final	int	getMin()
final	int	getRange()
	boolean	onKeyDown(int keyCode, KeyEvent event)
		Default implementation of KeyEvent.Callback.onKeyMultiple(): perform press of the view when KEYCODE_DPAD_CENTER or KEYCODE_NEWLINE is released, if the view is enabled and clickable.
	boolean	onTouchEvent(MotionEvent event)
		Implement this method to handle touch screen motion events.
	void	onZoomCompleted()
		Called by the Dialog once the user has completed zooming and has dismissed the dialog.
final	int	setCurrent(int level)
		Sets the level on the zoom slider.
	void	setOnZoomChangedListener(OnZoomChangedListener zoomListener)
		Sets just the ZoomSlider.OnZoomChangedListener, this should be used when all the other parameters in the setParams(int, int, int, android.widget.ZoomSlider.OnZoomChangedListener, boolean) are specified in the xml file.
	void	setParams(int start, int end, int current, OnZoomChangedListener zoomListener, boolean notifyOnChange)
		Set the parameters for this `ZoomSlider`.

Protected Methods

				void	onDraw(Canvas canvas)
					Implement this to do your drawing.
				void	onMeasure(int widthMeasureSpec, int heightMeasureSpec)
					Measure the view and its content to determine the measured width and the measured height.

Methods inherited from class android.view.View

awakenScrollBars, awakenScrollBars, bringToFront, buildDrawingCache, clearAnimation, clearFocus, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, copyWindowBitmap, dispatchDraw, dispatchFreeze, dispatchKeyEvent, dispatchThaw, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchWindowFocusChanged, dispatchWindowVisibilityChanged, draw, drawableStateChanged, finalize, findFocus, findViewById, findViewWithTag, focusSearch, freeze, getAbsoluteLocationOnScreen, getAnimation, getBackground, getBaseline, getBlockDescendantFocus, getBlockUnmatchedKeyUps, getBottom, getBottomFadingEdgeStrength, getContext, getContextMenuInfo, getDefaultSize, getDrawableState, getDrawingCache, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getFocusType, getFocusables, getFocusedRect, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getInstanceCount, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMeasuredHeight, getMeasuredWidth, getOnFocusChangeListener, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getParent, getResources, getRight, getRightFadingEdgeStrength, getRootView, getScrollX, getScrollY, getTag, getTop, getTopFadingEdgeStrength, getVerticalFadingEdgeLength, getVerticalScrollbarWidth, getViewRootInstanceCount, getVisibility, getWidth, getWindowFrame, getWindowSession, getWindowToken, getWindowVisibility, hasBackground, hasFocus, hasWindowFocus, inTouchMode, initializeFadingEdge, initializeScrollbars, invalidate, invalidate, invalidate, invalidateDrawable, isClickable, isDrawingCacheEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isFreezeDisabled, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isLayoutRequested, isPressed, isSelected, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, layout, measure, mergeDrawableStates, onAttachedToWindow, onCreateDrawableState, onDetachedFromWindow, onDraw, onDrawBackground, onFinishInflate, onFocusChanged, onFreeze, onKeyDown, onKeyMultiple, onKeyUp, onLayout, onMeasure, onPopulateContextMenu, onScrollChanged, onSizeChanged, onThaw, onTouchEvent, onTrackballEvent, onWindowFocusChanged, onWindowVisibilityChanged, performClick, performLongClick, populateContextMenu, post, postDelayed, postInvalidate, postInvalidateDelayed, press, refreshDrawableState, requestFocus, requestFocus, requestFocus, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, resolveSize, scheduleDrawable, scrollBy, scrollTo, setAnimation, setBackground, setBackground, setBackgroundColor, setBlockDescendantFocus, setBlockUnmatchedKeyUps, setClickable, setDrawingCacheEnabled, setDrawingCacheQuality, setEnabled, setFadingEdgeLength, setFocusType, setFocusable, setFocusableInTouchMode, setFreezeDisabled, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setId, setLayoutParams, setMeasuredDimension, setOnClickListener, setOnFocusChangeListener, setOnKeyListener, setOnLongClickListener, setOnPopulateContextMenuListener, setPadding, setPreferredHeight, setPreferredWidth, setSelected, setTag, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVisibility, setWillNotCacheDrawing, setWillNotDraw, startAnimation, thaw, unpress, unscheduleDrawable, unscheduleDrawable, verifyDrawable, willNotCacheDrawing, willNotDraw

	boolean	awakenScrollBars()
		Trigger the scrollbars to draw.
	boolean	awakenScrollBars(int startDelay)
		Trigger the scrollbars to draw.
	void	bringToFront()
		Change the view's z order in the tree, so it's on top of other sibling views
	void	buildDrawingCache()
		Forces the drawing cache to be built if the drawing cache is enabled and if it has not been built yet.
	void	clearAnimation()
		Cancels any animations for this view.
	void	clearFocus()
		Called when this view wants to give up focus.
	int	computeHorizontalScrollExtent()
		Compute the horizontal extent of the horizontal scrollbar's thumb within the horizontal range.
	int	computeHorizontalScrollOffset()
		Compute the horizontal offset of the horizontal scrollbar's thumb within the horizontal range.
	int	computeHorizontalScrollRange()
		Compute the horizontal range that the horizontal scrollbar represents.
	void	computeScroll()
		Called by a parent to request that a child update its values for mScrollX and mScrollY if necessary.
	int	computeVerticalScrollExtent()
		Compute the vertical extent of the horizontal scrollbar's thumb within the vertical range.
	int	computeVerticalScrollOffset()
		Compute the vertical offset of the vertical scrollbar's thumb within the horizontal range.
	int	computeVerticalScrollRange()
		Compute the vertical range that the vertical scrollbar represents.
	Bitmap	copyWindowBitmap()
		Return a copy of the bitmap holding the overall contents of the window this view is attached to.
	void	dispatchDraw(Canvas canvas)
		Called by draw to draw the child views.
	void	dispatchFreeze(SparseArray container)
		Called by freeze(SparseArray) to store the icicles for this view and its children.
	boolean	dispatchKeyEvent(KeyEvent event)
		Dispatch a key event to the next view on the focus path.
	void	dispatchThaw(SparseArray container)
		Called by thaw(SparseArray) to retrieve the icicles for this view and its children.
	boolean	dispatchTouchEvent(MotionEvent event)
		Pass the touch screen motion event down to the target view, or this view if it is the target.
	boolean	dispatchTrackballEvent(MotionEvent event)
		Pass a trackball motion event down to the focused view.
	boolean	dispatchUnhandledMove(View focused, int direction)
		This method is the last chance for the focused view and its ancestors to respond to an arrow key.
	void	dispatchWindowFocusChanged(boolean hasFocus)
		Called when the window containing this view gains or loses window focus.
	void	dispatchWindowVisibilityChanged(int visibility)
		Dispatch a window visibility change down the view hierarchy.
	void	draw(Canvas canvas)
		Manually render this view (and all of its children) to the given Canvas.
	void	drawableStateChanged()
		This function is called whenever the state of the view changes in such a way that it impacts the state of drawables being shown.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
	View	findFocus()
		Find the view in the hierarchy rooted at this view that currently has focus.
final	View	findViewById(int id)
		Look for a child view with the given id.
final	View	findViewWithTag(Object tag)
		Look for a child view with the given tag.
	View	focusSearch(int direction)
		Find the nearest view in the specified direction that can take focus.
	void	freeze(SparseArray container)
		Store this view hierarchy's frozen state into the given container.
	void	getAbsoluteLocationOnScreen(int[] location)
		Computes the coordinates of this view on the screen.
	Animation	getAnimation()
		Get the animation currently associated with this view.
	Drawable	getBackground()
		Gets the background drawable
	int	getBaseline()
		Return the offset of the widget's text baseline from the widget's top boundary.
	boolean	getBlockDescendantFocus()
		Indicated if this view will block its descendants from receiving or requesting focus.
	boolean	getBlockUnmatchedKeyUps()
		Indicates whether this view will receive key up events for which it did not receive the corresponding key down.
final	int	getBottom()
		Bottom position of this view relative to its parent.
	float	getBottomFadingEdgeStrength()
		Returns the strength, or intensity, of the bottom faded edge.
final	Context	getContext()
		Returns the context the view is running in, through which it can access the current theme, resources, etc.
	Object	getContextMenuInfo()
		Views should implement this if they have extra information to associate with the context menu.
	int	getDefaultSize(int size, int measureSpec)
		Utility to return a default size.
final	int[]	getDrawableState()
		Return an array of resource IDs of the drawable states representing the current state of the view.
	Bitmap	getDrawingCache()
		Returns the bitmap in which this view drawing is cached.
	int	getDrawingCacheQuality()
		Returns the quality of the drawing cache.
	void	getDrawingRect(Rect outRect)
		Return the visible drawing bounds of your view.
	long	getDrawingTime()
		Return the time at which the drawing of the view hierarchy started.
	int	getFocusType()
		Gets the conditions under which this view will take focus.
	ArrayList	getFocusables()
		Find and return all focusable views that are descendants of this view, possibly including this view if it is focusable itself.
	void	getFocusedRect(Rect r)
		When a view has focus and the user navigates away from it, the next view is searched for starting from the rectangle filled in by this method.
	boolean	getGlobalVisibleRect(Rect r, Point globalOffset)
		If some part of this view is not clipped by any of its parents, then return that area in r in global (root) coordinates.
final	boolean	getGlobalVisibleRect(Rect r)
	Handler	getHandler()