前言
本章内容为Android开发者指南的Framework Topics/Application Resources/Resource Types/Layout章节,译为"布局资源",版本为Android 3.2 r1,翻译来自:"呆呆大虾",欢迎访问他的微博:"http://weibo.com/popapa",再次感谢"呆呆大虾" !期待你一起参与翻译Android的相关资料,联系我over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
Android中文翻译组:http://goo.gl/6vJQl
Resources Types - Layout
译者署名: 呆呆大虾
版本:Android 3.2 r1
原文
http://developer.android.com/guide/topics/resources/layout-resource.html
参见
布局资源
布局(layout)资源用于定义Activity内用户界面(UI)或者用户界面控件的布局结构。
文件位置:
res/layout/filename.xml
文件名filename将作为资源ID。
编译后资源的数据类型:
指向View或其子类的资源指针。
资源引用:
Java代码:R.layout.filename
XML代码:@[package:]layout/filename
语法:
<?xml version="1.0" encoding="utf-8"?> <ViewGroup xmlns:android="http://schemas.android.com/apk/res/android" android:id="@[+][package:]id/resource_name" android:layout_height=["dimension" | "fill_parent" | "wrap_content"] android:layout_width=["dimension" | "fill_parent" | "wrap_content"] [ViewGroup-specific attributes] > <View android:id="@[+][package:]id/resource_name" android:layout_height=["dimension" | "fill_parent" | "wrap_content"] android:layout_width=["dimension" | "fill_parent" | "wrap_content"] [View-specific attributes] > <requestFocus/> </View> <ViewGroup> <View/> </ViewGroup> <include layout="@layout/layout_resource"/> </ViewGroup> |
注意:根元素可以是ViewGroup、View或<merge>,但只能有一个根元素且必须包含带android 命名空间的xmlns:android属性,如上例所示。
元素:
作为View元素的容器,ViewGroup对象分很多种类,每一类都能用不同的方式指定其子元素的布局。ViewGroup对象的种类包括:LinearLayout、RelativeLayout和FrameLayout。
并不是所有的ViewGroup派生类都能容纳嵌套的View。 有些ViewGroup是AdapterView类的实现,因此就只能容纳Adapter类型的子元素。
属性:
android:id
资源 ID。为元素指定一个唯一的资源名称,用于应用程序能实现对ViewGroup的引用。详见下文android:id的值。
android:layout_height
度量或关键字。必填项。高度,用度量值、度量资源 ( dimension resource) 或关键字"fill_parent" 、"wrap_content"指定。参阅下文合法值。
android:layout_width
度量或关键字。必填项。宽度,用度量值、度量资源 (dimension resource) 或关键字"fill_parent" 、"wrap_content"指定。参阅下文合法值。
ViewGroup基类支持更多的属性,每种子类的实现也支持很多其他属性。完整的可用属性请参阅各个类相关的参考文档,例如LinearLayout XML attributes。
<View>
一个独立的UI控件,通常是指一个部件(widget)。View对象的种类包括:TextView、Button和CheckBox。
属性:
android:id
资源 ID。为元素指定一个唯一的资源名称,用于应用程序能实现对ViewGroup的引用。详见下文android:id的值。
android:layout_height
度量或关键字。必填项。高度,用度量值、度量资源 ( dimension resource) 或关键字"fill_parent" 、"wrap_content"指定。参阅下文合法值。
android:layout_width
度量或关键字。必填项。宽度,用度量值、度量资源 ( dimension resource) 或关键字"fill_parent" 、"wrap_content"指定。参阅下文合法值。
View基类支持更多的属性,每种子类的实现也支持很多其他属性。更多信息请参阅声明Layout。完整的可用属性请参阅各个类相关的参考文档,例如TextView XML 属性。
将屏幕的初始焦点设成其父元素,任何表示View类对象的元素都能包含这个内容为空的元素。但每个文件内只能出现一次本元素。
<include>
将另一个布局(layout)文件包含进来。
属性:
layout
Layout资源。必填项。引用布局资源。
android:id
资源ID。覆盖包含进来的layout资源中的根view ID。
android:layout_height
度量或关键字。覆盖包含进来的layout资源中根view给出的高度。仅在同时给出android:layout_width时才生效。
android:layout_width
度量或关键字。覆盖包含进来的layout资源中根view给出的高度。仅在同时给出android:layout_height时才生效。
只要是被包含的layout资源根元素支持的属性,都能在<include>元素中包含进来,并且会覆盖本资源内根元素已定义的属性。
注意: 如果要覆盖layout的度量(长度和宽度),必须同时覆盖android:layout_height和 android:layout_width——不能只覆盖长度或只覆盖宽度。如果只覆盖其中一个,则不会生效。(其他布局属性,比如weight,仍然继承自原有的layout。)
包含layout资源的另一种方式是使用ViewStub。这是个轻量级的View,它在实际被填充之前不占用layout空间。在实际被填充时,它再把android:layout属性指定的layout资源文件动态包含进来。使用ViewStub的更多信息请参阅Layout特技: ViewStubs。
<merge>
在layout 的层次结构图里并没画出这个可充当根的元素。当明确知道本layout会被放入某个父View中去时,可以用<merge>作为根元素来包裹其下的子元素。如果希望本layout能被其他layout用<include>包含进去,并不再另外生成ViewGroup容器,本元素也特别有用。合并layout的更多信息请参阅Layout特技:合并。
对于ID的值,通常应该用"@+id/name"的语法格式。加号+表示这是个新的资源ID。如果R.java类中不存在此资源的话,aapt工具将在R.java类中生成一个新的resource整数标识。例如:
<TextView android:id="@+id/nameTextbox"/> |
名称nameTextbox现在作为资源ID和本元素关联。然后在Java代码里可以用此ID名称来引用这个TextView:
findViewById(R.id.nameTextbox) ; |
本行代码返回TextView对象。
然而,如果已经定义了一个ID资源(并且没被使用过),就可以去掉android:id里的加号并将此ID赋予View元素。
android:layout_height 和 android:layout_width的值
高度和宽度值能用Android支持的度量单位(px, dp, sp, pt, in, mm)或者以下关键字来表示:
值 |
描述 |
match_parent |
和父元素匹配(充满)。自API Level 8开始加入,以淘汰fill_parent。 |
fill_parent |
和父元素匹配(充满)。 |
wrap_content |
仅本元素内容需要的大小。 |
自定义View元素
可以生成自定义的View和ViewGroup元素并且和标准布局元素一样放入layout。还可以在XML元素内定义其所支持的属性。更多内容请参阅创建自定义控件。
示例:
存放在res/layout/main_activity.xml的XML文件:
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android” android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <TextView android:id="@+id/text" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hello, I am a TextView" /> <Button android:id="@+id/button" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="Hello, I am a Button" /> </LinearLayout> |
以下代码在Activity的onCreate()方法中装入layout。
public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView.(R.layout.main_activity); } |
参见
* View
转载:http://www.cnblogs.com/over140/archive/2011/10/11/2207643.html