Android22 API.docx

1、Android22 APIAndroid2.2API中文文档目录：（1） TextView（2） EditText（3） AccessibilityService（4） Manifest（5） View（6） ImageView （7） ImageButton（8） QuickContactBadge （9） ZoomButton （10） CheckBox （11） RadioButton（12） Button （13） ToggleButton（14） ViewStub （15） GridView一、TextView1、结构java.lang.Object android.view.Vie

2、w android.widget.TextView2、已知直接子类：Button, CheckedTextView, Chronometer, DigitalClock, EditText3、已知间接子类：AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText,MultiAutoCompleteTextView, RadioButton, ToggleButton4、XML属性属性名称描述android:autoLink设置是否当文本为URL链接/email/电话号码/map时，文本显示为可点击的链接。可选值(none/w

3、eb/email/phone/map/all)android:autoText如果设置，将自动执行输入值的拼写纠正。此处无效果，在显示输入法并输入的时候起作用。android:bufferType指定getText()方式取得的文本类别。选项editable 类似于StringBuilder可追加字符，也就是说getText后可调用append方法设置文本内容。spannable 则可在给定的字符区域使用样式，参见这里1、这里2。android:capitalize设置英文字母大写类型。此处无效果，需要弹出输入法才能看得到，参见EditView此属性说明。android:cursorVisib

4、le设定光标为显示/隐藏，默认显示。android:digits设置允许输入哪些字符。如“1234567890.+-*/%n()”android:drawableBottom在text的下方输出一个drawable，如图片。如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。android:drawableLeft在text的左边输出一个drawable，如图片。android:drawablePadding设置text与drawable(图片)的间隔，与drawableLeft、drawableRight、drawableTop、drawableB

5、ottom一起使用，可设置为负数，单独使用没有效果。android:drawableRight在text的右边输出一个drawable，如图片。android:drawableTop在text的正上方输出一个drawable，如图片。android:editable设置是否可编辑。这里无效果，参见EditView。android:editorExtras设置文本的额外的输入数据。在EditView再讨论。android:ellipsize设置当文字过长时,该控件该如何显示。有如下值设置：”start”省略号显示在开头；”end”省略号显示在结尾；”middle”-省略号显示在中间；”marqu

6、ee” 以跑马灯的方式显示(动画横向移动)android:freezesText设置保存文本的内容以及光标的位置。参见：这里。android:gravity设置文本位置，如设置成“center”，文本将居中显示。android:hintText为空时显示的文字提示信息，可通过textColorHint设置提示信息的颜色。比较奇怪的是TextView本来就相当于Label，怎么会不设置Text？！android:imeOptions附加功能，设置右下角IME动作与编辑框相关的动作，如actionDone右下角将显示一个“完成”，而不设置默认是一个回车符号。这个在EditView中再详细说明，此处

7、无用。android:imeActionId设置IME动作ID。在EditView再做说明，可以先看这篇帖子：这里。android:imeActionLabel设置IME动作标签。在EditView再做说明。android:includeFontPadding设置文本是否包含顶部和底部额外空白，默认为true。android:inputMethod为文本指定输入法，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是这里报错找不到。android:inputType设置文本的类型，用于帮助输入法显示合适的键盘类型。在EditVie

8、w中再详细说明，这里无效果。android:linksClickable设置链接是否点击连接，即使设置了autoLink。android:marqueeRepeatLimit在ellipsize指定marquee的情况下，设置重复滚动的次数，当设置为marquee_forever时表示无限次。android:ems设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度，如图：android:maxEms设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。android:minEms设置TextView的宽度为最短为N个字符的宽度。与ems同时使用

9、时覆盖ems选项。android:maxLength限制显示的文本长度，超出部分不显示。android:lines设置文本的行数，设置两行就显示两行，即使第二行没有数据。android:maxLines设置文本的最大显示行数，与width或者layout_width结合使用，超出部分自动换行，超出行数将不显示。android:minLines设置文本的最小行数，与lines类似。android:lineSpacingExtra设置行间距。android:lineSpacingMultiplier设置行间距的倍数。如”1.2”android:numeric如果被设置，该TextView有一个数字

10、输入法。此处无用，设置后唯一效果是TextView有点击效果，此属性在EdtiView将详细说明。android:password以小点”.”显示文本android:phoneNumber设置为电话号码的输入方式。android:privateImeOptions设置输入法选项，此处无用，在EditText将进一步讨论。android:scrollHorizontally设置文本超出TextView的宽度的情况下，是否出现横拉条。android:selectAllOnFocus如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。TextView中设置后无效果。andr

11、oid: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

12、_width=20dp将只显示“t”。如果不设置singleLine或者设置为false，文本将自动换行android:text设置显示文本.android:textAppearance设置文字外观。如“?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观，？表示系统是否有这种外观，否则使用默认的外观。可设置的值如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium

13、/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverseandroid:textColor设置文本颜色android:textColorHighlight被选中文字的底色，默认为蓝色android:textColorHint设置提示信息文字的颜色，默认为灰色。与hint一起使用。android:textColorLink文字链接的颜色.android:textScaleX设置文字之间间隔，默认为1.0f。分别设置0.5f/1.0f/1.5f/2.0f效果如下：android:textSize设置文字大

14、小，推荐度量单位”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:wi

15、dth设置文本区域的宽度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)，与layout_width的区别看这里。android:maxWidth设置文本区域的最大宽度android:minWidth设置文本区域的最小宽度二、EditText1、结构java.lang.Object android.view.View android.widget.TextView android.widget.EditText已知直接子类：AutoCompleteTextView, ExtractEditText已知间接子类：MultiAutoCompleteTextView2、xml属性属性名称

16、描述android:autoLink设置是否当文本为URL链接/email/电话号码/map时，文本显示为可点击的链接。可选值(none/web/email/phone/map/all)。这里只有在同时设置text时才自动识别链接，后来输入的无法自动识别。android:autoText自动拼写帮助。这里单独设置是没有效果的，可能需要其他输入法辅助才行，效果参见视频。android:bufferType指定getText()方式取得的文本类别。选项editable 类似于StringBuilder可追加字符，也就是说getText后可调用append方法设置文本内容。spannable 则可在

17、给定的字符区域使用样式，参见这里1、这里2。android:capitalize设置英文字母大写类型。设置如下值：sentences仅第一个字母大写；words每一个单词首字母大小，用空格区分单词；characters每一个英文字母都大写。在模拟器上用PC键盘直接输入可以出效果，但是用软键盘无效果。android:cursorVisible设定光标为显示/隐藏，默认显示。如果设置false，即使选中了也不显示光标栏。android:digits设置允许输入哪些字符。如“1234567890.+-*/%n()”android:drawableTop在text的正上方输出一个drawable。在E

18、ditView中的效果比较搞笑： ，居然在文本框里，而且删不了。android:drawableBottom在text的下方输出一个drawable，如图片。如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。android:drawableLeft在text的左边输出一个drawable（如图片）。android:drawablePadding设置text与drawable(图片)的间隔，与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可设置为负数，单独使用没有效果。androi

19、d:drawableRight在text的右边输出一个drawable，如图片。android:editable设置是否可编辑。仍然可以获取光标，但是无法输入。android:editorExtras指定特定输入法的扩展，如“com.mydomain.im.SOME_FIELD”。源码跟踪至EditorInfo.extras，暂无相关实现代码。android:ellipsize设置当文字过长时,该控件该如何显示。有如下值设置：”start”省略号显示在开头；”end”省略号显示在结尾；”middle”-省略号显示在中间；”marquee” 以跑马灯的方式显示(动画横向移动)android:fr

20、eezesText设置保存文本的内容以及光标的位置。参见：这里。android:gravity设置文本位置，如设置成“center”，文本将居中显示。android:hintText为空时显示的文字提示信息，可通过textColorHint设置提示信息的颜色。android:imeOptions设置软键盘的Enter键。有如下值可设置：normal，actionUnspecified，actionNone，actionGo，actionSearch，actionSend，actionNext，actionDone，flagNoExtractUi，flagNoAccessoryAction，fl

21、agNoEnterAction。可用|设置多个。这里仅设置显示图标之用，参见文章末尾例子。android:imeActionId设置IME动作ID，在onEditorAction中捕获判断进行逻辑操作。android:imeActionLabel设置IME动作标签。但是不能保证一定会使用，猜想在输入法扩展的时候应该有用。android:includeFontPadding设置文本是否包含顶部和底部额外空白，默认为true。android:inputMethod为文本指定输入法，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是这

22、里报错找不到。关于自定义输入法参见这里。android:inputType设置文本的类型，用于帮助输入法显示合适的键盘类型。有如下值设置：none、text、textCapCharacters字母大小、textCapWords单词首字母大小、textCapSentences仅第一个字母大小、textAutoCorrect、textAutoComplete自动完成、textMultiLine多行输入、textImeMultiLine输入法多行（如果支持）、textNoSuggestions不提示、textEmailAddress电子邮件地址、textEmailSubject邮件主题、textSh

23、ortMessage短信息（会多一个表情按钮出来，点开如下图：）、textLongMessage长讯息？、textPersonName人名、textPostalAddress地址、textPassword密码、textVisiblePassword可见密码、textWebEditText作为网页表单的文本、textFilte文本筛选过滤、textPhonetic拼音输入、numberSigned有符号数字格式、numberDecimal可带小数点的浮点格式、phone电话号码、datetime时间日期、date日期、time时间。部分参考这里。android:marqueeRepeatLimi

24、t在ellipsize指定marquee的情况下，设置重复滚动的次数，当设置为marquee_forever时表示无限次。android:ems设置TextView的宽度为N个字符的宽度。参见TextView中此属性的截图。android:maxEms设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。android:minEms设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。android:maxLength限制输入字符数。如设置为5，那么仅可以输入5个汉字/数字/英文字母。android:lines设置文本的行数，设置两行

25、就显示两行，即使第二行没有数据。android:maxLines设置文本的最大显示行数，与width或者layout_width结合使用，超出部分自动换行，超出行数将不显示。android:minLines设置文本的最小行数，与lines类似。android:linksClickable设置链接是否点击连接，即使设置了autoLink。android:lineSpacingExtra设置行间距。android:lineSpacingMultiplier设置行间距的倍数。如”1.2”android:numeric如果被设置，该TextView有一个数字输入法。有如下值设置：integer正整数、

26、signed带符号整数、decimal带小数点浮点数。android:password以小点”.”显示文本android:phoneNumber设置为电话号码的输入方式。android:privateImeOptions提供额外的输入法选项(字符串格式)。依据输入法而决定是否提供，如这里所见。自定义输入法继承InputMethodService。这篇文章也许有帮助。android:scrollHorizontally设置文本超出TextView的宽度的情况下，是否出现横拉条。android:selectAllOnFocus如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾

27、位置。TextView中设置后无效果。android:shadowColor指定文本阴影的颜色，需要与shadowRadius一起使用。参见TextView中此属性的截图。android:shadowDx设置阴影横向坐标开始位置。android:shadowDy设置阴影纵向坐标开始位置。android:shadowRadius设置阴影的半径。设置为0.1就变成字体的颜色了，一般设置为3.0的效果比较好。android:singleLine设置单行显示。如果和layout_width一起使用，当文本不能全部显示时，后面用“”来表示。如android:text=test_ singleLine a

28、ndroid:singleLine=true android:layout_width=20dp将只显示“t”。如果不设置singleLine或者设置为false，文本将自动换行android:text设置显示文本.android:textAppearance设置文字外观。如“?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观，？表示系统是否有这种外观，否则使用默认的外观。可设置的值如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppear

29、anceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverseandroid:textColor设置文本颜色android:textColorHighlight被选中文字的底色，默认为蓝色android:textColorHint设置提示信息文字的颜色，默认为灰色。与hint一起使用。android:textColorLink文字链接的颜色.android:textScaleX设置文字之间间隔，默认为1.0f。参见TextView的截

30、图。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设置文本区域的最小宽度补充说明：a).由于是继承自TextView，所以属性是一样的，但是这里重点补充了输入法相关的属性说明和研究，部分注释也做了相应的调整。