Android中文API文档格式.docx

Android中文API文档格式.docx

《Android中文API文档格式.docx》由会员分享，可在线阅读，更多相关《Android中文API文档格式.docx（27页珍藏版）》请在冰豆网上搜索。

java.lang.Object

android.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_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的请求来确保只有系统能够与之绑定

BIND_WALLPAPER

必须通过WallpaperService的请求来确保只有系统能够与之绑定

BLUETOOTH

允许应用去连接蓝牙设备

BLUETOOTH_ADMIN

允许应用找到与之连接的蓝牙设备

BRICK

被请求废止设备（非常危险）

BROADCAST_PACKAGE_REMOVED

允许应用发出一个程序包被移除的广播消息

BROADCAST_SMS

允许应用发出一个收到短信的消息

BROADCAST_STICKY

允许应用发出一个与intent相连的消息

BROADCAST_WAP_PUSH

允许应用发出一个收到WAPPUSH的广播消息

CALL_PHONE

允许应用启动一个用户确认电话被拨打而不通过拨打电话的用户界面的的拨打程序

CALL_PRIVILEGED

允许应用启动一个用户确认电话被拨打而不通过拨打电话的用户界面的的任意号码的拨打，包括紧急号码.

CAMERA

能够启动照相机设备的请求

CHANGE_COMPONENT_ENABLED_STATE

允许应用去改变一个应用是否是激活状态

CHANGE_CONFIGURATION

允许应用修改当前的配置，如本地设置

CHANGE_NETWORK_STATE

允许应用改变网络的连接状态

CHANGE_WIFI_MULTICAST_STATE

允许应用进入Wi-Fi的组播方式

CHANGE_WIFI_STATE

允许应用改变Wi-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

允许应用强制的返回操作而不论是不是最终的activity

GET_ACCOUNTS

允许应用访问账目服务中的统计清单

GET_PACKAGE_SIZE

允许应用查找出任何程序包使用的空间

GET_TASKS

允许应用找到关于当前或最近运行的任务和在哪些acitivities里运行

GLOBAL_SEARCH

这个权限可以被内容提供者用来允许使用全程搜索他们的数据

HARDWARE_TEST

允许访问硬件及周边设备.

INJECT_EVENTS

允许应用注入用户事件（键盘、触摸）到事件中然后提供给任意的窗口

INSTALL_LOCATION_PROVIDER

允许应用安装一个位置提供商到位置管理器中

INSTALL_PACKAGES

允许应用安装程序包.

INTERNAL_SYSTEM_WINDOW

允许应用打开被部分系统用户接口使用的窗口

INTERNET

允许应用打开网络套接口

KILL_BACKGROUND_PROCESSES

允许应用去呼叫killBackgroundProcesses（String）.方法

MANAGE_ACCOUNTS

允许应用去管理帐户管理者中的重要清单

MANAGE_APP_TOKENS

允许应用去管理（创建、销毁、顺序）在窗口管理者中的应用

MASTER_CLEAR

MODIFY_AUDIO_SETTINGS

允许应用修改全局音频设定

MODIFY_PHONE_STATE

允许改变拨打电话的状态-电源等

MOUNT_FORMAT_FILESYSTEMS

允许格式化可移除的存储仓库的文件系统

MOUNT_UNMOUNT_FILESYSTEMS

允许装备或解除可移除的存储仓库的文件系统

PERSISTENT_ACTIVITY

允许应用使它的activities更持久稳固

PROCESS_OUTGOING_CALLS

允许应用监督、限定或终止呼出的电话

READ_CALENDAR

允许应用读取用户的日历数据

READ_CONTACTS

允许应用读取用户的联系人数据

READ_FRAME_BUFFER

允许应用抓取屏幕和更多可获得的缓冲数据

READ_HISTORY_BOOKMARKS

允许应用去读取（非写）用户浏览历史和书签

READ_INPUT_STATE

允许应用去的当前键盘和控制的状态

READ_LOGS

允许应用读取低级别的系统日志文件

READ_OWNER_DATA

允许应用读取所有者的数据

READ_PHONE_STATE

允许读取电话的状态

READ_SMS

允许应用读取短信息.

READ_SYNC_SETTINGS

允许应用读取同步的设置

READ_SYNC_STATS

允许应用读取同步的统计数据

REBOOT

重新启动设备的请求

RECEIVE_BOOT_COMPLETED

允许应用接收在系统完成启动后发出的ACTION_BOOT_COMPLETED广播信息

RECEIVE_MMS

允许应用去监听多媒体信息并记录和对起进行处理

RECEIVE_SMS

允许应用去监听短消息并记录和对起进行处理

RECEIVE_WAP_PUSH

允许应用监听WAPpush信息

RECORD_AUDIO

允许应用记录音频信息

REORDER_TASKS

允许应用改变任务的关系位置

RESTART_PACKAGES

已废弃使用

SEND_SMS

允许应用发送短消息.

SET_ACTIVITY_WATCHER

允许应用查看和控制activities是怎样在系统中运行的

SET_ALWAYS_FINISH

允许应用去控制当activities被覆盖后是否是立即接触结束

SET_ANIMATION_SCALE

改变动画的比例因子

SET_DEBUG_APP

设置一个应用为调试模式

SET_ORIENTATION

允许低级别的设置屏幕的方向

SET_PREFERRED_APPLICATIONS

已废弃

SET_PROCESS_LIMIT

允许应用设置可以运行的最大数的应用进程

SET_TIME

允许应用设置系统时间

SET_TIME_ZONE

允许应用设置系统时区时间

SET_WALLPAPER

允许应用设置壁纸

SET_WALLPAPER_HINTS

允许应用设置锁定的壁纸

SIGNAL_PERSISTENT_PROCESSES

允许应用发出一个给所有稳定进程信号的请求

STATUS_BAR

允许应用打开、关闭或使状态栏或图标失去作用

SUBSCRIBED_FEEDS_READ

允许应用访问内容提供者的签署认证

SUBSCRIBED_FEEDS_WRITE

SYSTEM_ALERT_WINDOW

允许应用使用TYPE_SYSTEM_ALERT来打开窗口，并将窗口显示于其他应用的顶端

UPDATE_DEVICE_STATS

允许应用更新设备资料信息

USE_CREDENTIALS

允许应用从管理器得到授权请求

VIBRATE

允许应用访问震动器

WAKE_LOCK

允许使用电源锁定管理以使进程休眠或屏幕变暗

WRITE_APN_SETTINGS

允许应用去写入接入点设置

WRITE_CALENDAR

允许应用写（非读）用户的日历数据

WRITE_CONTACTS

允许应用写（非读）用户的联系人数据

WRITE_EXTERNAL_STORAGE

允许应用写（非读）用户的外部存储器

WRITE_GSERVICES

允许应用修改Google服务地图

WRITE_HISTORY_BOOKMARKS

允许应用写（非读）用户的浏览器历史和书签

WRITE_OWNER_DATA

允许应用写（非读）用户的数据

WRITE_SECURE_SETTINGS

允许应用写或读当前系统设置

WRITE_SETTINGS

允许应用写或读系统设置

WRITE_SMS

允许应用写短消息信息

WRITE_SYNC_SETTINGS

允许应用写同步设置

publicstaticfinalclassManifest.permission_groupextendsObject

android.Manifest.permission_group

ACCOUNTS

直接通过统计管理器访问管理的统计

COST_MONEY

可以用来让用户花钱但不需要通过与他们直接牵涉的权限

DEVELOPMENT_TOOLS

与开发联盟特征相连的权限组

HARDWARE_CONTROLS

被用来提供直接访问硬件设备的权限

LOCATION

用来允许访问用户的当前位置的权限

MESSAGES

用来允许应用发送用户收到的被拦截的信息

NETWORK

用来提供访问网络服务的权限

PERSONAL_INFO

用于提供访问用户私人数据如联系人、日历、电子邮件等的权限

PHONE_CALLS

用于跟访问和修改拨号状态如截取去话信息、读取和修改电话状态等的权限

STORAGE

与SD卡访问相关联的权限组

SYSTEM_TOOLS

与系统API有关联的权限组

publicabstractclassAccessibilityServiceextendsService

android.content.Context

android.content.ContextWrapper

android.app.Service

android.accessibilityservice.AccessibilityService

类概述

当AccessibilityEvent事件被启动后AccessibilityService 

会接收回调函数运行于后台，这些事件指的是在用户接口间的状态转换，比如,焦点变化，按钮被点击等。

一些辅助服务继承于此类并且实现它的抽象方法，像这样的一个服务和其他服务一样在AndroidManifest.xml中被声明但它必须被指定操纵“android.accessibilityservice.

AccessibilityService”的意图，下面的是一段例子：

辅助服务的声明周期只能被系统管理，启动或者停止这个服务必须由明确的用户通过启用或停用设备的设定，在系统通过呼叫onServiceConnected（）方法与服务绑定后，这个方法才能被想要执行装载的客户端所重载使用，一个辅助服务通过呼叫setServiceInfo（AccessibilityServiceInfo）方法来设定AccessibilityServiceInfo而配置。

你可以在任何时候改变这个服务的配置但最好是在重载方法onServiceConnected（）.中来使用。

一个辅助服务可以在特定的包中注册事件以提供特殊的反馈类型并且当最后一个关联的事件被解除的时候发出明确的超时提醒。

通告策略

对于每个回馈类型只有一个辅助服务被通知，服务登记处按顺序被通知，因此，如果有两个服务为同一个包中的同一回馈类型注册那么第一个会被通知，然而有可能的是，可以为一个给定的回馈类型去把一个服务注册为默认的，这样的话如果没有其他的服务来取代这个事件这个服务就会被呼出使用，换句话说，默认的服务不会与其他的服务竞争并且不管注册的顺序而被通知。

String 

SERVICE_INTERFACE

声明Intent必须由这个服务来处理

公共方法

abstractvoidonAccessibilityEvent（AccessibilityEventevent）

参数 

event 

一个事件

publicfinalIBinderonBind（Intentintent）

实现返回一个内部的辅助接口的实现，子类不能被重写。

参数 

intent 

与服务相绑定的意图，注意其他任何包含在Intent的外部意图将不能在此使用。

返回值

返回一个客户端可以在服务上访问的IBinder。

publicabstractvoidonInterrupt（）

打断辅助回馈内容时呼叫。

受保护方法

protectedvoidonServiceConnected（）

这个方法是AccessibilityService声明周期的一部分，在系统成功与服务绑定后才被呼叫，如果用来设定AccessibilityServiceInfo.这个方法更为方便。

android.view.View

直接子类：

AnalogClock,ImageView,KeyboardView,ProgressBar,SurfaceView,TextView,ViewGroup,ViewStub 

间接子类：

AbsListView,AbsSeekBar,AbsSpinner,AbsoluteLayout,AdapterView<

TextendsAdapter>

AppWidgetHostView,AutoCompleteTextView,Button,CheckBox,CheckedTextView,Chronometer,CompoundButton,DatePicker,DialerFilter,DigitalClock,EditText,ExpandableListView,ExtractEditText,FrameLayout,GLSurfaceView,Gallery,GestureOverlayView,GridView,HorizontalScrollView,ImageButton,ImageSwitcher,LinearLayout,ListView,MediaController,MultiAutoCompleteTextView,QuickContactBadge,RadioButton,RadioGroup,RatingBar,RelativeLayout,ScrollView,SeekBar,SlidingDrawer,Spinner,TabHost,TabWidget,TableLayout,TableRow,TextSwitcher,TimePicker,ToggleButton,TwoLineListItem,VideoView,ViewAnimator,ViewFlipper,ViewSwitcher,WebView,ZoomButton,ZoomControls

XML属性

属性名称

描述

android:

background

设置背景色/背景图片。

可以通过以下两种方法设置背景为

透明：

"

@android:

color/transparent"

和"

@null"

。

注意

TextView默认是透明的，不用写此属性，但是

Buttom/ImageButton/ImageView想透明的话就得写这个属

性了。

clickable

是否响应点击事件。

contentDescription

设置View的备注说明，作为一种辅助功能提供，为一些没

有文字描述的View提供说明，如ImageButton。

这里在界

面上不会有效果，自己在程序中控制，可临时放一点字符

串数据。

drawingCacheQuality

设置绘图时半透明质量。

有以下值可设置：

auto（默认，

由框架决定）/high（高质量，使用较高的颜色深度，消耗

更多的内存）/low（低质量，使用较低的颜色深度，但是

用更少的内存）。

duplicateParentState

如果设置此属性，将直接从父容器中获取绘图状态（光标，

按下等）。

见下面代码部分，注意根据目前测试情况仅仅是

获取绘图状态，而没有获取事件，也就是你点一下

LinearLayout时Button有被点击的效果，但是不执行点击事

件。

fadingEdge

设置拉滚动条时 

，边框渐变的放向。

none（边框颜色不

变），horizontal（水平方向颜色变淡），vertical

（垂直方向颜色变淡）。

参照fadingEdgeLength的

效果图

fadingEdgeLength

设置 

边框渐变的长度。

fitsSystemWindows

设置布局调整时是否考虑系统窗口（如状态栏）

focusable

设置是否获得焦点。

若有requestFocus（）被调用时，后者

优先处理。

注意在表单中想设置某一个如EditText获取焦

点，光设置这个是不行的，需要将这个EditText前面的

focusable都设置为false才行。

在Touch模式下获取焦点

需要设置focusableInTouchMode为true。

focusableInTouchMode

设置在Touch模式下View是否能取得焦点。

hapticFeedbackEnabled

设置触感反馈。

（译者注：

按软键以及进行某些UI交互时振动，暂时不知道用法，大家可以找找performHapticFeedback或HapticFeedback这个关键字的资料看看。

）

id

给当前View设置一个在当前layout.xml中的唯一编号，可

以通过调用View.findViewById（）或Activity.findViewById（）

根据这个编号查找到对应的View。

不同的layout.xml之间

定义相同的id不会冲突。

格式如”@+id/btnName”

isScrollContainer

设置当前View为滚动容器。

这里没有测试出效果来，

ListView/GridView/ScrollView根本就不用设置这个属性，

而EdidText设置android:

scrollbars也能出滚动条。

keepScreenOn

View在可见的情况下是否保持唤醒状态。

常在LinearLayout使用该属性，但是模拟器这里没有效果。

longClickable

设置是否响应长按事件.

minHeight

设置视图最小高度

minWidth

设置视图最小宽度度

nextFo