android.widget
Class TableRow

java.lang.Object
  android.view.View
      android.view.ViewGroup
          android.widget.LinearLayout
              android.widget.TableRow

All Implemented Interfaces:

Drawable.Callback, KeyEvent.Callback, ViewManager, ViewParent

public class TableRow
extends LinearLayout

A layout that arranges its children horizontally. A TableRow should always be used as a child of a TableLayout. If a TableRow's parent is not a TableLayout, the TableRow will behave as an horizontal LinearLayout.

The children of a TableRow do not need to specify the layout_width and layout_height attributes in the XML file. TableRow always enforces those values to be respectively ViewGroup.LayoutParams.FILL_PARENT and ViewGroup.LayoutParams.WRAP_CONTENT.

Also see android.widget.TableRow.LayoutParams for layout attributes

Nested Class Summary

static class

TableRow.LayoutParams Set of layout parameters used in table rows.

Nested classes/interfaces inherited from class android.view.ViewGroup

ViewGroup.MarginLayoutParams, ViewGroup.OnHierarchyChangeListener

Nested classes/interfaces inherited from class android.view.View

View.BaseSavedState, View.MeasureSpec, View.OnClickListener, View.OnCreateContextMenuListener, View.OnFocusChangeListener, View.OnKeyListener, View.OnLongClickListener, View.OnTouchListener

Field Summary

Fields inherited from class android.widget.LinearLayout

HORIZONTAL, VERTICAL

Fields inherited from class android.view.ViewGroup

CLIP_TO_PADDING_MASK, FLAG_SUPPORT_STATIC_TRANSFORMATIONS, FLAG_USE_CHILD_DRAWING_ORDER, FOCUS_AFTER_DESCENDANTS, FOCUS_BEFORE_DESCENDANTS, FOCUS_BLOCK_DESCENDANTS, mDisappearingChildren, mGroupFlags, mOnHierarchyChangeListener, mPersistentDrawingCache, PERSISTENT_ALL_CACHES, PERSISTENT_ANIMATION_CACHE, PERSISTENT_NO_CACHE, PERSISTENT_SCROLLING_CACHE

Fields inherited from class android.view.View

DRAWING_CACHE_QUALITY_AUTO, DRAWING_CACHE_QUALITY_HIGH, DRAWING_CACHE_QUALITY_LOW, EMPTY_STATE_SET, ENABLED_FOCUSED_SELECTED_STATE_SET, ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_FOCUSED_STATE_SET, ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, ENABLED_SELECTED_STATE_SET, ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, ENABLED_STATE_SET, ENABLED_WINDOW_FOCUSED_STATE_SET, FIRST_STATE_SET, FOCUS_BACKWARD, FOCUS_DOWN, FOCUS_FORWARD, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_UP, FOCUSED_SELECTED_STATE_SET, FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, FOCUSED_STATE_SET, FOCUSED_WINDOW_FOCUSED_STATE_SET, GONE, INVISIBLE, KEEP_SCREEN_ON, LAST_STATE_SET, mBottom, mContext, mCurrentAnimation, MIDDLE_STATE_SET, mLayoutParams, mLeft, mLocation, mMeasuredHeight, mMeasuredWidth, mOnClickListener, mOnCreateContextMenuListener, mOnFocusChangeListener, mOnLongClickListener, mPaddingBottom, mPaddingLeft, mPaddingRight, mPaddingTop, mParent, mRight, mScrollX, mScrollY, mTag, mTop, NO_ID, PRESSED_ENABLED_FOCUSED_SELECTED_STATE_SET, PRESSED_ENABLED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_STATE_SET, PRESSED_ENABLED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_SELECTED_STATE_SET, PRESSED_ENABLED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_ENABLED_STATE_SET, PRESSED_ENABLED_WINDOW_FOCUSED_STATE_SET, PRESSED_FIRST_STATE_SET, PRESSED_FOCUSED_SELECTED_STATE_SET, PRESSED_FOCUSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_FOCUSED_STATE_SET, PRESSED_FOCUSED_WINDOW_FOCUSED_STATE_SET, PRESSED_LAST_STATE_SET, PRESSED_MIDDLE_STATE_SET, PRESSED_SELECTED_STATE_SET, PRESSED_SELECTED_WINDOW_FOCUSED_STATE_SET, PRESSED_SINGLE_STATE_SET, PRESSED_STATE_SET, PRESSED_WINDOW_FOCUSED_STATE_SET, SCROLLBARS_INSIDE_INSET, SCROLLBARS_INSIDE_OVERLAY, SCROLLBARS_OUTSIDE_INSET, SCROLLBARS_OUTSIDE_OVERLAY, SELECTED_STATE_SET, SELECTED_WINDOW_FOCUSED_STATE_SET, SINGLE_STATE_SET, SOUND_EFFECTS_ENABLED, VIEW_LOG_TAG, VISIBLE, WINDOW_FOCUSED_STATE_SET

Constructor Summary

TableRow(Context context)
Creates a new TableRow for the given context.

TableRow(Context context, AttributeSet attrs)
Creates a new TableRow for the given context and with the specified set attributes.

Method Summary

protected boolean	checkLayoutParams(ViewGroup.LayoutParams p)
protected LinearLayout.LayoutParams	generateDefaultLayoutParams() Returns a set of layout parameters with a width of ViewGroup.LayoutParams.FILL_PARENT, a height of ViewGroup.LayoutParams.WRAP_CONTENT and no spanning.
TableRow.LayoutParams	generateLayoutParams(AttributeSet attrs) Returns a new set of layout parameters based on the supplied attributes set.
protected LinearLayout.LayoutParams	generateLayoutParams(ViewGroup.LayoutParams p) Returns a safe set of layout parameters based on the supplied layout params.
(package private) int	getChildrenSkipCount(View child, int index) Returns the number of children to skip after measuring/laying out the specified child.
(package private) int[]	getColumnsWidths(int widthMeasureSpec) Measures the preferred width of each child, including its margins.
(package private) int	getLocationOffset(View child) Return the location offset of the specified child.
(package private) int	getNextLocationOffset(View child) Return the size offset of the next sibling of the specified child.
View	getVirtualChildAt(int i) Returns the view at the specified index.
int	getVirtualChildCount() Returns the virtual number of children.
(package private) void	measureChildBeforeLayout(View child, int childIndex, int widthMeasureSpec, int totalWidth, int heightMeasureSpec, int totalHeight) Measure the child according to the parent's measure specs.
(package private) int	measureNullChild(int childIndex) Returns the size (width or height) that should be occupied by a null child.
protected 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.
protected void	onMeasure(int widthMeasureSpec, int heightMeasureSpec) Measure the view and its content to determine the measured width and the measured height.
(package private) void	setColumnCollapsed(int columnIndex, boolean collapsed) Collapses or restores a given column.
(package private) void	setColumnsWidthConstraints(int[] columnWidths) Sets the width of all of the columns in this row.
void	setOnHierarchyChangeListener(ViewGroup.OnHierarchyChangeListener listener) Register a callback to be invoked when a child is added to or removed from this view.

Methods inherited from class android.widget.LinearLayout

getBaseline, getBaselineAlignedChildIndex, getOrientation, getWeightSum, isBaselineAligned, layoutHorizontal, layoutVertical, measureHorizontal, measureVertical, setBaselineAligned, setBaselineAlignedChildIndex, setGravity, setHorizontalGravity, setOrientation, setVerticalGravity, setWeightSum

Methods inherited from class android.view.ViewGroup

addFocusables, addStatesFromChildren, addTouchables, addView, addView, addView, addView, addView, addViewInLayout, addViewInLayout, attachLayoutAnimationParameters, attachViewToParent, bringChildToFront, canAnimate, childDrawableStateChanged, cleanupLayoutState, clearChildFocus, clearDisappearingChildren, clearFocus, debug, detachAllViewsFromParent, detachViewFromParent, detachViewFromParent, detachViewsFromParent, dispatchDraw, dispatchFreezeSelfOnly, dispatchKeyEvent, dispatchRestoreInstanceState, dispatchSaveInstanceState, dispatchSetPressed, dispatchSetSelected, dispatchThawSelfOnly, dispatchTouchEvent, dispatchTrackballEvent, dispatchUnhandledMove, dispatchWindowFocusChanged, dispatchWindowVisibilityChanged, drawableStateChanged, drawChild, findFocus, findViewTraversal, findViewWithTagTraversal, fitSystemWindows, focusableViewAvailable, focusSearch, gatherTransparentRegion, getChildAt, getChildCount, getChildDrawingOrder, getChildMeasureSpec, getChildStaticTransformation, getChildVisibleRect, getDescendantFocusability, getFocusedChild, getLayoutAnimation, getLayoutAnimationListener, getPersistentDrawingCache, hasFocus, hasFocusable, indexOfChild, invalidateChild, invalidateChildInParent, isAlwaysDrawnWithCacheEnabled, isAnimationCacheEnabled, isChildrenDrawnWithCacheEnabled, measureChild, measureChildren, measureChildWithMargins, offsetChildrenTopAndBottom, offsetDescendantRectToMyCoords, offsetRectIntoDescendantCoords, onAnimationEnd, onAnimationStart, onCreateDrawableState, onInterceptTouchEvent, onRequestFocusInDescendants, recomputeViewAttributes, removeAllViews, removeAllViewsInLayout, removeDetachedView, removeView, removeViewAt, removeViewInLayout, removeViews, removeViewsInLayout, requestChildFocus, requestChildRectangleOnScreen, requestDisallowInterceptTouchEvent, requestFocus, requestTransparentRegion, scheduleLayoutAnimation, setAddStatesFromChildren, setAlwaysDrawnWithCacheEnabled, setAnimationCacheEnabled, setChildrenDrawingCacheEnabled, setChildrenDrawnWithCacheEnabled, setClipChildren, setClipToPadding, setDescendantFocusability, setLayoutAnimation, setLayoutAnimationListener, setPadding, setPersistentDrawingCache, showContextMenuForChild, startLayoutAnimation, updateViewLayout

Methods inherited from class android.view.View

applyDrawableToTransparentRegion, bringToFront, buildDrawingCache, cancelLongPress, clearAnimation, computeHorizontalScrollExtent, computeHorizontalScrollOffset, computeHorizontalScrollRange, computeScroll, computeVerticalScrollExtent, computeVerticalScrollOffset, computeVerticalScrollRange, createContextMenu, debug, debugIndent, destroyDrawingCache, dispatchKeyShortcutEvent, draw, finalize, findViewById, findViewWithTag, focusSearch, forceLayout, getAnimation, getApplicationWindowToken, getBackground, getBottom, getBottomFadingEdgeStrength, getContext, getContextMenuInfo, getDefaultSize, getDrawableState, getDrawingCache, getDrawingCacheBackgroundColor, getDrawingCacheQuality, getDrawingRect, getDrawingTime, getFocusables, getFocusedRect, getGlobalVisibleRect, getGlobalVisibleRect, getHandler, getHeight, getHitRect, getHorizontalFadingEdgeLength, getHorizontalScrollbarHeight, getId, getKeepScreenOn, getLayoutParams, getLeft, getLeftFadingEdgeStrength, getLocalVisibleRect, getLocationInWindow, getLocationOnScreen, getMeasuredHeight, getMeasuredWidth, getNextFocusDownId, getNextFocusLeftId, getNextFocusRightId, getNextFocusUpId, getOnFocusChangeListener, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getParent, getResources, getRight, getRightFadingEdgeStrength, getRootView, getScrollBarStyle, getScrollX, getScrollY, getSolidColor, getSuggestedMinimumHeight, getSuggestedMinimumWidth, getTag, getTop, getTopFadingEdgeStrength, getTouchables, getTouchDelegate, getVerticalFadingEdgeLength, getVerticalScrollbarWidth, getViewTreeObserver, getVisibility, getWidth, getWindowAttachCount, getWindowToken, getWindowVisibility, hasWindowFocus, inflate, initializeFadingEdge, initializeScrollbars, invalidate, invalidate, invalidate, invalidateDrawable, isClickable, isDrawingCacheEnabled, isDuplicateParentStateEnabled, isEnabled, isFocusable, isFocusableInTouchMode, isFocused, isHorizontalFadingEdgeEnabled, isHorizontalScrollBarEnabled, isInTouchMode, isLayoutRequested, isLongClickable, isPressed, isRootNamespace, isSaveEnabled, isSelected, isShown, isSoundEffectsEnabled, isVerticalFadingEdgeEnabled, isVerticalScrollBarEnabled, layout, measure, mergeDrawableStates, offsetLeftAndRight, offsetTopAndBottom, onAttachedToWindow, onCreateContextMenu, onDetachedFromWindow, onDraw, onFinishInflate, onFocusChanged, onKeyDown, onKeyMultiple, onKeyShortcut, onKeyUp, onRestoreInstanceState, onSaveInstanceState, onScrollChanged, onSetAlpha, onSizeChanged, onTouchEvent, onTrackballEvent, onWindowFocusChanged, onWindowVisibilityChanged, performClick, performLongClick, playSoundEffect, post, postDelayed, postInvalidate, postInvalidate, postInvalidateDelayed, postInvalidateDelayed, refreshDrawableState, removeCallbacks, requestFocus, requestFocus, requestFocusFromTouch, requestLayout, requestRectangleOnScreen, requestRectangleOnScreen, resolveSize, restoreHierarchyState, saveHierarchyState, scheduleDrawable, scrollBy, scrollTo, setAnimation, setBackgroundColor, setBackgroundDrawable, setBackgroundResource, setClickable, setDrawingCacheBackgroundColor, setDrawingCacheEnabled, setDrawingCacheQuality, setDuplicateParentStateEnabled, setEnabled, setFadingEdgeLength, setFocusable, setFocusableInTouchMode, setFrame, setHorizontalFadingEdgeEnabled, setHorizontalScrollBarEnabled, setId, setIsRootNamespace, setKeepScreenOn, setLayoutParams, setLongClickable, setMeasuredDimension, setMinimumHeight, setMinimumWidth, setNextFocusDownId, setNextFocusLeftId, setNextFocusRightId, setNextFocusUpId, setOnClickListener, setOnCreateContextMenuListener, setOnFocusChangeListener, setOnKeyListener, setOnLongClickListener, setOnTouchListener, setPressed, setSaveEnabled, setScrollBarStyle, setSelected, setSoundEffectsEnabled, setTag, setTouchDelegate, setVerticalFadingEdgeEnabled, setVerticalScrollBarEnabled, setVisibility, setWillNotCacheDrawing, setWillNotDraw, showContextMenu, startAnimation, unscheduleDrawable, unscheduleDrawable, verifyDrawable, willNotCacheDrawing, willNotDraw

Methods inherited from class java.lang.Object

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

Methods inherited from interface android.view.ViewParent

createContextMenu, getParent, isLayoutRequested, requestLayout

Constructor Detail

TableRow

public TableRow(Context context)

Creates a new TableRow for the given context.

Parameters:

context - the application environment

TableRow

public TableRow(Context context,
                AttributeSet attrs)

Creates a new TableRow for the given context and with the specified set attributes.

Parameters:

context - the application environment

attrs - a collection of attributes

Method Detail

setOnHierarchyChangeListener

public void setOnHierarchyChangeListener(ViewGroup.OnHierarchyChangeListener listener)

Register a callback to be invoked when a child is added to or removed from this view.

Overrides:

setOnHierarchyChangeListener in class ViewGroup

Parameters:

listener - the callback to invoke on hierarchy change

setColumnCollapsed

void setColumnCollapsed(int columnIndex,
                        boolean collapsed)

Collapses or restores a given column.

Parameters:

columnIndex - the index of the column

collapsed - true if the column must be collapsed, false otherwise

onMeasure

protected void onMeasure(int widthMeasureSpec,
                         int heightMeasureSpec)

Measure the view and its content to determine the measured width and the measured height. This method is invoked by View.measure(int, int) and should be overriden by subclasses to provide accurate and efficient measurement of their contents.

CONTRACT: When overriding this method, you must call View.setMeasuredDimension(int, int) to store the measured width and height of this view. Failure to do so will trigger an IllegalStateException, thrown by View.measure(int, int). Calling the superclass' View.onMeasure(int, int) is a valid use.

The base class implementation of measure defaults to the background size, unless a larger size is allowed by the MeasureSpec. Subclasses should override View.onMeasure(int, int) to provide better measurements of their content.

If this method is overridden, it is the subclass's responsibility to make sure the measured height and width are at least the view's minimum height and width (View.getSuggestedMinimumHeight() and View.getSuggestedMinimumWidth()).

Overrides:

onMeasure in class LinearLayout

Parameters:

widthMeasureSpec - horizontal space requirements as imposed by the parent. The requirements are encoded with View.MeasureSpec.

heightMeasureSpec - vertical space requirements as imposed by the parent. The requirements are encoded with View.MeasureSpec.

See Also:

View.getMeasuredWidth(), View.getMeasuredHeight(), View.setMeasuredDimension(int, int), View.getSuggestedMinimumHeight(), View.getSuggestedMinimumWidth(), View.MeasureSpec.getMode(int), View.MeasureSpec.getSize(int)

onLayout

protected 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. Derived classes with children should override this method and call layout on each of their their children.

Overrides:

onLayout in class LinearLayout

Parameters:

changed - This is a new size or position for this view

l - Left position, relative to parent

t - Top position, relative to parent

r - Right position, relative to parent

b - Bottom position, relative to parent

getVirtualChildAt

public View getVirtualChildAt(int i)

Returns the view at the specified index. This method can be overriden to take into account virtual children. Refer to TableLayout and TableRow for an example.

Overrides:

getVirtualChildAt in class LinearLayout

Parameters:

i - the child's index

Returns:

the child at the specified index

getVirtualChildCount

public int getVirtualChildCount()

Returns the virtual number of children. This number might be different than the actual number of children if the layout can hold virtual children. Refer to TableLayout and TableRow for an example.

Overrides:

getVirtualChildCount in class LinearLayout

Returns:

the virtual number of children

measureNullChild

int measureNullChild(int childIndex)

Returns the size (width or height) that should be occupied by a null child.

Overrides:

measureNullChild in class LinearLayout

Parameters:

childIndex - the index of the null child

Returns:

the width or height of the child depending on the orientation

measureChildBeforeLayout

void measureChildBeforeLayout(View child,
                              int childIndex,
                              int widthMeasureSpec,
                              int totalWidth,
                              int heightMeasureSpec,
                              int totalHeight)

Measure the child according to the parent's measure specs. This method should be overriden by subclasses to force the sizing of children. This method is called by LinearLayout.measureVertical(int, int) and LinearLayout.measureHorizontal(int, int).

Overrides:

measureChildBeforeLayout in class LinearLayout

Parameters:

child - the child to measure

childIndex - the index of the child in this view

widthMeasureSpec - horizontal space requirements as imposed by the parent

totalWidth - extra space that has been used up by the parent horizontally

heightMeasureSpec - vertical space requirements as imposed by the parent

totalHeight - extra space that has been used up by the parent vertically

getChildrenSkipCount

int getChildrenSkipCount(View child,
                         int index)

Returns the number of children to skip after measuring/laying out the specified child.

Overrides:

getChildrenSkipCount in class LinearLayout

Parameters:

child - the child after which we want to skip children

index - the index of the child after which we want to skip children

Returns:

the number of children to skip, 0 by default

getLocationOffset

int getLocationOffset(View child)

Return the location offset of the specified child. This can be used by subclasses to change the location of a given widget.

Overrides:

getLocationOffset in class LinearLayout

Parameters:

child - the child for which to obtain the location offset

Returns:

the location offset in pixels

getNextLocationOffset

int getNextLocationOffset(View child)

Return the size offset of the next sibling of the specified child. This can be used by subclasses to change the location of the widget following child.

Overrides:

getNextLocationOffset in class LinearLayout

Parameters:

child - the child whose next sibling will be moved

Returns:

the location offset of the next child in pixels

getColumnsWidths

int[] getColumnsWidths(int widthMeasureSpec)

Measures the preferred width of each child, including its margins.

Parameters:

widthMeasureSpec - the width constraint imposed by our parent

Returns:

an array of integers corresponding to the width of each cell, or column, in this row

setColumnsWidthConstraints

void setColumnsWidthConstraints(int[] columnWidths)

Sets the width of all of the columns in this row. At layout time, this row sets a fixed width, as defined by columnWidths, on each child (or cell, or column.)

Parameters:

columnWidths - the fixed width of each column that this row must honor

Throws:

IllegalArgumentException - when columnWidths' length is smaller than the number of children in this row

generateLayoutParams

public TableRow.LayoutParams generateLayoutParams(AttributeSet attrs)

Returns a new set of layout parameters based on the supplied attributes set.

Overrides:

generateLayoutParams in class LinearLayout

Parameters:

attrs - the attributes to build the layout parameters from

Returns:

an instance of ViewGroup.LayoutParams or one of its descendants

generateDefaultLayoutParams

protected LinearLayout.LayoutParams generateDefaultLayoutParams()

Returns a set of layout parameters with a width of ViewGroup.LayoutParams.FILL_PARENT, a height of ViewGroup.LayoutParams.WRAP_CONTENT and no spanning.

Overrides:

generateDefaultLayoutParams in class LinearLayout

Returns:

a set of default layout parameters or null

checkLayoutParams

protected boolean checkLayoutParams(ViewGroup.LayoutParams p)

Overrides:

checkLayoutParams in class LinearLayout

generateLayoutParams

protected LinearLayout.LayoutParams generateLayoutParams(ViewGroup.LayoutParams p)

Returns a safe set of layout parameters based on the supplied layout params. When a ViewGroup is passed a View whose layout params do not pass the test of ViewGroup.checkLayoutParams(android.view.ViewGroup.LayoutParams), this method is invoked. This method should return a new set of layout params suitable for this ViewGroup, possibly by copying the appropriate attributes from the specified set of layout params.

Overrides:

generateLayoutParams in class LinearLayout

Parameters:

p - The layout parameters to convert into a suitable set of layout parameters for this ViewGroup.

Returns:

an instance of ViewGroup.LayoutParams or one of its descendants