Android - An Open Handset Alliance Project

android.widget
public class

android.widget.Gallery

java.lang.Object
	android.view.View				Drawable.Callback KeyEvent.Callback
		android.view.ViewGroup			ViewManager ViewParent
			android.widget.AdapterView
				android.widget.Gallery

A view that shows items in a center-locked, horizontally scrolling list. The items in the gallery come from the GalleryAdapter associated with this view.

Nested Classes

Gallery.LayoutParams Gallery extends LayoutParams to provide a place to hold current Transformation information along with previous position/transformation info.

Summary

XML Attributes

Attribute name	Related methods
android:animationDuration	setAnimationDuration(int)	Sets how long a transition animation should run (in milliseconds) when layout has changed.
android:drawSelectorOnTop	setDrawSelectorOnTop(boolean)
android:gravity	setGravity(int)	Specifies how to place an object, both its x and y axis, within a larger containing object.
android:spacing	setSpacing(int)
android:spinnerSelector	setSelectorSkin(Drawable)

XML Attributes inherited from class android.view.ViewGroup

android:clipChildren, android:clipToPadding

Attribute name	Related methods
android:clipChildren	setClipChildren(boolean)	Defines whether a child is limited to draw inside of its bounds or not.
android:clipToPadding	setClipToPadding(boolean)	Defines whether the ViewGroup will clip its drawing surface so as to exclude the padding area.

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.widget.AdapterView

			Value
int	SYNC_FIRST_POSITION	Sync based on the first row	1	0x00000001
int	SYNC_MAX_DURATION_MILLIS	Maximum amount of time to spend in findSyncPosition()	100	0x00000064
int	SYNC_SELECTED_POSITION	Sync based on the selected row	0	0x00000000

Constants inherited from class android.view.ViewGroup

FLAG_SUPPORT_STATIC_TRANSFORMATIONS, PERSISTENT_ALL_CACHES, PERSISTENT_ANIMATION_CACHE, PERSISTENT_NO_CACHE, PERSISTENT_SCROLLING_CACHE

			Value
int	FLAG_SUPPORT_STATIC_TRANSFORMATIONS	When set, this ViewGroup supports static transformations on children; this causes getChildStaticTransformation(View, android.view.animation.Transformation) to be invoked when a child is drawn.	2048	0x00000800
int	PERSISTENT_ALL_CACHES	Used to indicate that all drawing caches should be kept in memory.	3	0x00000003
int	PERSISTENT_ANIMATION_CACHE	Used to indicate that the animation drawing cache should be kept in memory.	1	0x00000001
int	PERSISTENT_NO_CACHE	Used to indicate that no drawing cache should be kept in memory.	0	0x00000000
int	PERSISTENT_SCROLLING_CACHE	Used to indicate that the scrolling drawing cache should be kept in memory.	2	0x00000002

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

protected	SpinnerAdapter	mAdapter
protected	Boolean	mAllowWrap
protected	boolean	mBlockLayoutRequests
protected	boolean	mDrawSelectorOnTop
protected	int	mGravity
protected	int	mHeightMeasureSpec
protected	Interpolator	mInterpolator
protected	int	mOldSelectedPosition
protected	boolean	mPerformItemClickOnCenterKey	Whether to performItemClick when the center/enter key is pushed.
protected	RecycleBin	mRecycler
protected	View	mSelectedView
protected	int	mSelectionBottomPadding
protected	int	mSelectionLeftPadding
protected	int	mSelectionRightPadding
protected	int	mSelectionTopPadding
protected	Drawable	mSelector
protected	Rect	mSelectorRect
protected	Rect	mSpinnerPadding
protected	int	mWidthMeasureSpec

Fields inherited from class android.widget.AdapterView

protected	boolean	mDataChanged	True if the data has changed since the last layout
protected	View	mEmptyView	View to show if there is nothing in the list
protected	int	mFirstPosition	The position of the first child displayed
protected	boolean	mInLayout
protected	int	mItemCount
protected	boolean	mNeedSync	True if we need to sync to mSyncRowId
protected	int	mNextSelectedPosition	The index within the adapter's data set of the item to select during the next layout.
protected	long	mNextSelectedRowId	The item id of the item to select during the next layout.
protected	OnItemClickListener	mOnItemClickListener
protected	OnItemLongClickListener	mOnItemLongClickListener
protected	OnItemSelectedListener	mOnItemSelectedListener
protected	int	mSelectedPosition	The index within the adapter's data set of the currently selected item.
protected	long	mSelectedRowId	The item id of the currently selected item.
protected	int	mSpecificTop	The offset in pixels form the top of the AdapterView to the top of the view to select during the next layout.
protected	int	mSyncMode	Indicates whether to sync based on the selection or position
protected	int	mSyncPosition	Position from which to start looking for mSyncRowId
protected	long	mSyncRowId	Row id to look for when data has changed

Fields inherited from class android.view.ViewGroup

mDisappearingChildren, mGroupFlags, mOnHierarchyChangeListener, mPersistentDrawingCache

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

					Gallery(Context context)

					Gallery(Context context, AttributeSet attrs, Map inflateParams)

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

Public Methods

				void	dispatchWindowFocusChanged(boolean hasFocus)
					Called when the window containing this view gains or loses window focus.
				void	draw(Canvas canvas)
					Override to handle drawing the selector
				LayoutParams	generateLayoutParams(AttributeSet attrs)

				SpinnerAdapter	getAdapter()
				Boolean	getAllowWrap()
				int	getCount()
				View	getSelectedView()
				boolean	onKeyDown(int keyCode, KeyEvent event)
					Handles left, right, and clicking
				boolean	onKeyUp(int keyCode, KeyEvent event)
					Default implementation of KeyEvent.Callback.onKeyMultiple(): perform clicking of the view when KEYCODE_DPAD_CENTER or KEYCODE_NEWLINE is released.
				boolean	onTouchEvent(MotionEvent event)
					Implement this method to handle touch screen motion events.
				void	onWindowFocusChanged(boolean hasWindowFocus)
					Called when the window containing this view gains or loses focus.
				int	pointToPosition(int x, int y)
					Maps a point to a position in the list.
				void	requestLayout()
					Override to prevent spamming ourselves with layout requests as we place views
				void	setAdapter(SpinnerAdapter adapter)
					The Adapter is used to provide the data which backs this Spinner.
				void	setAllowWrap(Boolean allowWrap)
				void	setAnimateNextLayout(boolean animate)
					Controls whether the children of this view will animate the next time they go through layout.
				void	setAnimationDuration(int animationDurationMillis)
					Sets how long the transition animation should run when a chid view changes position.
				void	setDrawSelectorOnTop(boolean onTop)
					Indicates whether to draw the selector before or after drawing our children
				void	setGravity(int gravity)
					Describes how the child views are aligned.
				void	setScrollIndicators(View left, View right)
					Set the views that will be used to indicate that the gallery can be scrolled left or right
				void	setSelection(int position, boolean animate)
					Jump directly to a specific item in the adapter data.
				void	setSelection(int position)
					Sets the currently selected item
				void	setSelectorSkin(Drawable sel)
					Sets a drawable to put around the selected item
				void	setSpacing(int spacing)
					Sets the spacing between items in a Gallery
				boolean	verifyDrawable(Drawable dr)
					If your view subclass is displaying its own Drawable objects, it should override this function and return true for any Drawable it is displaying.

Protected Methods

				void	checkSelectionChanged()
				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.
				int[]	createSelectorState(int extraSpace)
				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.
				int	getChildHeight(View child)
				boolean	getChildStaticTransformation(View child, Transformation t)
					When a gallery draws, some of its children may be permanently transformed.
				int	getChildWidth(View child)
				LayoutParams	getDefaultLayoutParams()
				int[]	getSelectorState(int extraSpace)
				void	handleDataChanged()
				void	layout(int delta, boolean animate)
					Creates and positions all views for this Gallery.
				boolean	moveNext()
				boolean	movePrevious()
				int[]	onCreateDrawableState(int extraSpace)
					Generate the new Drawable state for this view.
				void	onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect)
					Called by the view system when the focus state of this view changes.
				void	onLayout(boolean changed, int l, int t, int r, int b)
					Called from layout when this view should assign a size and position to each of its children.
				void	onMeasure(int widthMeasureSpec, int heightMeasureSpec)
					Measure the view and its content to determine the measured width and the measured height.
				void	positionSelector(int l, int t, int r, int b)
					Utility to setup mSelectorRect
				void	recycleAllViews()
				void	resetList()
					Clear out all children from the list
				void	setSelectionInt(int position, boolean animate)
					Makes the item at the supplied position selected.
				void	updateScrollIndicators()
					Make the state of the scroll indicators match the state of the selection
				void	updateSelectorState()

			void	addView(View child, int index)
				Adds a child view that already has layout parameters set on it.
			void	addView(View child, LayoutParams params)
				Adds a child view with the specified layout parameters.
			void	addView(View child, int index, LayoutParams params)
				Adds a child view with the specified layout parameters.
			void	addView(View child)
				Adds a child view that already has layout parameters set on it.
			boolean	canAnimate()
				Indicates whether the view group has the ability to animate its children after the first layout.
			void	checkFocus()
			void	dispatchFreeze(SparseArray container)
				Override to prevent freezing of any views created by the adapter.
			void	dispatchThaw(SparseArray container)
				Override to prevent thawing of any views created by the adapter.
			int	findSyncPosition()
				Searches the adapter for a position matching mSyncRowId.
abstract			T	getAdapter()
			int	getCount()
			View	getEmptyView()
		final	OnItemClickListener	getOnItemClickListener()
		final	OnItemLongClickListener	getOnItemLongClickListener()
		final	OnItemSelectedListener	getOnItemSelectedListener()
	&n