Skip to content

Most visited

Recently visited

navigation
Added in API level 1

ViewGroup.MarginLayoutParams

public static class ViewGroup.MarginLayoutParams
extends ViewGroup.LayoutParams

java.lang.Object
   ↳ android.view.ViewGroup.LayoutParams
     ↳ android.view.ViewGroup.MarginLayoutParams
Known Direct Subclasses
Known Indirect Subclasses


Per-child layout information for layouts that support margins. See ViewGroup Margin Layout Attributes for a list of all child view attributes that this class supports.

Summary

XML attributes

android:layout_marginBottom Specifies extra space on the bottom side of this view. 
android:layout_marginEnd Specifies extra space on the end side of this view. 
android:layout_marginLeft Specifies extra space on the left side of this view. 
android:layout_marginRight Specifies extra space on the right side of this view. 
android:layout_marginStart Specifies extra space on the start side of this view. 
android:layout_marginTop Specifies extra space on the top side of this view. 

Inherited XML attributes

From class android.view.ViewGroup.LayoutParams

Inherited constants

From class android.view.ViewGroup.LayoutParams

Fields

public int bottomMargin

The bottom margin in pixels of the child.

public int leftMargin

The left margin in pixels of the child.

public int rightMargin

The right margin in pixels of the child.

public int topMargin

The top margin in pixels of the child.

Inherited fields

From class android.view.ViewGroup.LayoutParams

Public constructors

ViewGroup.MarginLayoutParams(Context c, AttributeSet attrs)

Creates a new set of layout parameters.

ViewGroup.MarginLayoutParams(int width, int height)

ViewGroup.MarginLayoutParams(ViewGroup.MarginLayoutParams source)

Copy constructor.

ViewGroup.MarginLayoutParams(ViewGroup.LayoutParams source)

Public methods

int getLayoutDirection()

Retuns the layout direction.

int getMarginEnd()

Returns the end margin in pixels.

int getMarginStart()

Returns the start margin in pixels.

boolean isMarginRelative()

Check if margins are relative.

void resolveLayoutDirection(int layoutDirection)

This will be called by requestLayout().

void setLayoutDirection(int layoutDirection)

Set the layout direction

void setMarginEnd(int end)

Sets the relative end margin.

void setMarginStart(int start)

Sets the relative start margin.

void setMargins(int left, int top, int right, int bottom)

Sets the margins, in pixels.

Inherited methods

From class android.view.ViewGroup.LayoutParams
From class java.lang.Object

XML attributes

android:layout_marginBottom

Specifies extra space on the bottom side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginBottom.

Related methods:

android:layout_marginEnd

Specifies extra space on the end side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginEnd.

Related methods:

android:layout_marginLeft

Specifies extra space on the left side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginLeft.

Related methods:

android:layout_marginRight

Specifies extra space on the right side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginRight.

Related methods:

android:layout_marginStart

Specifies extra space on the start side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginStart.

Related methods:

android:layout_marginTop

Specifies extra space on the top side of this view. This space is outside this view's bounds. Margin values should be positive.

Must 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), mm (millimeters).

This may also be a reference to a resource (in the form "@[package:]type:name") or theme attribute (in the form "?[package:][type:]name") containing a value of this type.

This corresponds to the global attribute resource symbol layout_marginTop.

Related methods:

Fields

bottomMargin

Added in API level 1
int bottomMargin

The bottom margin in pixels of the child. Margin values should be positive. Call setLayoutParams(LayoutParams) after reassigning a new value to this field.

leftMargin

Added in API level 1
int leftMargin

The left margin in pixels of the child. Margin values should be positive. Call setLayoutParams(LayoutParams) after reassigning a new value to this field.

rightMargin

Added in API level 1
int rightMargin

The right margin in pixels of the child. Margin values should be positive. Call setLayoutParams(LayoutParams) after reassigning a new value to this field.

topMargin

Added in API level 1
int topMargin

The top margin in pixels of the child. Margin values should be positive. Call setLayoutParams(LayoutParams) after reassigning a new value to this field.

Public constructors

ViewGroup.MarginLayoutParams

Added in API level 1
ViewGroup.MarginLayoutParams (Context c, 
                AttributeSet attrs)

Creates a new set of layout parameters. The values are extracted from the supplied attributes set and context.

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

ViewGroup.MarginLayoutParams

Added in API level 1
ViewGroup.MarginLayoutParams (int width, 
                int height)

Parameters
width int
height int

ViewGroup.MarginLayoutParams

Added in API level 1
ViewGroup.MarginLayoutParams (ViewGroup.MarginLayoutParams source)

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

Parameters
source ViewGroup.MarginLayoutParams: The layout params to copy from.

ViewGroup.MarginLayoutParams

Added in API level 1
ViewGroup.MarginLayoutParams (ViewGroup.LayoutParams source)

Parameters
source ViewGroup.LayoutParams

Public methods

getLayoutDirection

Added in API level 17
int getLayoutDirection ()

Retuns the layout direction. Can be either LAYOUT_DIRECTION_LTR or LAYOUT_DIRECTION_RTL.

Returns
int the layout direction.

getMarginEnd

Added in API level 17
int getMarginEnd ()

Returns the end margin in pixels.

Related XML Attributes:

Returns
int the end margin in pixels.

getMarginStart

Added in API level 17
int getMarginStart ()

Returns the start margin in pixels.

Related XML Attributes:

Returns
int the start margin in pixels.

isMarginRelative

Added in API level 17
boolean isMarginRelative ()

Check if margins are relative.

Related XML Attributes:

Returns
boolean true if either marginStart or marginEnd has been set.

resolveLayoutDirection

Added in API level 17
void resolveLayoutDirection (int layoutDirection)

This will be called by requestLayout(). Left and Right margins may be overridden depending on layout direction.

Parameters
layoutDirection int: the direction of the layout LAYOUT_DIRECTION_LTR LAYOUT_DIRECTION_RTL

setLayoutDirection

Added in API level 17
void setLayoutDirection (int layoutDirection)

Set the layout direction

Parameters
layoutDirection int: the layout direction. Should be either LAYOUT_DIRECTION_LTR or LAYOUT_DIRECTION_RTL.

setMarginEnd

Added in API level 17
void setMarginEnd (int end)

Sets the relative end margin. Margin values should be positive.

Related XML Attributes:

Parameters
end int: the end margin size

setMarginStart

Added in API level 17
void setMarginStart (int start)

Sets the relative start margin. Margin values should be positive.

Related XML Attributes:

Parameters
start int: the start margin size

setMargins

Added in API level 1
void setMargins (int left, 
                int top, 
                int right, 
                int bottom)

Sets the margins, in pixels. A call to requestLayout() needs to be done so that the new margins are taken into account. Left and right margins may be overriden by requestLayout() depending on layout direction. Margin values should be positive.

Related XML Attributes:

Parameters
left int: the left margin size
top int: the top margin size
right int: the right margin size
bottom int: the bottom margin size
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.