Android2.2_API中文文档(27页).doc

《Android2.2_API中文文档(27页).doc》由会员分享，可在线阅读，更多相关《Android2.2_API中文文档(27页).doc（27页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、-Android2.2_API中文文档-第 27 页Android2.2 API 中文文档系列（1） TextView一、TextView的API 中文文档1.1结构java.lang.Object android.view.View android.widget.TextView直接子类：Button, CheckedTextView, Chronometer, DigitalClock, EditText间接子类：AutoCompleteTextView, CheckBox, CompoundButton,ExtractEditText,MultiAutoCompleteTextView,

2、 RadioButton, ToggleButton1.2API属性名称描述android:autoLink设置是否当文本为URL链接/email/电话号码/map时，文本显示为可点击的链接。可选值(none/web/email/phone/map/all)android:autoText如果设置，将自动执行输入值的拼写纠正。此处无效果，在显示输入法并输入的时候起作用。android:bufferType指定getText()方式取得的文本类别。选项editable 类似于StringBuilder可追加字符，也就是说getText后可调用append方法设置文本内容。spannable 则可

3、在给定的字符区域使用样式，参见这里1、这里2。android:capitalize设置英文字母大写类型。此处无效果，需要弹出输入法才能看得到，参见EditText此属性说明。android:cursorVisible 设定光标为显示/隐藏，默认显示。android:digits 设置允许输入哪些字符。如“1234567890.+-*/%n()”android:drawableBottom在text的下方输出一个drawable，如图片。如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。android:drawableLeft 在text的左边输出一

4、个drawable，如图片。android:drawablePadding设置text与drawable(图片)的间隔，与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可设置为负数，单独使用没有效果。android:drawableRight 在text的右边输出一个drawable，如图片。1android:drawableTop 在text的正上方输出一个drawable，如图片。android:editable 设置是否可编辑。这里无效果，参见EditView。android:editorExtras 设置文本的额外的

5、输入数据。在EditView再讨论。android:ellipsize设置当文字过长时,该控件该如何显示。有如下值设置：”start”省略号显示在开头；”end”省略号显示在结尾；”middle”-省略号显示在中间；”marquee” 以跑马灯的方式显示(动画横向移动)android:freezesText 设置保存文本的内容以及光标的位置。参见：这里。android:gravity设置文本位置，如设置成“center”，文本将居中显示。android:hintText为空时显示的文字提示信息，可通过textColorHint设置提示信息的颜色。此属性在EditView中使用，但是这里也可以用

6、。android:imeOptions附加功能，设置右下角IME动作与编辑框相关的动作，如actionDone右下角将显示一个“完成”，而不设置默认是一个回车符号。这个在EditText中再详细说明，此处无用。android:imeActionId设置IME动作ID。在EditText再做说明，可以先看这篇帖子：这里。android:imeActionLabel 设置IME动作标签。在EditText再做说明。android:includeFontPadding 设置文本是否包含顶部和底部额外空白，默认为true。android:inputMethod为文本指定输入法，需要完全限定名（完整的包

7、名）。例如：com.google.android.inputmethod.pinyin，但是这里报错找不到。android:inputType设置文本的类型，用于帮助输入法显示合适的键盘类型。在EditText中再详细说明，这里无效果。android:linksClickable 设置链接是否点击连接，即使设置了autoLink。android:marqueeRepeatLimit在ellipsize指定marquee的情况下，设置重复滚动的次数，当设置为marquee_forever时表示无限次。android:ems设置TextView的宽度为N个字符的宽度。这里测试为一个汉字字符宽度，如

8、图：android:maxEms设置TextView的宽度为最长为N个字符的宽度。与ems同时使用时覆盖ems选项。2android:minEms设置TextView的宽度为最短为N个字符的宽度。与ems同时使用时覆盖ems选项。android:maxLength 限制显示的文本长度，超出部分不显示。android:lines设置文本的行数，设置两行就显示两行，即使第二行没有数据。android:maxLines设置文本的最大显示行数，与width或者layout_width结合使用，超出部分自动换行，超出行数将不显示。android:minLines 设置文本的最小行数，与lines类似。a

9、ndroid:lineSpacingExtra 设置行间距。android:lineSpacingMultiplier设置行间距的倍数。如”1.2”android:numeric如果被设置，该TextView有一个数字输入法。此处无用，设置后唯一效果是TextView有点击效果，此属性在EditText将详细说明。android:password 以小点”.”显示文本android:phoneNumber 设置为电话号码的输入方式。android:privateImeOptions设置输入法选项，此处无用，在EditText将进一步讨论。android:scrollHorizontally设置

10、文本超出TextView的宽度的情况下，是否出现横拉条。android:selectAllOnFocus如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。EditText中设置后无效果。android:shadowColor指定文本阴影的颜色，需要与shadowRadius一起使用。效果：android:shadowDx 设置阴影横向坐标开始位置。android:shadowDy 设置阴影纵向坐标开始位置。android:shadowRadius设置阴影的半径。设置为0.1就变成字体的颜色了，一般设置为3.0的效果比较好。android:singleLine设置单行

11、显示。如果和layout_width一起使用，当文本不能全部显示时，后面用“”来表示。如android:text=test_ singleLine android:singleLine=trueandroid:layout_width=20dp将只显示“t”。如果不设置singleLine或者设置为false，文本将自动换行3android:text 设置显示文本.android:textAppearance设置文字外观。如“?android:attr/textAppearanceLargeInverse”这里引用的是系统自带的一个外观，？表示系统是否有这种外观，否则使用默认的外观。可设置的值

12、如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverseandroid:textColor 设置文本颜色android:textColorHighlight 被选中文字的底色，默认为蓝色android:textColorHint设置提示信息文字的颜色，默认为灰色。与hint一起使

13、用。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(等宽字体) 3andr

14、oid: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补充说明4以下几个属性以及输入法相关的在这里都没有效果，在EditText将补充说明。android:numeric/an

15、droid:digits/android:phoneNumber/android:inputMethod/android:capitalize/android:autoText二、例子2.1跑马灯的效果TextView android:layout_width=100pxandroid:layout_height=wrap_contentandroid:textColor=android:color/whiteandroid:ellipsize=marqueeandroid:focusable=trueandroid:marqueeRepeatLimit=marquee_foreverandr

16、oid:focusableInTouchMode=trueandroid:scrollHorizontally=trueandroid:text=这才是真正的文字跑马灯效果Android2.2 API 中文文档系列（2） EditText一、结构java.lang.Object android.view.View android.widget.TextView android.widget.EditText已知直接子类：AutoCompleteTextView, ExtractEditText已知间接子类：MultiAutoCompleteTextView二、xml属性属性名称描述androi

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

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

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

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

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

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

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

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

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

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

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

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

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

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

31、iew的截图。10android:textSize设置文字大小，推荐度量单位”sp”，如”15sp”android:textStyle设置字形bold(粗体) 0, italic(斜体) 1,bolditalic(又粗又斜) 2 可以设置一个或多个，用“|”隔开android:typeface设置文本字体，必须是以下常量值之一：normal 0, sans 1, serif 2, monospace(等宽字体) 3android:height设置文本区域的高度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)android:maxHeight 设置文本区域的最大高度android:m

32、inHeight 设置文本区域的最小高度android:width设置文本区域的宽度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)，与layout_width的区别看这里。android:maxWidth 设置文本区域的最大宽度android:minWidth 设置文本区域的最小宽度补充说明：由于是继承自TextView，所以属性是一样的，但是这里重点补充了输入法相关的属性说明和研究，部分注释也做了相应的调整。三、例子android:imeOptions例子(EditText)findViewById(R.id.txtTest).setOnEditorActionListener

33、(new TextView.OnEditorActionListener() Overridepublic boolean onEditorAction(TextView v, int actionId,KeyEvent event) if (actionId = EditorInfo.IME_ACTION_GO) Toast.makeText(TestActivity.this, 你点了Go!, Toast.LENGTH_SHORT).show();return false;Android2.2 API 中文文档系列（3） 11AccessibilityService一、结构java.lan

34、g.Object android.content.Context android.content.ContextWrapper android.app.Service android.accessibilityservice.AccessibilityServicepublic abstract class AccessibilityService extends Service二、类概述当AccessibilityEvent事件被启动后AccessibilityService 会接收回调函数运行于后台，这些事件指的是在用户接口间的状态转换，比如,焦点变化，按钮被点击等。一些辅助服务继承于此类

35、并且实现它的抽象方法，像这样的一个服务和其他服务一样在AndroidManifest.xml中被声明但它必须被指定操纵android.accessibilityservice.AccessibilityService的意图，下面的是一段例子：辅助服务的声明周期只能被系统管理，启动或者停止这个服务必须由明确的用户通过启用或停用设备的设定，在系统通过呼叫onServiceConnected()方法与服务绑定后，这个方法才能被想要执行装载的客户端所重载使用，一个辅助服务通过呼叫setServiceInfo(AccessibilityServiceInfo)方法来设定AccessibilityServ

36、iceInfo而配置。你可以在任何时候改变这个服务的配置但最好是在重载方法onServiceConnected().中来使用。一个辅助服务可以在特定的包中注册事件以提供特殊的反馈类型并且当最后一个关联的事件被解除的时候发出明确的超时提醒。三、通告策略对 于每个回馈类型只有一个辅助服务被通知，服务登记处按顺序被通12知，因此，如果有两个服务为同一个包中的同一回馈类型注册那么第一个会被通知，然而有可能的 是，可以为一个给定的回馈类型去把一个服务注册为默认的，这样的话如果没有其他的服务来取代这个事件这个服务就会被呼出使用，换句话说，默认的服务不会与 其他的服务竞争并且不管注册的顺序而被通知。四、公共

37、方法：4.1 abstract void onAccessibilityEvent(AccessibilityEventevent)Callback for AccessibilityEvents.参数 event 一个事件4.2 public final IBinder onBind (Intent intent)实现返回一个内部的辅助接口的实现，子类不能被重写。参数intent 与服务相绑定的意图，注意其他任何包含在Intent的外部意图将不能在此使用。返回值 返回一个客户端可以在服务上访问的IBinder。4.3 public abstract void onInterrupt ()打断

38、辅助回馈内容时呼叫。五、保护方法：5.1 protected void onServiceConnected () 这个方法是AccessibilityService声明周期的一部分，在系统成功与服务绑定后才被呼叫，如果用来设定AccessibilityServiceInfo.这个方法更为方便。Android2.2 API 中文文档系列（4） Manifest一、结构java.lang.Object android.Manifest public final class Manifest extends Object内部类Manifest.permission13Manifest.permis

39、sion_group二、Manifest.permission的常量ACCESS_CHECKIN_PROPERTIES允许在登入数据库的时候读写其中的属性表，并上传改变的值ACCESS_COARSE_LOCATION 允许应用访问范围(如WIFI)性的定位ACCESS_FINE_LOCATION 允许应用访问精确(如GPS)性的定位ACCESS_LOCATION_EXTRA_COMMANDS 允许应访问额外的提供定位的指令ACCESS_MOCK_LOCATION 允许应用创建用于测试的模拟定位提供者ACCESS_NETWORK_STATE 允许应用访问网络上的信息ACCESS_SURFACE_

40、FLINGER 允许应用使用低版本视图的特征ACCESS_WIFI_STATE 允许应用访问关羽Wi-Fi网络的信息ACCOUNT_MANAGER 允许应用进入帐户认证AUTHENTICATE_ACCOUNTS允许应用为ACCOUNT_MANAGER扮演一个帐户认证系统BATTERY_STATS 允许应用去统计电源信息BIND_APPWIDGET允许应用告诉AppWidget哪个应用能够访问该AppWidget的数据BIND_DEVICE_ADMIN必须通过关机接收者的请求来确保只有系统能够与之交互BIND_INPUT_METHOD必须通过InputMethodService的请求来确保只有系

41、统能够与之绑定BIND_WALLPAPER必须通过WallpaperService的请求来确保只有系统能够与之绑定BLUETOOTH 允许应用去连接蓝牙设备BLUETOOTH_ADMIN 允许应用找到与之连接的蓝牙设备BRICK 被请求废止设备(非常危险)BROADCAST_PACKAGE_REMOVED 允许应用发出一个程序包被移除的广播消息BROADCAST_SMS 允许应用发出一个收到短信的消息BROADCAST_STICKY 允许应用发出一个与intent相连的消息14BROADCAST_WAP_PUSH 允许应用发出一个收到WAP PUSH的广播消息CALL_PHONE允许应用启动一

42、个用户确认电话被拨打而不通过拨打电话的用户界面的的拨打程序CALL_PRIVILEGED允许应用启动一个用户确认电话被拨打而不通过拨打电话的用户界面的的任意号码的拨打，包括紧急号码.CAMERA 能够启动照相机设备的请求CHANGE_COMPONENT_ENABLED_STATE 允许应用去改变一个应用是否是激活状态CHANGE_CONFIGURATION 允许应用修改当前的配置，如本地设置CHANGE_NETWORK_STATE 允许应用改变网络的连接状态CHANGE_WIFI_MULTICAST_STATE 允许应用进入Wi-Fi的组播方式CHANGE_WIFI_STATE 允许应用改变W

43、i-Fi的连接状态CLEAR_APP_CACHE 允许应用清除所有安装在设备上的应用的缓存CLEAR_APP_USER_DATA 允许应用清除使用者的信息资料CONTROL_LOCATION_UPDATES 允许从广播设备来更新或不更新本地的消息DELETE_CACHE_FILES 允许应用删除掉缓存文件DELETE_PACKAGES 允许应用删除掉程序包DEVICE_POWER 允许低权限的访问电源管理项DIAGNOSTIC 允许应用诊断程序资源DISABLE_KEYGUARD 允许应用禁用键盘锁DUMP 允许应用从系统服务中恢复转储的信息EXPAND_STATUS_BAR 允许应用扩大或缩小状态栏FACTORY_TEST 如制造商测试的应用一样用终极权限用户运行FLASHLIGHT 允许访问手电筒FORCE_BACK允许应用强制的返回操作而不论是不是最终的activityGET_ACCOUNTS 允许应用访问账目服务中的统计清单GET_PACKAGE_SIZE 允许应用查找出任何程序包使用的空间15GET_TASKS允许应用找到关于当前或最近运行的任务和在哪些acitivities里运行GLOBAL_SEARCH这个权限可以被内