天天看点

ViewGroup.LayoutParams

Class Overview(类概述)

LayoutParams 是 views 用来告诉它的父容器,它们在父容器中是如何摆放的。参考 ViewGroup Layout Attribute ,列举了该类支持的所有子 view 的属性。

LayoutParams 基类仅仅描述了 view 对宽度和高度的要求。对于每个方面,可以选择以下的一个:

  • FILL_PARENT :意味着 view 要设置成与它的父容器一样大(减去 padding 值)
  • WRAP_CONTENT:意味着 view 要大到足以包围它的内容(加上 padding 值)
  • 一个确定的数字

因为 ViewGroup 有不同的子类,所以 LayoutParams 也有不同的子类。例如,AbsoluteLayout 有它自己的可以设置 X 和 Y 的值的 LayoutParams 的子类。

Developer Guides(开发者指导)

关于创建用户界面布局的更多信息,请阅读 XML Layout 开发者指导。

XML Attributes(XML 属性)

android:layout_height

指定 view 的基本高度。对于包含布局管理器的任何 View,这是必需的属性。它的值可能是一个固定高度的尺寸值(如『12dp』)或是专用常量之一。

如果是一个尺寸值,它是一个浮点数字加上一个单位如『14.5sp』。可选的单位有:px(pixels 象素),dp(density-independent pixels 密度独立象素),sp(scaled pixels based on perferred font size 基于优选字体大小的缩放像素『一般用于设置字体大小』),mm(millimeters 毫米)。

这也可能是对包含该类型值的资源或主题属性的引用。

可以是以下常量值之一:

Constant(常量) Value(值) Description(描述)
fill_parent -1 该 view 该被设置成与它的父容器一样大(减去 apdding 值)。在 API 8 之后这个常量被 mathc_parent 代替。
match_parent -1 该 view 该被设置成与它的父容器一样大(减去 padding 值)。在 API 8 里有介绍。
wrap_content -1 该 view 要大到足以包围它的内容(加上 padding 值)

这相当于全局属性资源符号layout_height。

android:layout_width

指定 view 的基本宽度。对于包含布局管理器的任何 View,这是必需的属性。它的值可能是一个固定宽度的尺寸值(如『12dp』)或是专用常量之一。

如果是一个尺寸值,它是一个浮点数字加上一个单位如『14.5sp』。可选的单位有:px(pixels 象素),dp(density-independent pixels 密度独立象素),sp(scaled pixels based on perferred font size 基于优选字体大小的缩放像素『一般用于设置字体大小』),mm(millimeters 毫米)。

这也可能是对包含该类型值的资源或主题属性的引用。

可以是以下常量值之一:

Constant(常量) Value(值) Description(描述)
fill_parent -1 该 view 该被设置成与它的父容器一样大(减去 apdding 值)。在 API 8 之后这个常量被 mathc_parent 代替。
match_parent -1 该 view 该被设置成与它的父容器一样大(减去 padding 值)。在 API 8 里有介绍。
wrap_content -1 该 view 要大到足以包围它的内容(加上 padding 值)

这相当于全局属性资源符号layout_width。

Constants(常量)

public static final int FILL_PARENT

View 所要求的高度或宽度的特殊值。FILL_PARENT 意味着 view 要设置成与它的父容器一样大,如果父容器有 padding 值,减去父容器的 padding 值。在 API 8 之后,这个值被 MAHCH_PARENT 代替。

常量的值为:-1(十六进制:0xffffffff)

public static final int MATCH_PARENT

View 所要求的高度或宽度的特殊值。FILL_PARENT 意味着 view 要设置成与它的父容器一样大,如果父容器有 padding 值,减去父容器的 padding 值。在 API 8 里有介绍。

常量的值为:-1(十六进制:0xffffffff)

public static final int WRAP_CONTENT

View 所要求的高度或宽度的特殊值。WRAP_CONTETN 意味着 view 要大到足以包围它的内容,把它自己的 padding 也计算进去。

常量值为:-2(十六进制:0xfffffffe)

Fields(字段)

public int height

view 被设置的高度。可以是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替) 或是 WRAP_CONTENT 常量之一,或是一个具体的大小。

public LayoutAnimationController.AnimationParameters

用在动画布局。

public int width

View 被设置的宽度。可以是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替) 或是 WRAP_CONTENT 常量之一,或是一个具体的大小。

Public Constructors(公共构造方法)

public ViewGroup.LayoutParams(Context c ,AttributeSet attrs)

创建一个新的布局参数集合。这些值是从提供的属性集和 context 中提取的。映射到这组布局参数的XML属性是:

  • layout_width:宽度,可以是一个精确的值,或 WRAP_CONTENT,或是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替)
  • layout_height:高度,可以是一个精确的值,或 WRAP_CONTENT,或是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替)

参数

c 应用的环境

attrs 来自于布局参数值的属性集合

public ViewGruop.LayoutParams(int width,int height)

创建一个指定宽高的布局参数的集合。

参数

width 宽度,可以是一个精确的值,或 WRAP_CONTENT,或是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替)

height 高度,可以是一个精确的值,或 WRAP_CONTENT,或是 FILL_PARENT(在 API 8 之后被 MATCH_PARENT 代替)

public ViewGruop.LayoutParams(ViewGruop.LayoutParams source)

复制构造器。克隆 source 的宽高值。

参数

source 布局参数要复制的值

Public Methods(公共方法)

public void resolveLayoutDirection(int layoutDircetion)

根据布局方向解析布局参数。关心布局方向的子类应该重写这个方法。默认实现什么也不做。

参数

layoutDircetion 布局的方向 LAYOUT_DIRECTION_LIR(从左到右) LAYOUT_DIRECTION_RTL (从右到左)

Protected Methods(被保护的方法)

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

从提供的属性里面提取布局参数。

参数

a 提供的属性的风格

widthAttr width 属性的标识符

heightAttr height 属性的标识符