Android2.2 API 中文文档系列（1）(转)
前言
关键字： Android API 中文文档,android sdk 中文,Android TextView 详解
像机械迷城游戏里的小工具一样——每一个控件都是我们手里一个有用的工具，由于时间的问题可以暂时先学会其基本用法，但是只要稍有时候还是需要系统的学习一下，起码知道有这么个属性有这么个方法，以便对某些问题发挥关键的作用，只有充分了解了才会运用自如。
声明
欢迎转载，但请保留文章原始出处:)
博客园：http://www.cnblogs.com
农民伯伯： http://www.cnblogs.com/over140/
正文
一、TextView的API 中文文档
1.1 结构
java.lang.Object
android.view.View
android.widget.TextView
直接子类：
Button, CheckedTextView, Chronometer, DigitalClock, EditText
间接子类：
AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText,MultiAutoCompleteTextView, RadioButton, ToggleButton
1.2 API
|
属性名称 |
描述 |
|
android:autoLink |
设置是否当文本为URL链接/email/电话号码/map时，文本显示为可点击的链接。可选值(none/web/email/phone/map/all) |
|
android:autoText |
如果设置，将自动执行输入值的拼写纠正。此处无效果，在显示输入法并输入的时候起作用。 |
|
android:bufferType |
指定getText()方式取得的文本类别。选项editable 类似于StringBuilder可追加字符， 也就是说getText后可调用append方法设置文本内容。spannable 则可在给定的字符区域使用样式，参见这里1、这里2。 |
|
android:capitalize |
设置英文字母大写类型。此处无效果，需要弹出输入法才能看得到，参见EditText此属性说明。 |
|
android:cursorVisible |
设定光标为显示/隐藏，默认显示。 |
|
android:digits |
设置允许输入哪些字符。如“1234567890.+-*/%\n()” |
|
android:drawableBottom |
在text的下方输出一个drawable，如图片。如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。 |
|
android:drawableLeft |
在text的左边输出一个drawable，如图片。 |
|
android:drawablePadding |
设置text与drawable(图片)的间隔，与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可设置为负数，单独使用没有效果。 |
|
android:drawableRight |
在text的右边输出一个drawable，如图片。 |
|
android:drawableTop |
在text的正上方输出一个drawable，如图片。 |
|
android:editable |
设置是否可编辑。这里无效果，参见EditView。 |
|
android:editorExtras |
设置文本的额外的输入数据。在EditView再讨论。 |
|
android:ellipsize |
设置当文字过长时,该控件该如何显示。有如下值设置：”start”—–省略号显示在开头；”end”——省略号显示在结尾；”middle”—-省略号显示在中间；”marquee” ——以跑马灯的方式显示(动画横向移动) |
|
android:freezesText |
设置保存文本的内容以及光标的位置。参见：这里。 |
|
android:gravity |
设置文本位置，如设置成“center”，文本将居中显示。 |
|
android:hint |
Text为空时显示的文字提示信息，可通过textColorHint设置提示信息的颜色。此属性在EditView中使用，但是这里也可以用。 |
|
android:imeOptions |
附加功能，设置右下角IME动作与编辑框相关的动作，如actionDone右下角将显示一个“完成”，而不设置默认是一个回车符号。这个在EditText中再详细说明，此处无用。 |
|
android:imeActionId |
设置IME动作ID。在EditText再做说明，可以先看这篇帖子：这里。 |
|
android:imeActionLabel |
设置IME动作标签。在EditText再做说明。 |
|
android:includeFontPadding |
设置文本是否包含顶部和底部额外空白，默认为true。 |
|
android:inputMethod |
为文本指定输入法，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是这里报错找不到。 |
|
android:inputType |
设置文本的类型，用于帮助输入法显示合适的键盘类型。在EditText中再详细说明，这里无效果。 |
|
android:linksClickable |
设置链接是否点击连接，即使设置了autoLink。 |
|
android:marqueeRepeatLimit |
在ellipsize指定marquee的情况下，设置重复滚动的次数，当设置为 |
|
android:ems |
设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度，如图： |
|
android:maxEms |
设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。 |
|
android:minEms |
设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。 |
|
android:maxLength |
限制显示的文本长度，超出部分不显示。 |
|
android:lines |
设置文本的行数，设置两行就显示两行，即使第二行没有数据。 |
|
android:maxLines |
设置文本的最大显示行数，与width或者layout_width结合使用，超出部分自动换行，超出行数将不显示。 |
|
android:minLines |
设置文本的最小行数，与lines类似。 |
|
android:lineSpacingExtra |
设置行间距。 |
|
android:lineSpacingMultiplier |
设置行间距的倍数。如”1.2” |
|
android:numeric |
如果被设置，该TextView有一个数字输入法。此处无用，设置后唯一效果是TextView有点击效果，此属性在EditText将详细说明。 |
|
android:password |
以小点”.”显示文本 |
|
android:phoneNumber |
设置为电话号码的输入方式。 |
|
android:privateImeOptions |
设置输入法选项，此处无用，在EditText将进一步讨论。 |
|
android:scrollHorizontally |
设置文本超出TextView的宽度的情况下，是否出现横拉条。 |
|
android:selectAllOnFocus |
如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。EditText中设置后无效果。 |
|
android:shadowColor |
指定文本阴影的颜色，需要与shadowRadius一起使用。效果： |
|
android:shadowDx |
设置阴影横向坐标开始位置。 |
|
android:shadowDy |
设置阴影纵向坐标开始位置。 |
|
android:shadowRadius |
设置阴影的半径。设置为0.1就变成字体的颜色了，一般设置为3.0的效果比较好。 |
|
android:singleLine |
设置单行显示。如果和layout_width一起使用，当文本不能全部显示时，后面用“…”来表示。如android:text="test_ singleLine " android:singleLine="true" android:layout_width="20dp"将只显示“t…”。如果不设置singleLine或者设置为false，文本将自动换行 |
|
android:text |
设置显示文本. |
|
android:textAppearance |
设置文字外观。如“?android:attr/textAppearanceLargeInverse ”这里引用的是系统自带的一个外观，？表示系统是否有这种外观，否则使用默认的外观。可设置的值如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse |
|
android:textColor |
设置文本颜色 |
|
android:textColorHighlight |
被选中文字的底色，默认为蓝色 |
|
android:textColorHint |
设置提示信息文字的颜色，默认为灰色。与hint一起使用。 |
|
android:textColorLink |
文字链接的颜色. |
|
android:textScaleX |
设置文字之间间隔，默认为1.0f。分别设置0.5f/1.0f/1.5f/2.0f效果如下： |
|
android:textSize |
设置文字大小，推荐度量单位”sp”，如”15sp” |
|
android:textStyle |
设置字形[bold(粗体) 0, italic(斜体) 1, bolditalic(又粗又斜) 2] 可以设置一个或多个，用“|”隔开 |
|
android:typeface |
设置文本字体，必须是以下常量值之一：normal 0, sans 1, serif 2, monospace(等宽字体) 3] |
|
android:height |
设置文本区域的高度，支持度量单位：px(像素)/dp/sp/in/mm(毫米) |
|
android:maxHeight |
设置文本区域的最大高度 |
|
android:minHeight |
设置文本区域的最小高度 |
|
android:width |
设置文本区域的宽度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)，与layout_width的区别看这里。 |
|
android:maxWidth |
设置文本区域的最大宽度 |
|
android:minWidth |
设置文本区域的最小宽度 |
1.3 补充说明
1.3.1 以下几个属性以及输入法相关的在这里都没有效果，在EditText将补充说明。
android:numeric/android:digits/android:phoneNumber/android:inputMethod/android:capitalize/android:autoText
1.4 Word格式的API文档下载
http://download.csdn.net/source/2649980
二、例子
2.1 跑马灯的效果
http://www.cnblogs.com/over140/archive/2010/08/20/1804770.html
三、系列
Android 2.2 API 中文文档系列（1） —— TextView
Android 2.2 API 中文文档系列（2） —— EditText
Android 2.2 API 中文文档系列（3） —— AccessibilityService
Android 2.2 API 中文文档系列（4） —— Manifest
Android 2.2 API 中文文档系列（5） —— View
Android 2.2 API 中文文档系列（6） —— ImageView
Android 2.2 API 中文文档系列（7） —— ImageButton
Android 2.2 API 中文文档系列（8） —— QuickContactBadge
Android 2.2 API 中文文档系列（9） —— ZoomButton
Android 2.2 r1 API 中文文档系列（10） —— CheckBox
Android 2.2 r1 API 中文文档系列（11） —— RadioButton
Android 2.2 r1 API 中文文档系列（12） —— Button
Android API 中文（13） —— ToggleButton
Android API 中文（14） —— ViewStub
Android API 中文 （15） —— GridView
Android 中文 API （16） —— AnalogClock
Android 中文 API （17） —— TextSwitcher
Android 中文 API （18） —— AbsSeekBar
Android 中文 API （19） —— TwoLineListItem
Android 中文 API （20） —— DatePicker
结束
鉴于至此仍未有完整的Android API中文文档公布出来，我会一直坚持翻译到有其他组织或官方出完整的API中文文档为止。在这里感谢女朋友的支持和帮助，为我提供日中翻译(将Android API日文版翻译成中文)和英中翻译；感谢翻译工具和搜索引擎以及其他提供部分属性翻译参考的分享者；感谢大家的支持！
