Android22API中文文档Word下载.docx

Android22API中文文档Word下载.docx

《Android22API中文文档Word下载.docx》由会员分享，可在线阅读，更多相关《Android22API中文文档Word下载.docx（63页珍藏版）》请在冰豆网上搜索。

3、已知间接子类：

AutoCompleteTextView,CheckBox,CompoundButton,ExtractEditText,

MultiAutoCompleteTextView,RadioButton,ToggleButton

4、XML属性

属性名称

描述

android:

autoLink

设置是否当文本为URL链接/email/电话号码/map时，文本显示为可点击的链接。

可选值（none/web/email/phone/map/all）

autoText

如果设置，将自动执行输入值的拼写纠正。

此处无效果，在显示输入法并输入的时候起作用。

bufferType

指定getText（）方式取得的文本类别。

选项editable类似于StringBuilder可追加字符，

也就是说getText后可调用append方法设置文本内容。

spannable则可在给定的字符区域使用样式，参见这里1、这里2。

capitalize

设置英文字母大写类型。

此处无效果，需要弹出输入法才能看得到，参见EditView此属性说明。

cursorVisible

设定光标为显示/隐藏，默认显示。

digits

设置允许输入哪些字符。

如“1234567890.+-*/%\n（）”

drawableBottom

在text的下方输出一个drawable，如图片。

如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。

drawableLeft

在text的左边输出一个drawable，如图片。

drawablePadding

设置text与drawable（图片）的间隔，与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可设置为负数，单独使用没有效果。

drawableRight

在text的右边输出一个drawable，如图片。

drawableTop

在text的正上方输出一个drawable，如图片。

editable

设置是否可编辑。

这里无效果，参见EditView。

editorExtras

设置文本的额外的输入数据。

在EditView再讨论。

ellipsize

设置当文字过长时,该控件该如何显示。

有如下值设置：

”start”—–省略号显示在开头；

”end”——省略号显示在结尾；

”middle”—-省略号显示在中间；

”marquee”——以跑马灯的方式显示（动画横向移动）

freezesText

设置保存文本的内容以及光标的位置。

参见：

这里。

gravity

设置文本位置，如设置成“center”，文本将居中显示。

hint

Text为空时显示的文字提示信息，可通过textColorHint设置提示信息的颜色。

比较奇怪的是TextView本来就相当于Label，怎么会不设置Text？

！

imeOptions

附加功能，设置右下角IME动作与编辑框相关的动作，如actionDone右下角将显示一个“完成”，而不设置默认是一个回车符号。

这个在EditView中再详细说明，此处无用。

imeActionId

设置IME动作ID。

在EditView再做说明，可以先看这篇帖子：

imeActionLabel

设置IME动作标签。

在EditView再做说明。

includeFontPadding

设置文本是否包含顶部和底部额外空白，默认为true。

inputMethod

为文本指定输入法，需要完全限定名（完整的包名）。

例如：

com.google.android.inputmethod.pinyin，但是这里报错找不到。

inputType

设置文本的类型，用于帮助输入法显示合适的键盘类型。

在EditView中再详细说明，这里无效果。

linksClickable

设置链接是否点击连接，即使设置了autoLink。

marqueeRepeatLimit

在ellipsize指定marquee的情况下，设置重复滚动的次数，当设置为marquee_forever时表示无限次。

ems

设置TextView的宽度为N个字符的宽度。

这里测试为一个汉字字符宽度，如图：

maxEms

设置TextView的宽度为最长为N个字符的宽度。

与ems同时使用时覆盖ems选项。

minEms

设置TextView的宽度为最短为N个字符的宽度。

maxLength

限制显示的文本长度，超出部分不显示。

lines

设置文本的行数，设置两行就显示两行，即使第二行没有数据。

maxLines

设置文本的最大显示行数，与width或者layout_width结合使用，超出部分自动换行，超出行数将不显示。

minLines

设置文本的最小行数，与lines类似。

lineSpacingExtra

设置行间距。

lineSpacingMultiplier

设置行间距的倍数。

如”1.2”

numeric

如果被设置，该TextView有一个数字输入法。

此处无用，设置后唯一效果是TextView有点击效果，此属性在EdtiView将详细说明。

password

以小点”.”显示文本

phoneNumber

设置为电话号码的输入方式。

privateImeOptions

设置输入法选项，此处无用，在EditText将进一步讨论。

scrollHorizontally

设置文本超出TextView的宽度的情况下，是否出现横拉条。

selectAllOnFocus

如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。

TextView中设置后无效果。

shadowColor

指定文本阴影的颜色，需要与shadowRadius一起使用。

效果：

shadowDx

设置阴影横向坐标开始位置。

shadowDy

设置阴影纵向坐标开始位置。

shadowRadius

设置阴影的半径。

设置为0.1就变成字体的颜色了，一般设置为3.0的效果比较好。

singleLine

设置单行显示。

如果和layout_width一起使用，当文本不能全部显示时，后面用“…”来表示。

如android:

text="

test_singleLine"

android:

singleLine="

true"

layout_width="

20dp"

将只显示“t…”。

如果不设置singleLine或者设置为false，文本将自动换行

text

设置显示文本.

textAppearance

设置文字外观。

如“?

attr/textAppearanceLargeInverse

”这里引用的是系统自带的一个外观，？

表示系统是否有这种外观，否则使用默认的外观。

可设置的值如下：

textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse

textColor

设置文本颜色

textColorHighlight

被选中文字的底色，默认为蓝色

textColorHint

设置提示信息文字的颜色，默认为灰色。

与hint一起使用。

textColorLink

文字链接的颜色.

textScaleX

设置文字之间间隔，默认为1.0f。

分别设置0.5f/1.0f/1.5f/2.0f效果如下：

textSize

设置文字大小，推荐度量单位”sp”，如”15sp”

textStyle

设置字形[bold（粗体）0,italic（斜体）1,bolditalic（又粗又斜）2]可以设置一个或多个，用“|”隔开

typeface

设置文本字体，必须是以下常量值之一：

normal0,sans1,serif2,monospace（等宽字体）3]

height

设置文本区域的高度，支持度量单位：

px（像素）/dp/sp/in/mm（毫米）

maxHeight

设置文本区域的最大高度

minHeight

设置文本区域的最小高度

width

设置文本区域的宽度，支持度量单位：

px（像素）/dp/sp/in/mm（毫米），与layout_width的区别看这里。

maxWidth

设置文本区域的最大宽度

minWidth

设置文本区域的最小宽度

二、EditText

　　　　java.lang.Object

　　　　　　↳android.view.View

　　　　　　　　↳android.widget.TextView 

　　　　　　　　　　↳android.widget.EditText

　　　　已知直接子类：

　　　　　　AutoCompleteTextView,ExtractEditText

　　　　已知间接子类：

　　　　　　MultiAutoCompleteTextView

2、xml属性

可选值（none/web/email/phone/map/all）。

这里只有在同时设置text时才自动识别链接，后来输入的无法自动识别。

自动拼写帮助。

这里单独设置是没有效果的，可能需要其他输入法辅助才行，效果参见视频。

设置如下值：

sentences仅第一个字母大写；

words每一个单词首字母大小，用空格区分单词；

characters每一个英文字母都大写。

在模拟器上用PC键盘直接输入可以出效果，但是用软键盘无效果。

如果设置false，即使选中了也不显示光标栏。

在text的正上方输出一个drawable。

在EditView中的效果比较搞笑：

，居然在文本框里，而且删不了。

在text的左边输出一个drawable（如图片）。

仍然可以获取光标，但是无法输入。

指定特定输入法的扩展，如“com.mydomain.im.SOME_FIELD”。

源码跟踪至EditorInfo.extras，暂无相关实现代码。

设置软键盘的Enter键。

有如下值可设置：

normal，actionUnspecified，actionNone，actionGo

，actionSearch，actionSend，actionNext，actionDone

，flagNoExtractUi，flagNoAccessoryAction，flagNoEnterAction。

可用’|’设置多个。

这里仅设置显示图标之用，参见文章末尾例子。

设置IME动作ID，在onEditorAction中捕获判断进行逻辑操作。

但是不能保证一定会使用，猜想在输入法扩展的时候应该有用。

关于自定义输入法参见这里。

none、text、textCapCharacters字母大小、textCapWords单词首字母大小、textCapSentences仅第一个字母大小、textAutoCorrect、textAutoComplete自动完成、textMultiLine多行输入、textImeMultiLine输入法多行（如果支持）、textNoSuggestions不提示、textEmailAddress电子邮件地址、textEmailSubject邮件主题、textShortMessage短信息（会多一个表情按钮出来，点开如下图：

）、textLongMessage长讯息？

、textPersonName人名、textPostalAddress地址、textPassword密码、textVisiblePassword可见密码、textWebEditText作为网页表单的文本、textFilte文本筛选过滤、textPhonetic拼音输入、numberSigned有符号数字格式、numberDecimal可带小数点的浮点格式、phone电话号码、datetime时间日期、date日期、time时间。

部分参考这里。

参见TextView中此属性的截图。

限制输入字符数。

如设置为5，那么仅可以输入5个汉字/数字/英文字母。

integer正整数、signed带符号整数、decimal带小数点浮点数。

提供额外的输入法选项（字符串格式）。

依据输入法而决定是否提供，如这里所见。

自定义输入法继承

InputMethodService。

这篇文章也许有帮助。

参见TextView的截图。

　　　　补充说明：

　　　　　　a）.　　由于是继承自TextView，所以属性是一样的，但是这里重点补充了输入法相关的属性说明和研究，部分注释也做了相应的调整。