©
Dokumen ini menggunakan Manual laman web PHP Cina Lepaskan
RelativeLayout
版本：Android 2.3 r1
结构
继承关系
public class RelativeLayout extends ViewGroup
java.lang.Object
android.view.View
android.view.ViewGroup
android.widget.RelativeLayout
子类及间接子类
直接子类
DialerFilter, TwoLineListItem
类概述
RelativeLayout顾名思义，相对布局，在这个容器内部的子元素们可以使用彼此之间的相对位置或者和容器间的相对位置来进行定位。
注意，不能在RelativeLayout容器本身和他的子元素之间产生循环依赖，比如说，不能将RelativeLayout的高设置成为WRAP_CONTENT的时候将子元素的高设置成为 ALIGN_PARENT_BOTTOM。
（译者注：这点额外要注意，当然这也很好理解，如果容器是不定高的，那么子元素当然无法对齐容器的底边^_^）。
可以参考官方SDK中的 RelativeLayout教学贴Relative Layout tutorial
常量
|
数据类型 |
常量名称 |
描述 |
|
int |
ABOVE |
定义将元素的底边对齐另一个元素的顶边 |
|
int |
ALIGN_BASELINE |
定义将元素基线的对齐另一个元素的基线 |
|
int |
ALIGN_BOTTOM |
定义将元素底边的对齐另一个元素的底边 |
|
int |
ALIGN_LEFT |
定义将元素的左边对齐另一个元素的左边 |
|
int |
ALIGN_PARENT_BOTTOM |
定义将元素的底边对齐其父容器(RelativeLayout)的底边 |
|
int |
ALIGN_PARENT_LEFT |
定义将元素的左边对齐其父容器(RelativeLayout)的左边 |
|
int |
ALIGN_PARENT_RIGHT |
定义将元素的右边对齐其父容器(RelativeLayout)的右边 |
|
int |
ALIGN_PARENT_TOP |
定义将元素的顶边对齐其父容器(RelativeLayout)的顶边 |
|
int |
ALIGN_RIGHT |
定义将元素的右边对齐另一个元素的右边 |
|
int |
ALIGN_TOP |
定义将元素的顶边对齐另一个元素的顶边 |
|
int |
BELOW |
定义将元素的顶边对齐另一个元素的底边 |
|
int |
CENTER_HORIZONTAL |
定义让元素在容器(RelativeLayout)内水平居中 |
|
int |
CENTER_IN_PARENT |
定义让元素位于容器(RelativeLayout)的中心 |
|
int |
CENTER_VERTICAL |
定义让元素在容器(RelativeLayout)内垂直居中 |
|
int |
LEFT_OF |
定义将元素的右边对齐另一个元素的左边 |
|
int |
RIGHT_OF |
定义将元素的左边对齐另一个元素的右边 |
|
int |
TRUE |
|
内部类
Class RelativeLayout.LayoutParams
和RelativeLayout相关联的布局信息.
XML属性
|
属性名称 |
描述 |
|
android:gravity |
设置容器中的内容该如何定位。对象本身的x和y轴。 |
|
android:ignoreGravity |
设置容器中的哪个子元素会不受Gravity的影响. （译者注：接收参数:子元素的Id,如果设置成为0，则全部子元素都会受到影响） |
公共方法
public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event)
分发 AccessibilityEvent 事件到该 View 的子视图中。
参数
event 事件本身.
返回值
如果事件分发完成，返回真。
public RelativeLayout.LayoutParams generateLayoutParams (AttributeSet attrs)
返回一个新的已设置属性集合的布局参数。
参数
attrs 构建layout布局参数的属性集合.
返回值
一个RelativeLayout.LayoutParams的实例或者他的一个子类
public int getBaseline ()
返回窗口空间的文本基准线到其顶边界的偏移量。如果这个部件不支持基准线对齐，这个方法返回-1。
返回值
基准线的偏移量，如果不支持基准线对齐则返回-1
public void requestLayout ()
当容器中的某个视图发生改变，会影响整个布局时，就调用这个方法，他会改变整个视图树的布局。
public void setGravity (int gravity)
描述子视图该如何摆放，默认值是Gravity.LEFT | Gravity.TOP（译者注：说明RelativeLayout的元素如果不设置位置，会从左上角开始堆叠）。
参数
gravity
位置值，可以参考Gravity
相关的XML属性
android:gravity
参见
setHorizontalGravity(int)
setVerticalGravity(int)
public void setHorizontalGravity (int horizontalGravity)
public void setVerticalGravity (int verticalGravity))
public void setIgnoreGravity (int viewId)
定义容器中的那个VIew会忽略容器设置的Gravity，如果容器设置的Gravity是Gravity.LEFT | Gravity.TOP时，定义这个属性没有任何效果。
参数
viewId 将要忽略容器Gravity的视图的id，设置为0则不会有任何View忽略Gravity.
相关的XML属性
android:ignoreGravity
参见
setGravity(int)
受保护方法
protected boolean checkLayoutParams (ViewGroup.LayoutParams p)
（译者注：检测是不是AbsoluteLayout.LayoutParams的实例）
protected ViewGroup.LayoutParams generateDefaultLayoutParams ()
返回一组宽度为WRAP_CONTENT,高度为WRAP_CONTENT,坐标是（0，0）的布局参数。
返回值
一组默认的布局参数或null值。
protected ViewGroup.LayoutParams generateDefaultLayoutParams ( ViewGroup .LayoutParams p)
返回一组合法的受支持的布局参数。当一个ViewGroup传递一个布局参数没有通过checkLayoutParams(android.view.ViewGroup.LayoutParams)检测的视图时，此方法被调用。此方法会返回一组新的适合当前ViewGroup的布局参数，可能从指定的一组布局参数中复制适当的属性。
参数
p 被转换成一组适合当前 ViewGroup的布局参数.
返回值
一个ViewGroup.LayoutParams的实例或者其中的一个子节点
protected void onLayout (boolean changed, int l, int t, int r, int b)
在此视图view给他的每一个子元素分配大小和位置时调用。 派生类可以重写此方法并且重新安排他们子类的布局。
参数
changed 这是当前视图view的一个新的大小或位置
l 相对于父节点的左边位置
t 相对于父节点的顶点位置
r 相对于父节点的右边位置
b 相对于父节点的底部位置
public void onMeasure (int widthMeasureSpec, int heightMeasureSpec)
测量视图以确定其内容宽度和高度。此方法被measure(int, int)调用。需要被子类重写以提供对其内容准确高效的测量。
约定：当重写此方法时，你必须调用setMeasuredDimension(int, int)来保存当前视图view的宽度和高度。不成功调用此方法将会导致一个IllegalStateException异常，是由measure(int, int)抛出。所以调用父类的onMeasure(int, int)方法是必须的。
父类的实现是以背景大小为默认大小，除非MeasureSpec（测量细则）允许更大的背景。子类可以重写onMeasure(int,int)以对其内容提供更佳的尺寸。
如果此方法被重写，那么子类的责任是确认测量高度和测量宽度要大于视图view的最小宽度和最小高度（getSuggestedMinimumHeight() and getSuggestedMinimumWidth()），使用这两个方法可以取得最小宽度和最小高度。
参数
widthMeasureSpec 强加于父节点的横向空间要求。要求是使用View.MeasureSpec进行编码。
heightMeasureSpec 强加于父节点的纵向空间要求。要求是使用View.MeasureSpec进行编码。
补充
文章精选
[Android学习指南] 相对布局 RelativeLayout
Android RelativeLayout 属性
RelativeLayout 排版 _ 免寫程式 [blogspot]
示例代码
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="fill_parent"
android:layout_height="fill_parent">
<TextView
android:id="@+id/label"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="Type here:"/>
<EditText
android:id="@+id/entry"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:background="@android:drawable/editbox_background"
android:layout_below="@id/label"/>
<Button
android:id="@+id/ok"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@id/entry"
android:layout_alignParentRight="true"
android:layout_marginLeft="10dip"
android:text="OK" />
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_toLeftOf="@id/ok"
android:layout_alignTop="@id/ok"
android:text="Cancel" />
</RelativeLayout>
