Resources Types - Layout
译者署名: 呆呆大虾
译者微博:http://weibo.com/popapa
版本:Android 3.2 r1
原文
http://developer.android.com/guide/topics/resources/layout-resource.html
参见
声明 Layout
布局资源
布局(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元素的容器,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 属性。
<requestFocus>
将屏幕的初始焦点设成其父元素,任何表示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特技:合并。
android:id的值
对于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);
}
|
参见
* Declaring Layout
* View
* ViewGroup
转载:http://www.cnblogs.com/over140/archive/2011/10/11/2207643.html