Added in API level 1

ViewGroup.LayoutParams

Kotlin |Java

public static class ViewGroup.LayoutParams
extends Object

java.lang.Object
↳	android.view.ViewGroup.LayoutParams

Known direct subclasses

AbsListView.LayoutParams, AbsoluteLayout.LayoutParams, Gallery.LayoutParams, ViewGroup.MarginLayoutParams, WindowManager.LayoutParams

AbsListView.LayoutParams	AbsListView extends LayoutParams to provide a place to hold the view type.
AbsoluteLayout.LayoutParams	Per-child layout information associated with AbsoluteLayout.
Gallery.LayoutParams	Gallery extends LayoutParams to provide a place to hold current Transformation information along with previous position/transformation info.
ViewGroup.MarginLayoutParams	Per-child layout information for layouts that support margins.
WindowManager.LayoutParams

Known indirect subclasses

ActionBar.LayoutParams, ActionMenuView.LayoutParams, FrameLayout.LayoutParams, GridLayout.LayoutParams, LinearLayout.LayoutParams, RadioGroup.LayoutParams, RelativeLayout.LayoutParams, TableLayout.LayoutParams, TableRow.LayoutParams, Toolbar.LayoutParams

ActionBar.LayoutParams	Per-child layout information associated with action bar custom views.
ActionMenuView.LayoutParams
FrameLayout.LayoutParams	Per-child layout information for layouts that support margins.
GridLayout.LayoutParams	Layout information associated with each of the children of a GridLayout.
LinearLayout.LayoutParams	Per-child layout information associated with ViewLinearLayout.
RadioGroup.LayoutParams	This set of layout parameters defaults the width and the height of the children to `ViewGroup.LayoutParams.WRAP_CONTENT` when they are not specified in the XML file.
RelativeLayout.LayoutParams	Specifies how a view is positioned within a `RelativeLayout`.
TableLayout.LayoutParams	This set of layout parameters enforces the width of each child to be `ViewGroup.LayoutParams.MATCH_PARENT` and the height of each child to be `ViewGroup.LayoutParams.WRAP_CONTENT`, but only if the height is not specified.
TableRow.LayoutParams	Set of layout parameters used in table rows.
Toolbar.LayoutParams	Layout information for child views of Toolbars.

LayoutParams are used by views to tell their parents how they want to be laid out. See ViewGroup Layout Attributes for a list of all child view attributes that this class supports.

The base LayoutParams class just describes how big the view wants to be for both width and height. For each dimension, it can specify one of:

FILL_PARENT (renamed MATCH_PARENT in API Level 8 and higher), which means that the view wants to be as big as its parent (minus padding)
WRAP_CONTENT, which means that the view wants to be just big enough to enclose its content (plus padding)
an exact number

There are subclasses of LayoutParams for different subclasses of ViewGroup. For example, AbsoluteLayout has its own subclass of LayoutParams which adds an X and Y value.

Developer Guides

For more information about creating user interface layouts, read the XML Layouts developer guide.

Summary

XML attributes
`android:layout_height`	Specifies the basic height of the view.
`android:layout_width`	Specifies the basic width of the view.

Constants
`int`	`FILL_PARENT` Special value for the height or width requested by a View.
`int`	`MATCH_PARENT` Special value for the height or width requested by a View.
`int`	`WRAP_CONTENT` Special value for the height or width requested by a View.

Fields
`public int`	`height` Information about how tall the view wants to be.
`public LayoutAnimationController.AnimationParameters`	`layoutAnimationParameters` Used to animate layouts.
`public int`	`width` Information about how wide the view wants to be.

Public constructors
`LayoutParams(Context c, AttributeSet attrs)` Creates a new set of layout parameters.
`LayoutParams(int width, int height)` Creates a new set of layout parameters with the specified width and height.
`LayoutParams(ViewGroup.LayoutParams source)` Copy constructor.

Public methods
`void`	`resolveLayoutDirection(int layoutDirection)` Resolve layout parameters depending on the layout direction.

Protected methods
`void`	`setBaseAttributes(TypedArray a, int widthAttr, int heightAttr)` Extracts the layout parameters from the supplied attributes.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

XML attributes

android:layout_height

Specifies the basic height of the view. This is a required attribute for any view inside of a containing layout manager. Its value may be a dimension (such as "12dip") for a constant height or one of the special constants.

May be a dimension value, which is a floating point number appended with a unit such as "14.5sp". Available units are: px (pixels), dp (density-independent pixels), sp (scaled pixels based on preferred font size), in (inches), and mm (millimeters).

Must be one of the following constant values.

Constant	Value	Description
fill_parent	ffffffff	The view should be as big as its parent (minus padding). This constant is deprecated starting from API Level 8 and is replaced by `match_parent`.
match_parent	ffffffff	The view should be as big as its parent (minus padding). Introduced in API Level 8.
wrap_content	fffffffe	The view should be only big enough to enclose its content (plus padding).

android:layout_width

Specifies the basic width of the view. This is a required attribute for any view inside of a containing layout manager. Its value may be a dimension (such as "12dip") for a constant width or one of the special constants.

Must be one of the following constant values.

Constant	Value	Description
fill_parent	ffffffff	The view should be as big as its parent (minus padding). This constant is deprecated starting from API Level 8 and is replaced by `match_parent`.
match_parent	ffffffff	The view should be as big as its parent (minus padding). Introduced in API Level 8.
wrap_content	fffffffe	The view should be only big enough to enclose its content (plus padding).

Constants

FILL_PARENT

Added in API level 1
Deprecated in API level 15

public static final int FILL_PARENT

Special value for the height or width requested by a View. FILL_PARENT means that the view wants to be as big as its parent, minus the parent's padding, if any. This value is deprecated starting in API Level 8 and replaced by MATCH_PARENT.

Constant Value: -1 (0xffffffff)

MATCH_PARENT

Added in API level 8

public static final int MATCH_PARENT

Special value for the height or width requested by a View. MATCH_PARENT means that the view wants to be as big as its parent, minus the parent's padding, if any. Introduced in API Level 8.

Constant Value: -1 (0xffffffff)

WRAP_CONTENT

Added in API level 1

public static final int WRAP_CONTENT

Special value for the height or width requested by a View. WRAP_CONTENT means that the view wants to be just large enough to fit its own internal content, taking its own padding into account.

Constant Value: -2 (0xfffffffe)

Fields

height

Added in API level 1

public int height

Information about how tall the view wants to be. Can be one of the constants FILL_PARENT (replaced by MATCH_PARENT in API Level 8) or WRAP_CONTENT, or an exact size.

layoutAnimationParameters

Added in API level 1

public LayoutAnimationController.AnimationParameters layoutAnimationParameters

Used to animate layouts.

width

Added in API level 1

public int width

Information about how wide the view wants to be. Can be one of the constants FILL_PARENT (replaced by MATCH_PARENT in API Level 8) or WRAP_CONTENT, or an exact size.

Public constructors

LayoutParams

Added in API level 1

public LayoutParams (Context c, 
                AttributeSet attrs)

Creates a new set of layout parameters. The values are extracted from the supplied attributes set and context. The XML attributes mapped to this set of layout parameters are:

layout_width: the width, either an exact value, WRAP_CONTENT, or FILL_PARENT (replaced by MATCH_PARENT in API Level 8)
layout_height: the height, either an exact value, WRAP_CONTENT, or FILL_PARENT (replaced by MATCH_PARENT in API Level 8)

Parameters
`c`	`Context`: the application environment
`attrs`	`AttributeSet`: the set of attributes from which to extract the layout parameters' values

LayoutParams

Added in API level 1

public LayoutParams (int width, 
                int height)

Creates a new set of layout parameters with the specified width and height.

Parameters
`width`	`int`: the width, either `WRAP_CONTENT`, `FILL_PARENT` (replaced by `MATCH_PARENT` in API Level 8), or a fixed size in pixels
`height`	`int`: the height, either `WRAP_CONTENT`, `FILL_PARENT` (replaced by `MATCH_PARENT` in API Level 8), or a fixed size in pixels

LayoutParams

Added in API level 1

public LayoutParams (ViewGroup.LayoutParams source)

Copy constructor. Clones the width and height values of the source.

Parameters
`source`	`ViewGroup.LayoutParams`: The layout params to copy from.

Public methods

resolveLayoutDirection

Added in API level 17

public void resolveLayoutDirection (int layoutDirection)

Resolve layout parameters depending on the layout direction. Subclasses that care about layoutDirection changes should override this method. The default implementation does nothing.

Parameters
`layoutDirection`	`int`: the direction of the layout `View#LAYOUT_DIRECTION_LTR` `View#LAYOUT_DIRECTION_RTL`

Protected methods

setBaseAttributes

Added in API level 1

protected void setBaseAttributes (TypedArray a, 
                int widthAttr, 
                int heightAttr)

Extracts the layout parameters from the supplied attributes.

Parameters
`a`	`TypedArray`: the style attributes to extract the parameters from
`widthAttr`	`int`: the identifier of the width attribute
`heightAttr`	`int`: the identifier of the height attribute