首页 文章 精选 留言 我的

精选列表

搜索[API集成],共10000篇文章
优秀的个人博客,低调大师

Android 中文 API (93) —— BaseExpandableListAdapter

正文 一、结构 public abstract classBaseExpandableListAdapter extendsObject implementsExpandableListAdapter,HeterogeneousExpandableList java.lang.Object android.widget.BaseExpandableListAdapter 直接子类 CursorTreeAdapter,SimpleExpandableListAdapter 间接子类 ResourceCursorTreeAdapter,SimpleCursorTreeAdapter 二、概述 BaseExpandableListAdapter是ExpandableListAdapter的抽象基类,从一些数据中提供数据和视图给可折叠列表视图。 所有继承本类的Adapters需要保证实现的getCombinedChildId(long, long)和getCombinedGroupId(long)方法能正确地从View组或View子元素的ID中生成唯一的ID号。 (译者注:组元素表示可折叠的列表项,子元素表示列表项展开后看到的多个子元素项。由于可折叠列表单纯寻找组元素和子元素的ID不是很方便,因此使用联合ID的方式来解决。于是有了getCombinedChildId()和getCombinedGroupId()方法。在andorid自带的ApiDomos的例子中有这个的代码:App/View/ExpandableList1)。 三、公共方法 public booleanareAllItemsEnabled() 是否启用所有元素。 public intgetChildType(int groupPosition, int childPosition) 获取由getChildView(int, int, boolean, View, ViewGroup)方法创建的指定子元素类型。 参数 groupPosition子元素所在的组位置 childPosition子元素所在的位置 返回值 0表示任意一个子元素类型,因此此时应当只声明一种子元素类型。 publicintgetChildTypeCount() 获取由getChildView(int, int, boolean, View, ViewGroup)创建的所有子元素类型个数。每种类型表示一个能被getChildView(int, int, boolean, View, ViewGroup)转换的(任意组中的)View集合。如果适配器总是从所有的子元素中返回同一种类型,本方法将返回1。 本方法将仅仅在AdapterView设置适配器时被调用。 返回值 BaseExpandableListAdapter默认返回1。 public longgetCombinedChildId(long groupId, long childId) 若你预见以下默认实现的IDs可能出现冲突,请重写本方法。 实现返回一个long型: *第0位:不管ID指向的是一个子元素(未设置)还是一个组(已设置),对于本方法bit值为1. *第1-31位:小于31位的组ID。 *第32-63位:小于32位的子元素ID。 从列表所有项(组或子项)中获得一个唯一的子ID号。可折叠列表要求每个元素(组或子项)在所有的子元素和组中有一个唯一的ID。本方法负责根据所给的子ID号和组ID号返回唯一的ID。此外,若hasStableIds()是true,那么必须要返回稳定的ID。 参数 groupID包含该子元素的组ID childID子元素的ID号 返回 列表所有项(组或子项)中唯一的(和可能稳定)的子元素ID号。 public longgetCombinedGroupId(long groupId) 若你预见以下默认实现产生IDs冲突的话,请重写本方法。 实现返回一个long型: *第0位:不管ID指向的是一个子元素(未设置)还是一个组(已设置),对于本方法bit值为1. *第1-31位:小于31位的组ID。 *第32-63位:小于32位的子元素ID。 从列表所有项(组或子项)中获得一个唯一的子ID号。可折叠列表要求每个元素(组或子项)在所有的子元素和组中有一个唯一的ID。本方法负责根据所给的子ID号和组ID号返回唯一的ID。此外,若hasStableIds()是true,那么必须要返回稳定的ID。 参数 groupID包含该子元素的组ID 返回 列表所有项(组或子项)中唯一的(和可能稳定)的子元素ID号。 public intgetGroupType(int groupPosition) 获得由getGroupView(int, boolean, View, ViewGroup)方法创建的组元素类型。为设置的组元素。 参数 groupPosition应返回类型所在组的位置 返回 0表示任意组位置,因此此时应当只申明了一种组类型。 public intgetGroupTypeCount() 返回由getGroupView(int, boolean, View, ViewGroup)方法创建的组视图类型个数。每个类型表示一个能被getGroupView(int, boolean, View, ViewGroup)转换的View集合。如果适配器总是返回同一种组类型,则此时本方法将返回1. 本方法将仅当适配器被AdapterView设置时调用。 返回 BaseExpandableListAdapter默认返回1. public booleanisEmpty() (译者注:如果适配器没有任何数据,返回真。参见Adapter) public voidnotifyDataSetChanged() (译者注:当后台数据集发生改变时,调用此方法响应数据集的更改。) 参见 notifyChanged() public voidnotifyDataSetInvalidated() (译者注:当后台数据集不被验证的时候,调用此方法。) 参见 notifyInvalidated() public voidonGroupCollapsed(int groupPosition) 当组折叠的时候被调用。 参数 groupPosition要折叠的组所在位置 public voidonGroupExpanded(int groupPosition) 当组展开的时候被调用。 参数 groupPosition要折叠的组所在位置 public voidregisterDataSetObserver(DataSetObserverobserver) (译者注:注册当用该适配器修改数据时调用的观察器。) public voidunregisterDataSetObserver(DataSetObserverobserver) (译者注:注销之前通过registerDataSetObserver(DataSetObserver)方法注册到该适配器的观察器。) 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582413,如需转载请自行联系原作者

优秀的个人博客,低调大师

android中文api(89)——ViewManager

正文 一、结构 public interfaceViewManager android.view.ViewManager 间接子类 AbsListView, AbsSpinner, AbsoluteLayout, AdapterView<T extends Adapter>, AppWidgetHostView, DatePicker, DialerFilter, ExpandableListView, FrameLayout, Gallery, GestureOverlayView, GridView, HorizontalScrollView, ImageSwitcher, LinearLayout, ListView, MediaController, RadioGroup, RelativeLayout, ScrollView, SlidingDrawer, Spinner, TabHost, TabWidget, TableLayout, TableRow, TextSwitcher, TimePicker, TwoLineListItem, ViewAnimator, ViewFlipper, ViewGroup, ViewSwitcher, WebView, WindowManager, ZoomControls 二、概述 此接口使你可以向一个Activity中添加和移除子视图。调用Context.getSystemService(),你可以得到该类的一个实例。(译者注:ViewManager是个接口,没有任何实现,抽象类ViewGroup对该接口的三个方法进行了具体实现。) 三、公共方法 public abstract voidaddView(View view, ViewGroup.LayoutParams params) (译者注:增添一个视图对象,并指定其布局参数 参数 view 制定添加的子视图 params子视图的布局参数) public abstract voidremoveView(View view) (译者注:移除指定的视图 参数 view指定移除的子视图) public abstract voidUpdateViewLayout(View view, ViewGroup.LayoutParams params) (译者注:更新一个子视图 参数 view 指定更新的子视图 params 更新时所用的布局参数) 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582418,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android中文API(96)——SoundEffectConstants

正文 一、结构 public classSoundEffectConstantsextendsObject java.lang.Object android.view.SoundEffectConstants 二、概述 playSoundEffect(int)所需的播放声效设定常量。 三、常量 public static final int CLICK (译者注:单击事件)常量,取值0 (0x00000000) public static final int NAVIGATION_DOWN (译者注:View.FOCUS_DOWN)常量,取值4 (0x00000004) public static final int NAVIGATION_LEFT (译者注:View.FOCUS_LEFT)常量,取值1 (0x00000001) public static final int NAVIGATION_RIGHT (译者注:View.FOCUS_RIGHT)常量,取值3 (0x00000003) public static final int NAVIGATION_UP (译者注:View.FOCUS_UP)常量,取值2 (0x00000002) 四、公共方法 public static intgetContantForFocusDirection(int direction) 针对不同声音方向,获得相应的发声常数。 参数 direction参数取值为以下常量之一:FOCUS_UP,FOCUS_DOWN,FOCUS_LEFT,FOCUS_RIGHT,FOCUS_FORWARD,FOCUS_BACKWARD. 返回值 合适的发声常数 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582401,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文api (88)——SharedPreferences

正文 一、结构 public interfaceSharedPreferences android.content.SharedPreferences 二、概述 用于访问和修改getSharedPreferences(String, int)返回偏好设置数据(preference data)的一个接口。对于任何一组特殊的preferences,所有的客户端共享一个此类单独的实例。 修改Preferences必须通过一个SharedPreferences.Editor对象,以确保当他们提交存储数据的操作时,preference值保持一致的状态。 注意:当前此类不支持多线程访问。后续将添加。 (译者注:这里译为”偏好设定”,类似于ini文件,用于保存应用程序的属性设置) 参见 getSharedPreferences(String, int) 三、内部类 interface SharedPreferences.Editor 用于修改SharedPreferences对象设定值的接口。 interface SharedPreferences.OnSharedPreferenceChangeListener 接口定义一个用于在偏好设定(shared preference)改变时调用的回调函数。 四、公共方法 public abstract booleancontains(String key) 判断preferences是否包含一个preference。 参数 key想要判断的preference的名称 返回值 如果preferences中存在preference,则返回true,否则返回false。 public abstract SharedPreferences.Editoredit() 针对preferences创建一个新的Editor对象,通过它你可以修改preferences里的数据,并且原子化的将这些数据提交回SharedPreferences对象。(译者注:原子化——作为一个整体提交,原子性) 注意:如果你想要在SharedPreferences中实时显示,刚通过Editor对象进行的修改,那么你必须调用commit()方法。 返回值 返回一个SharedPreferences.Editor的新实例,允许你修改SharedPreferences对象里的值。 public abstract Map<String, ?>getAll() 取得preferences里面的所有值 返回值 返回一个map,其中包含一列preferences中的键值对 异常 空指针异常(NullPointerException) public abstract boolean getBoolean (String key, boolean defValue) 从preferences中获取一个boolean类型的值。 参数 key 获取的preference的名称 defValue当此preference不存在时返回的默认值 返回值 如果preference存在,则返回preference的值,否则返回defValue。如果使用此名称的preference不是一个boolean类型,则抛出ClassCastException。 异常 ClassCastException public abstract float getFloat (String key, float defValue) 从preferences中获取一个float类型的值。 参数 key 获取的preference的名称 defValue当此preference不存在时返回的默认值 返回值 如果preference存在,则返回preference的值,否则返回defValue。如果使用此名称的preference不是一个float类型,则抛出ClassCastException。 异常 ClassCastException public abstract intgetInt(String key, int defValue) 从preferences中获取一个int类型的值。 参数 key 获取的preference的名称 defValue当此preference不存在时返回的默认值 返回值 如果preference存在,则返回preference的值,否则返回defValue。如果使用此名称的preference不是一个int类型,则抛出ClassCastException。 异常 ClassCastException public abstract longgetLong(String key, long defValue) 从preferences中获取一个long类型的值。 参数 key 获取的preference的名称 defValue当此preference不存在时返回的默认值 返回值 如果preference存在,则返回preference的值,否则返回defValue。如果使用此名称的preference不是一个long类型,则抛出ClassCastException。 异常 ClassCastException public abstract StringgetString(String key, String defValue) 从preferences中获取一个String类型的值。 参数 key 获取的preference的名称 defValue当此preference不存在时返回的默认值 返回值 如果preference存在,则返回preference的值,否则返回defValue。如果使用此名称的preference不是一个String类型,则抛出ClassCastException。 异常 ClassCastException public abstract voidregisterOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener listener) 注册一个回调函数,当一个preference发生变化时调用。 参数 listener将会被调用的回调函数 参见 unregisterOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener) public abstract voidunregisterOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener listener) 注销一个之前(注册)的回调函数 参数 listener要被注销的回调函数 参见 registerOnSharedPreferenceChangeListener(SharedPreferences.OnSharedPreferenceChangeListener) 五、补充 文章精选 SharedPreferences [Android开发者指南]第十八讲:Android SharedPreferences和File SharedPreferences用法 Android程式設計(十五)使用SharedPreferences 示例代码 译注:Shared Preferences保存位置:/data/data/app_name/shared_prefs/*.xml private boolean flag = false ; // 取得活动的Preferences对象 SharedPreferencessettings = getPreferences(Activity.MODE_PRIVATE); // 取得值 flag = settings.getBoolean(“flag”, false ); // 取得活动的Preferences对象 SharedPreferencessettings = getPreferences( 0 ); // 取得编辑对象 SharedPreferences.Editoreditor = settings.edit(); // 添加值 editor.putBoolean(“ true ”,flag); // 提交保存 editor.commit(); 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582420,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android中文API (39) —— AbsSpinner

正文 一、结构 public abstract classAbsSpinnerextendsAdapterView<T extends Adapter> java.lang.Object android.view.View android.view.ViewGroup android.widget.AdapterView<T extends android.widget.Adapter> android.widget.AbsSpinner 二、概述 下拉列表的基类。Sdk可能不再使用到该类(译者注:我认为是过时了) 三、XML属性 属性名称 描述 android:entries 引用一个数据源填充Spinner这是一种比编程填充Spinner更简单的方式。 四、公共方法 public SpinnerAdapter getAdapter () 返回与当前部件相关联的适配器 返回值 该适配器用于提供视图内容 public int getCount () 返回值 与此相关的适配器AdapterView所拥有的项目数量。(这个数据项,可能比显示的视图数据量还大。) public View getSelectedView () 返回值 这个视图对应当前选择的项,或者如果不选择视图则为null public void onRestoreInstanceState (Parcelable state) 允许视图重新应用以前通过onSaveInstanceState()生成代表内部的状态。这个函数决不能以一个空值状态被调用。 参数 state 返回以前调用onSaveInstanceState()保存下来的状态。 public Parcelable onSaveInstanceState () 允许视图生成一个代表内部的状态,以后可用于创建一个与之相同的新的实例。这个状态只可包含那些暂时的或不能被重建的信息。例如,你无法将你目前的位置保存在屏幕上,因为当有一个新的对象出现在这个视图层次上就会自动重新计算。 以下有些实例:当光标停留在一个文本视区上(但是通常来说不能是实文档,因为那个是己储存在内容提供者或者其它长久储存器中),当前所选的项位于一个列表视图中 返回值 返回一个Parcelable对象包含了当前视图动态状态,或者返回null如果没有保存,默认返回值为null。 public int pointToPosition (int x, int y) 映射到列表中的一个坐标(译者注:根据这个坐标可以确定点击的是哪一个item,看这里) 参数 x局部坐标X(译者注:列表范围内的坐标X) y局部坐标Y(译者注:列表范围内的坐标Y) 返回值 返回这个位置包含的指定点(译者注:返回坐标(item)在列表中的顺序),如果这2个点不相交返回INVALID_POSITION public void requestLayout () 重写以防止布局视图时出现大量布局要求。(译者注:这个方法通常在视图认为它自己不再合适它当前的边界的情况下被调用) public void setAdapter (SpinnerAdapter adapter) 该适配器用于提供数据支持这个Spinner。他还提供了改变基于他们选择的相对位置的选定项 参数 adapter该SpinnerAdapter用于下拉列表 public void setSelection (int position, boolean animate) 直接跳到数据适配器中指定项 public void setSelection (int position) 设置当前选中项,为了支持可访问的子类重写此方法,必须首先调用父类的方法。 参数 position索引,被选中的数据项(从0开始) 五、受保护方法 protected ViewGroup.LayoutParams generateDefaultLayoutParams () 返回默认设置的布局参数。这些参数是在请求传递给addView(View)还没有布局的时候已经设置好了的。如果是返回null,则从addView抛出一个异常 返回值 参数的默认布局或null 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582625,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文API (61) —— ViewSwitcher

正文 一、结构 public classViewSwitcher extendsViewAnimator java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.ViewAnimator android.widget.ViewSwitcher 已知直接子类 ImageSwitcher,TextSwitcher 二、概述 在两个视图间转换时显示动画,有一个可以创建这些视图的工厂类。你可以用工厂来创建这些视图,也可以自己创建。一个ViewSwitcher只允许包含两个子视图,且一次仅能显示一个。 (译者注:与ViewFlipper类相似,但该类不常用,常用其两个子类ImageSwitcher:转换图片时增加动画效果;TextSwitcher:转换文字时增加动画效果;其实例见apidemos中ImageSwitcher实例和TextSwitcher实例) 三、内部类 interface ViewSwitcher.ViewFactory 在一个ViewSwitcher里创建视图 四、构造函数 publicViewSwitcher(Context context) 构造一个新的空的视图转换器(ViewSwitcher)。 参数 context 应用环境(译者注:应用程序上下文) publicViewSwitcher(Context context, AttributeSet attrs) 构造一个指定上下文、属性集合的空的视图转换器(ViewSwitcher)。 参数 context 应用环境(译者注:应用程序上下文) attrs属性集合 五、公共方法 public voidaddView(View child, int index, ViewGroup.LayoutParams params) 添加一个指定布局参数的子视图 参数 child添加的子视图 index添加的子视图的索引 params子视图的布局参数 异常 IllegalStateException如果切换器中已经包含了两个视图时。 public ViewgetNextView() 返回下一个要显示的视图 返回 视图切换之后将要显示出的下一个视图 public voidreset() 重置视图转换器(ViewSwitcher)来隐藏所有存在的视图,并使转换器达到一次动画都还没有播放的状态。 public voidsetFactory(ViewSwitcher.ViewFactory factory) 设置用来生成将在视图转换器中切换的两个视图的工厂。也可以调用两次addView(android.view.View, int, android.view.ViewGroup.LayoutParams)来替代使用工厂的方法。 参数 factory用来生成转换器内容的视图工厂 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582545,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (40) —— RatingBar

正文 一、结构 public classRatingBarextendsAbsSeekBar java.lang.Object android.view.View android.widget.ProgressBar android.widget.AbsSeekBar android.widget.RatingBar 二、概述 RatingBar是基于SeekBar和ProgressBar的扩展,用星型来显示等级评定。使用RatingBar的默认大小时,用户可以触摸/拖动或使用键来设置评分,它有两种样式(小风格用ratingBarStyleSmall,大风格用ratingBarStyleIndicator),其中大的只适合指示,不适合于用户交互。 当使用可以支持用户交互的RatingBar时,无论将控件(widgets)放在它的左边还是右边都是不合适的。 只有当布局的宽被设置为wrapcontent时,设置的星星数量(通过函数setNumStars(int)或者在XML的布局文件中定义)将显示出来(如果设置为另一种布局宽的话,后果无法预知)。 次级进度一般不应该被修改,因为他仅仅是被当作星型部分内部的填充背景。 参见Form Stuff tutorial. 三、嵌套类 接口:RatingBar.OnRatingBarChangeListener 一个回调函数,当星级进度改变时修改客户端的星级。 四、XML属性 属性名称 描述 android:isIndicator RatingBar是否是一个指示器(用户无法进行更改) android:numStars 显示的星型数量,必须是一个整形值,像“100”。 android:rating 默认的评分,必须是浮点类型,像“1.2”。 android:stepSize 评分的步长,必须是浮点类型,像“1.2”。 五、公共方法 public int getNumStars () 返回显示的星型数量 返回值 显示的星型数量 public RatingBar.OnRatingBarChangeListener getOnRatingBarChangeListener () 返回值 监听器(可能为空)监听评分改变事件 public float getRating () 获取当前的评分(填充的星型的数量) 返回值 当前的评分 public float getStepSize () 获取评分条的步长 返回值 步长 public boolean isIndicator () 返回值 判断当前的评分条是否仅仅是一个指示器(注:即能否被修改) public void setIsIndicator (boolean isIndicator) 设置当前的评分条是否仅仅是一个指示器(这样用户就不能进行修改操作了) 参数 isIndicator Bool值,是否是一个指示器 public synchronized void setMax (int max) 设置评分等级的范围,从0到max 参数 max评分条最大范围。 public void setNumStars (int numStars) 设置显示的星型的数量。为了能够正常显示它们,建议将当前widget的布局宽度设置为 wrap content 参数 numStars星型的数量 public void setOnRatingBarChangeListener (RatingBar.OnRatingBarChangeListener listener) 设置当评分等级发生改变时回调的监听器 参数 listener 监听器 public void setRating (float rating) 设置分数(星型的数量) 参数 rating设置的分数 public void setStepSize (float stepSize) 设置当前评分条的步长(step size) 参数 stepSize评分条的步进。例如:如果想要半个星星,它的值为0.5。 六、受保护方法 protected synchronized voidonMeasure(int widthMeasureSpec, int heightMeasureSpec) 权衡view和content来决定它的宽度和高度的整齐。它被measure(int, int)调用并且应该被子类所覆盖,以便提供准确高效的布局测量。 规定:当覆盖这个方法的时候,你必须调用setMeasuredDimension(int, int)以便存储精确的视图的宽和高。如果不这样做的话将触发llegalStateException异常,被函数measure(int, int)抛出。调用父类onMeasure(int, int)是合理的。 尺寸的基本类的实现默认是背景大小,除非通过MeasureSpec允许大的尺寸。子类应该覆盖onMeasure(int, int)以便提供更好的布局大小。 如果这个方法被覆盖,子类应该负责确保标准的宽和高至少是视图的最小宽度和高度的值(分别为getSuggestedMinimumHeight()和getSuggestedMinimumWidth()两方法)。 参数 widthMeasureSpec受主窗口支配的水平空间要求。这个需求通过View.MeasureSpec.进行编码。 heightMeasureSpec受主窗口支配的垂直空间要求。这个需求通过View.MeasureSpec.进行编码。 七、补充 文章链接 Android控件之RatingBar评分条 Android更换RatingBar图片 [Android学习指南]RatingBar评分条 示例代码(代码转载自Android手机开发者论坛) Java文件 public class AndroidRatingBar extends Activity{ /** Calledwhentheactivityisfirstcreated. */ @Override public void onCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); setContentView(R.layout.main); final RatingBarratingBar_Small = (RatingBar)findViewById(R.id.ratingbar_Small); final RatingBarratingBar_Indicator = (RatingBar)findViewById(R.id.ratingbar_Indicator); final RatingBarratingBar_default = (RatingBar)findViewById(R.id.ratingbar_default); ratingBar_default.setOnRatingBarChangeListener( new RatingBar.OnRatingBarChangeListener(){ public void onRatingChanged(RatingBarratingBar, float rating, boolean fromUser){ ratingBar_Small.setRating(rating); ratingBar_Indicator.setRating(rating); Toast.makeText(AndroidRatingBar. this , " rating: " + String.valueOf(rating), Toast.LENGTH_LONG).show(); }}); } } XML文件 <? xmlversion="1.0"encoding="utf-8" ?> < LinearLayout xmlns:android ="http://schemas.android.com/apk/res/android" android:orientation ="vertical" android:layout_width ="fill_parent" android:layout_height ="fill_parent" > < TextView android:layout_width ="fill_parent" android:layout_height ="wrap_content" android:text ="@string/hello" /> < RatingBar android:layout_width ="wrap_content" android:layout_height ="wrap_content" style ="?android:attr/ratingBarStyleIndicator" android:id ="@+id/ratingbar_Indicator" /> < RatingBar android:layout_width ="wrap_content" android:layout_height ="wrap_content" style ="?android:attr/ratingBarStyleSmall" android:id ="@+id/ratingbar_Small" android:numStars ="20" /> < RatingBar android:layout_width ="wrap_content" android:layout_height ="wrap_content" style ="?android:attr/ratingBarStyle" android:id ="@+id/ratingbar_default" /> </ LinearLayout > 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582621,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (29) —— CompoundButton

正文 一、结构 public abstract classCompoundButtonextendsButtonimplementsCheckable java.lang.Objectandroid.view.Viewandroid.widget.TextViewandroid.widget.Button android.widget.CompoundButton 二、概述 一个带有选中/未选中状态的按钮。当按钮按下或点中时自动改变状态。 三、公共方法 public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event) 在子视图的构建时分派一个辅助事件。(译者注:通过源码可以看出,视图构建时设置其选中状态。) 参数 event 事件 返回值 如果事件全部完成返回True。 public boolean isChecked () (译者注:是否选中) public void onRestoreInstanceState (Parcelable state) 允许视图重新应用以前通过onSaveInstanceState()生成代表内部的状态。这个函数决不调用一个空的状态。 参数 state 返回以前调用onSaveInstanceState()保存下来的状态。 public Parcelable onSaveInstanceState () 允许视图生成一个代表内部的状态,以后可用于创建一个与之相同的新的实例。这种状态应该只包含非持久或以后不能够重建的信息。例如,你决不存储你当前在屏幕上的位置,因为这会在视图的层面上重新计算放置一个新的实例。 你可以存储到这里的一些例子:一个文本框中当前光标的位置(但通常不是文字本身,文字通常保存在内容提供者(content provider)或其他持久的储存中),一个列表视图中的当前选中项。 返回值 返回一个包含视图当前状态的Parcelable对象,或没有什么状态保存时返回null。默认实现返回null。 public boolean performClick () 如果视图定义了OnClickListener监听器,调用此方法来执行。 返回值 定义了的OnClickListener被调用返回True,否则返回False public void setButtonDrawable (Drawable d) 给按钮背景设置一个可绘制对象(如:图像) 参数 d 用作背景的可绘制对象(如:图像) public void setButtonDrawable (int resid) 通过资源Id给按钮背景设置一个图像 参数 resid 作为背景图像的资源id public void setChecked (boolean checked) 改变按钮的选中状态 参数 checked true选中,false非选中 public void setOnCheckedChangeListener (CompoundButton.OnCheckedChangeListener listener) 注册一个在按钮状态发生改变时执行的回调函数 参数 listener 当选中状态改变时调用的函数 public void toggle () 改变选中状态为当前状态的逆状态 四、受保护方法 protected void drawableStateChanged () 在视图状态的变化影响到所显示可绘制的状态时调用这个方法。 确保在重载时中调用父类方法 protected int[] onCreateDrawableState (int extraSpace) 为当前视图生成新的可绘图区状态。这个方式当缓存的图像绘图区状态确定失效时通过视图系统调用。你可以使用getDrawableState()方法重新取得当前的状态。 参数 extraSpace 如果为非零,这是你应该返回的数组在你可以存放你的状态的额外条目的数量。 返回值 返回一个记录着视图中当前绘图区状态的数组 protected void onDraw (Canvas canvas) 实现你自己的绘制。 参数 canvas 在画布上绘制背景 protected boolean verifyDrawable (Drawable who) 如果你的视图子类显示他自己的可视化对象,他将要重写此方法并且为了显示可绘制返回true。此操作允许进行绘制时有动画效果。 确认当重写从方法时,需调用父类相应方法。 参数 who 需判断的可绘制对象(Drawable)。如果是你要显示的对象,返回True,否则返回调用父类的结果。 返回值 boolean如果可绘制对象(Drawable)已经在视图中显示,返回True否则返回false。并且此处不允许使用动画。 结束 Android2.3即将发布,翻译组也将迅速跟进,已经翻译或正在翻译的将保持原有版本,新开始翻译的将直接从新版本开始。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582647,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android中文 API (31) —— TimePicker

正文 一、结构 public classTimePickerextendsFrameLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.TimePicker 二、概述 用于选择一天中时间的视图,支持24小时及上午/下午模式。小时,分钟及上午/下午(如果可用)都可以用垂直滚动条来控制。用键盘来输入小时。两个数的小时数可以通过输入两个数字来实现,例如在一定时间内输入‘1’和‘2’即选择了12点。分钟能显示输入的单个数字。在AM/PM模式下,用户可以输入'a', 'A"或'p', 'P'来选取。对于对话框视图,参见TimePickerDialog。 三、公共方法 public int getBaseline () 返回窗口空间的文本基准线到其顶边界的偏移量。如果这个部件不支持基准线对齐,这个方法返回-1/。 返回值 基准线的偏移量,如果不支持基准线对齐则返回-1。 public Integer getCurrentHour () 获取当前时间的小时部分。 返回值 当前小时(0-23) public Integer getCurrentMinute () 获取当前时间的分钟部分。 返回值 当前分钟。 public boolean is24HourView () 获取当前系统设置是否是24小时制。 返回值 如果是24小时制返回true,否则返回false。 public void setCurrentHour (Integer currentHour) 设置当前小时。 public void setCurrentMinute (Integer currentMinute) 设置当前分钟(0-59)。 public void setEnabled (boolean enabled) 设置可用的视图状态。可用的视图状态的解释在子类中改变。 参数 enabled如果可用为true,否则为false。 public void setIs24HourView (Boolean is24HourView) 设置是24小时还是上午/下午制。 参数 is24HourView True表示24小时制. False表示上午/下午制. public void setOnTimeChangedListener (TimePicker.OnTimeChangedListener onTimeChangedListener) 设置时间调整事件的回调函数。 参数 onTimeChangedListener回调函数,不能为空。 四、受保护方法 protected void onRestoreInstanceState (Parcelable state) 允许一个视图回复到之前用onSaveInstanceState()保存的状态,state参数不能为空。 参数 state之前调用onSaveInstanceState()返回的状态。 protected Parcelable onSaveInstanceState () 用来允许一个视图保存当前的内部状态,之后可以创建新的实例应用相同的状态。状态信息不能包含常量或在之后重新构造。例如,你永远不能保存在屏幕上的当前位置,因为当创建一个新的视图时,它将会被放置到它的层次结构中,它的位置会被重新计算。 你可以存储到这里的一些例子:一个文本框中当前光标的位置(但通常不是文字本身,文字通常保存在内容提供者(content provider)或其他持久的储存中),一个列表视图中的当前选中项。 返回值 返回一个包含视图当前状态的Parcelable对象,或没有什么状态保存时返回null。默认实现返回null。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582644,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (21) —— DigitalClock

正文 一、结构 public classDigitalClockextendsTextView java.lang.Object android.view.View android.widget.TextView android.widget.DigitalClock 二、 概述 像AnalogClock(),但是是数字的。显示秒。修正:分开显示小时/分钟/秒,均衡的字体不能够摆动显示。(译者注:根据字体按比例显示小时/分钟/秒,无法像AnalogClock转动显示) 三、 受保护方法 protected void onAttachedToWindow () 视图(DigitalClock)附在一个窗体上时调用。在这个点的表面进行绘制。注意这个方法保证在onDraw(Canvas)以前调用,但是它可以在第一次调用onDraw以前任何时间调用——包括onMeasure(int, int)之前或之后。 protected void onDetachedFromWindow () 视图(DigitalClock)从窗体上分离(移除)时调用。在这个点的表面不再有画面绘制。 四、补充 4.1 [Android1.5]DigitalClock自定义日期输出格式 4.2 使用代码 < DigitalClock android:id = " @+id/DigitalClock " android:layout_width = " wrap_content " android:layout_height = " wrap_content " /> 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582669,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (25) —— ZoomControls

正文 一、结构 public classZoomControlsextendsLinearLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.LinearLayout android.widget.ZoomControls 二、概述 ZoomControls显示一个简单的设置来控制缩放并回调已注册的事件。 三、 公共方法 public boolean hasFocus () 如果这个视图获得了焦点就返回真。 返回值 如果这个视图获得了焦点就返回真。 public void hide () 这个方法可以将zoomControl视图隐藏起来,不显示。 public boolean onTouchEvent (MotionEvent event) 这个方法处理触摸屏移动事件。 参数 event该移动事件. 返回值 如果是true,该事件是触摸,反之返回false。 public void setIsZoomInEnabled (boolean isEnabled) 这个方法可以设置放大按钮是否可用。 参数 isEnabled如果是true,放大按钮可用,反之不可用(按钮变成灰色)。 public void setIsZoomOutEnabled (boolean isEnabled) 这个方法可以设置缩小按钮是否可用。 参数 isEnabled如果是true缩小按钮可用,反之不可用(按钮变成灰色)。 public void setOnZoomInClickListener (View.OnClickListener listener) 注册放大监听器 参数 Listener点击放大按钮事件触发的事件。(译者注:为OnClickListener的实例,可以复写onClick方法,里面为具体的响应动作。我感觉这个方法还有下面的方法是本类的重点,我们可以在里面实现相应的动作,来响应我们的事件。) public void setOnZoomOutClickListener (View.OnClickListener listener) 注册缩小监听器 参数 Listener点击缩小按钮事件触发的事件。(译者注:为OnClickListener的实例,可以复写onClick方法,里面为具体的响应动作。) public void setZoomSpeed (long speed) 设置缩放速度。 参数 Speed缩放速度 public void show () 这个方法和hide方法对应,用来显示ZoomControl。 四、 补充 4.1 文章链接 [荐]Android控件之ZoomControls缩放控件 地图时让ZoomContrls一直显示 [荐]ZoomControls在Google Map中的使用 4.2 示例代码(译者声明:这个代码部分思路来源于网络上一个博客,谨以此来解释,特此声明。) 4.2.1 java文件 public class ZoomCotroltest extends Activity{ @Override protected void onCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); this .setContentView(R.layout.main); setTitle( " ZoomControls " ); ZoomControlszoomControls = (ZoomControls) this .findViewById(R.id.zoomControls); zoomControls.hide(); zoomControls.show(); // setOnZoomInClickListener()-响应单击放大按钮的事件 zoomControls.setIsZoomInEnabled( true ); zoomControls.setIsZoomOutEnabled( true ); zoomControls.setOnZoomInClickListener( new OnClickListener(){ public void onClick(Viewv){ Toast.makeText(ZoomCotroltest. this , " 单击了放大按钮 " ,Toast.LENGTH_SHORT).show(); } }); // setOnZoomOutClickListener()-响应单击缩小按钮的事件 zoomControls.setOnZoomOutClickListener( new OnClickListener(){ public void onClick(Viewv){ Toast.makeText(ZoomCotroltest. this , " 单击了缩小按钮 " ,Toast.LENGTH_SHORT).show(); } }); } } 4.2.2 xml文件 <? xmlversion="1.0"encoding="utf-8" ?> < LinearLayout xmlns:android ="http://schemas.android.com/apk/res/android" android:orientation ="vertical" android:layout_width ="fill_parent" android:layout_height ="fill_parent" > <!-- 放大/缩小按钮控件 --> < ZoomControls android:id ="@+id/zoomControls" android:layout_width ="wrap_content" android:layout_height ="wrap_content" > </ ZoomControls > </ LinearLayout > 4.2.3 代码下载 /Files/over140/2010/10/demo_ZoomControls.rar 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582657,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (18) —— AbsSeekBar

正文 一、结构 publicabstractclassAbsSeekBarextendsProgressBar java.lang.Object android.view.View android.widget.ProgressBar android.widget.AbsSeekBar 二、类概述 此类为抽象类。供拖动条SeekBar和评分条RatingBar继承。 三、 公共方法 public int getKeyProgressIncrement () 返回方向键改变后的进度值 默认情况下此值是根据最大值而得出的。 返回值 当用户按下方向键后减少或增加之后的进度值。这个进度值是正数。 public int getThumbOffset () 参见 setThumbOffset(int) public boolean onKeyDown (int keyCode, KeyEvent event) 默认实现KeyEvent.Callback.onKeyMultiple():如果视图已启用并且可点击,当KEYCODE_DPAD_CENTER或者KEYCODE_ENTER被释放时,执行按下(Down)此视图的操作。 参数 keyCode KeyEvent中用于表示按键被按下的识别码 event按键操作中定义的KeyEvent对象 返回值 假如你已经处理了当前事件,返回true。假如你想继续让下一个事件接收者(receiver)处理,则返回false; public boolean onTouchEvent (MotionEvent event) 实现这个方法来处理触摸屏幕引发的事件。 参数 event动作事件 返回值 如果事件已经处理返回True,否则返回false。 public void setKeyProgressIncrement (int increment) 设置使用方向键更改进度时每次的增加值(注:设置此值后,使用按键修改进度值时,每次增加或减少increment大小的幅度) 参数 increment The amount to increment or decrement when the user presses the arrow keys. increment当用户按下指示键时增加或减少的值 public synchronized void setMax (int max) 设置进度条的范围,从0到max 参数 max进度条的最大值 public void setThumb (Drawable thumb) 设置可绘制对象thumb为SeekBar中显示的进度表的结束位置的图案(注:例如下图) 如果thumb是一个有效的可绘制对象(例如不是null值),那么需要设置thumb的偏移量为他的一半宽度(参见setThumbOffset(int)) 参数 thumb可绘制对象 public void setThumbOffset (int thumbOffset) 设置thumb的偏移量允许thumb扩展超出轨道的范围 参数 thumbOffset以像素为单位的偏移量 (注:例如下图,两图同样取SeekBar的最大值) 默认Offset为thumb的一半时: setThumbOffset(0)时: 四、 受保护方法 protected boolean verifyDrawable (Drawable who) 如果你的视图子类显示他自己的可视化对象,他将要重写此方法并且为了显示可绘制返回true。此操作允许进行绘制时有动画效果。 确认当重写从方法时,需调用父类相应方法。(注:即记得调用super.verifyDrawable(who)) 参数 who需判断的可绘制对象(Drawable)。如果是你要显示的对象,返回True,否则返回调用父类的结果。 返回值 如果可绘制对象(Drawable)已经在视图中显示,返回True否则返回false。并且此处不允许使用动画。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582681,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android API 中文(13) —— ToggleButton

正文 一、结构 public classToggleButton extendsCompoundButton java.lang.Object android.view.View android.widget.TextView android.widget.Button android.widget.CompoundButton android.widget.ToggleButton 二、 类概述 通过一个带有亮度指示同时默认文本为“ON”或“OFF”的按钮显示选中/未选中状态。 三、XML属性 属性名称 描述 android:disabledAlpha 设置按钮在禁用时透明度。 android:textOff 未选中时按钮的文本 android:textOn 选中时按钮的文本 四、公共方法 public CharSequence getTextOff () 返回按钮未选中时的文本。 返回值 文本 public CharSequence getTextOn () 返回按钮选中时的文本。 返回值 文本 public void setBackgroundDrawable (Drawable d) 设置指定的可绘制(译者注:如图片)为背景,或删除背景。如果让背景有边距,这个视图的边距就是背景的边距。然而,当背景被删除时,这个视图的边距不能被触摸。如果需要设置边距,请使用方法setPadding(int, int, int, int)。 (译者注:如果设置删除背景整个就不显示了,此外设置背景后选中和被选中的图片也不显示了,如下图:,实现代码: ) 参数 d 设置可绘制(译者注:如图片)为背景,或设置为空删除背景。 public void setChecked (boolean checked) 改变按钮的选中状态。 参数 checked true让按钮选中,false让按钮不选中 public void setTextOff (CharSequence textOff) 设置按钮未选中时显示的文本。 参数 textOff 文本 public void setTextOn (CharSequence textOn) 设置按钮选中时显示的文本。 参数 textOn 文本 五、受保护方法 protected void drawableStateChanged () 在视图状态的变化影响到所显示可绘制的状态时调用这个方法。 确保在覆盖时中调用父类方法(译者注:super. drawableStateChanged ())。 protected void onFinishInflate () XML文件加载视图完成时调用。这个函数在加载的最后阶段被调用,所有的子视图已经被添加。 即使子类重写了onFinishInflate方法,也应该始终确保调用父类方法(译者注:super. onFinishInflate()),使系统能够调用。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582691,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (28) —— CheckedTextView

正文 一、结构 public classCheckedTextViewextendsTextViewimplementsCheckable java.lang.Object android.view.View android.widget.TextView android.widget.CheckedTextView 二、概述 类CheckedTextView继承TextView并实现Checkable接口。当ListView的setChoiceMode方法并设定为CHOICE_MODE_SINGLE或者CHOICE_MODE_MULTIPLE,而非CHOICE_MODE_NONE时,使用此类是很有用的。 三、 公共方法 public boolean dispatchPopulateAccessibilityEvent (AccessibilityEvent event) 在子视图的构建时分派一个辅助事件。(译者注:通过源码可以看出,视图构建时设置其选中状态。) 参数 event事件 返回值 如果事件处理完成,则返回true public boolean isChecked () 是否选中。 public void setCheckMarkDrawable (Drawable d) 为一个给定的Drawable设定检查标记。当isChecked()为true时则绘制 参数 d用于检查标记的Drawable public void setCheckMarkDrawable (int resid) 为一个给定的Drawable设定检查标记,使用它的资源id来标识。当isChecked()为true时则绘制 参数 resid 用于检查标记的Drawable public void setChecked (boolean checked) 改变文本视图的选中状态 参数 checked选中文本返回true,未选中返回false public void setPadding (int left, int top, int right, int bottom) 设置页边距。视图可能会增加一些必要的空间用于显示滚动条,并依赖滚动条的类型和可见性。因此,设定的值用于回调getPaddingLeft(), getPaddingTop(), getPaddingRight()和getPaddingBottom()时则返回不同的值 参数 left左边距(使用“像素”单位) top上边距(使用“像素”单位) right右边距(使用“像素”单位) bottom 下边距(使用“像素”单位) public void toggle () 反转当前视图的选中状态 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582649,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android 中文 API (19) —— TwoLineListItem

正文 一、结构 public classTwoLineListItemextendsRelativeLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.RelativeLayout android.widget.TwoLineListItem 二、 概述 这个布局是用在ListView中的,有两个子View。每一项有两个ID值为text1和text2的TextView的元素。也有一个ID是selecteIcon的元素,这个元素可以是任何View的子类(最典型的就是ImageView)。支持标准的布局资源文件(不包含所选择的icon),但是你可以为这个对象自己定义XML布局文件。 三、 XML属性 属性名称 描述 android:mode 布局模式:oneLine一行collapsing折叠twoLine两行 四、 公共方法 Public TextView getText1 () 返回ID为Text1的TextView对象 返回值 TextView Public TextView getText2 () 返回ID为Text1的TextView对象 返回值 TextView 五、 受保护方法 protected void onFinishInflate () 初始化XML布局。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582679,如需转载请自行联系原作者

优秀的个人博客,低调大师

android api 中文 (73)—— AdapterView

正文 一、结构 public abstract classAdapterView<T extendsAdapter> extendsViewGroup java.lang.Object android.view.View android.view.ViewGroup android.widget.AdapterView<T extends android.widget.Adapter> 直接子类 AbsListView,AbsSpinner 间接子类 ExpandableListView,Gallery,GridView,ListView,Spinner 二、概述 AdapterView是内容由Adapter来决定的视图类。 参见ListView、GridView、Spinner和Gallery等常见子类。 三、常量 public static final int INVALID_POSITION 代表无效的位置。有效值的范围是 0 到当前适配器项目数减 1 。 常量值:-1 (0xffffffff) public static final long INVALID_ROW_ID 代表空或者无效的行ID。 常量值:-9223372036854775808 (0x8000000000000000) public static final int ITEM_VIEW_TYPE_HEADER_OR_FOOTER 当条项是列表头或列表尾时,调用getItemViewType(int)函数的返回值。 常量值:-2 (0xfffffffe) public static final int ITEM_VIEW_TYPE_IGNORE 当适配器禁止条项的视图再利用时,调用getItemViewType(int)函数的返回值。 常量值:-1 (0xffffffff) 四、构造函数 publicAdapterView(Contextcontext) 构造函数 publicAdapterView(Contextcontext,AttributeSetattrs) 构造函数 publicAdapterView(Contextcontext,AttributeSetattrs, int defStyle) 构造函数 五、公共方法 public voidaddView(Viewchild) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 child 忽略 异常 UnsupportedOperationException调用该方法时 public voidaddView(Viewchild, int index) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 child 忽略。 index忽略。 抛出 UnsupportedOperationException调用该方法时 public voidaddView(Viewchild, int index,ViewGroup.LayoutParamsparams) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 child 忽略。 index 忽略。 params 忽略。 抛出 UnsupportedOperationException调用该方法时 public voidaddView(Viewchild,ViewGroup.LayoutParamsparams) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 child 忽略。 params 忽略。 抛出 UnsupportedOperationException调用该方法时 public booleandispatchPopulateAccessibilityEvent(AccessibilityEventevent) 分发AccessibilityEvent事件到该视图的子视图中。 参数 event 事件。 返回值 如果事件分发完成,返回真。 public abstract TgetAdapter() 返回当前与该小部件关联的适配器。 返回值 用于提供视图内容的适配器。 public intgetCount() 返回值 与AdapterView相关联的适配器的条目数量。(该值是数据条目的数量,可能大于可见的视图的数量。) publicViewgetEmptyView() 当前适配器无内容时,AdapterView 会显示特殊的空视图。 空视图用于告诉用户,该 AdapterView 没有数据。 返回值 适配器为空时显示的视图。 public intgetFirstVisiblePosition() 返回显示在屏幕上的第一个元素在适配器中所处的位置。 返回值 在适配器数据集中的位置。 publicObjectgetItemAtPosition(int position) 取得列表中指定位置的数据。 参数 position要取得数据的位置。 返回值 列表中指定位置的数据。 public longgetItemIdAtPosition(int position) (译者注:关于此方法的分析,参见这里。) public intgetLastVisiblePosition() 返回显示在屏幕上的最后一个元素在适配器中所处的位置。 返回值 在适配器数据集中的位置。 public finalAdapterView.OnItemClickListenergetOnItemClickListener() 返回值 点击AdapterView中的条目时执行的回调函数;没有设置时返回空。 public finalAdapterView.OnItemLongClickListenergetOnItemLongClickListener() 返回值 取得长按AdapterView中的条目时执行的回调函数的监听器;未设置则返回空。 public finalAdapterView.OnItemSelectedListenergetOnItemSelectedListener() public intgetPositionForView(Viewview) 取得适配器项目对应的视图或其子视图在适配器的数据中所处的位置。 参数 view 适配器条目或其后代的视图。调用时该项目在AdapterView中必须可见。 返回值 视图在适配器数据集中的位置;如果视图不在数据列表中或当前不可见,则返回INVALID_POSITION。 publicObjectgetSelectedItem() 返回值 当前选中条目对应的数据;无选中条目时返回空。 public longgetSelectedItemId() 返回值 当前选中条目相应的ID;无选中条目则返回INVALID_ROW_ID。 public intgetSelectedItemPosition() 返回当前选中项目在适配器数据中的位置。 返回值 返回从零开始的位置(索引)信息,没有选择条目时返回INVALID_POSITION。 public abstractViewgetSelectedView() 返回值 当前选中条目对应的视图;无选中条目时返回空。 public booleanperformItemClick(Viewview, int position, long id) 如果定义了OnItemClickListener则调用它。 参数 view AdapterView中被点击的视图。 position视图在适配器中的索引。 id点击的条目的行ID。 返回值 如果成功调用了定义的OnItemClickListener则返回真;否则返回假。 public voidremoveAllViews() 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 抛出 UnsupportedOperationException调用该方法时 public voidremoveView(Viewchild) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 child忽略。 抛出 UnsupportedOperationException调用该方法时 public voidremoveViewAt(int index) 该类不支持该方法,如果调用将抛出UnsupportedOperationException异常。 参数 index 忽略。 抛出 UnsupportedOperationException调用该方法时 public abstract voidsetAdapter(T adapter) 设置用于为该小部件的视图提供用于显示的数据的适配器。 参数 adapter用于创建视图内容的适配器。 public voidsetEmptyView(ViewemptyView) 设置适配器内容为空时显示的视图。 public voidsetFocusable(boolean focusable) 设置该视图是否可以获取焦点。 设为假时,可以确保在触控模式中该视图不能得到焦点。 参数 focusable 设为真时,该视图可以得到焦点。 public voidsetFocusableInTouchMode(boolean focusable) 设置在触控模式下该视图是否可以获取焦点。设为真时,可以保证视图可以得到焦点。 参数 focusable 设为真时,该视图在触控模式下可以得到焦点。 public voidsetOnClickListener(View.OnClickListenerl) 注册点击该视图时执行的回调函数。如果该视图不可点击,会将其改为可以点击的状态。 参数 l 事件发生时运行的回调函数。 public voidsetOnItemClickListener(AdapterView.OnItemClickListenerlistener) 注册单击AdapterView中的条目时执行的回调函数。 参数 listener 将要调用的回调。 public voidsetOnItemLongClickListener(AdapterView.OnItemLongClickListenerlistener) 注册长按AdapterView中的条目时执行的回调函数。 参数 listener 事件发生时运行的回调函数。 public voidsetOnItemSelectedListener(AdapterView.OnItemSelectedListenerlistener) 注册选中AdapterView中的条目时执行的回调函数。 参数 listener 事件发生时运行的回调函数。 public abstract voidsetSelection(int position) 设置当前选择条目。为了支持无障碍功能,重写该方法的子类必须首先调用父类的该方法。 参数 position选择的数据条目的索引(从零开始)。 六、保护方法 protected booleancanAnimate() 指示视图组是否能够在首次布局后为其子视图提供动画效果的显示。 返回值 如果子视图可以使用动画效果则返回真,否则返回假。 protected voiddispatchRestoreInstanceState(SparseArray<Parcelable> container) 为了防止适配器生成的视图被解冻而重写。 参数 container保存有之前存储的状态信息的SparseArray。 protected voiddispatchSaveInstanceState(SparseArray<Parcelable> container) 为了防止适配器生成的视图被冻结而重写。 参数 container保存视图状态的SparseArray。 protected voidonLayout(boolean changed, int left, int top, int right, int bottom) 该视图设置其子视图的大小及位置时调用。派生类可以重写此方法,并为其子类布局。 参数 changed是否为视图设置了新的大小和位置。 left相对于父视图的左侧的位置。 top相对于父视图的顶部的位置。 right相对于父视图的右侧的位置。 bottom相对于父视图的底部的位置。 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582515,如需转载请自行联系原作者

优秀的个人博客,低调大师

android 中文 api (64) —— Scroller

正文 一、结构 public classScrollerextendsObject java.lang.Object android.widget.Scroller 二、概述 这个类封装了滚动操作。滚动的持续时间可以通过构造函数传递,并且可以指定滚动动作的持续的最长时间。经过这段时间,滚动会自动定位到最终位置,并且通过computeScrollOffset()会得到的返回值为false,表明滚动动作已经结束。 三、构造函数 publicScroller(Contextcontext) 使用缺省的持续持续时间和动画插入器创建一个Scroller。(译者注:interpolator这里翻译为动画插入器,见这里。) publicScroller(Contextcontext,Interpolatorinterpolator) 根据指定的动画插入器创建一个Scroller,如果指定的动画插入器为空,则会使用缺省的动画插入器(粘滞viscous)创建。 四、公共方法 public voidabortAnimation() 停止动画。与forceFinished(boolean)相反,Scroller滚动到最终x与y位置时中止动画。 参见 forceFinished(boolean) public booleancomputeScrollOffset() 当想要知道新的位置时,调用此函数。如果返回true,表示动画还没有结束。位置改变以提供一个新的位置。 public voidextendDuration(int extend) 延长滚动动画时间。此函数允许当使用setFinalX(int)orsetFinalY(int)时,卷动动作持续更长时间并且卷动更长距离。 参数 extend卷动事件延长的时间,以毫秒为单位 参见 setFinalX(int) setFinalY(int) public voidfling(int startX, int startY, int velocityX, int velocityY, int minX, int maxX, int minY, int maxY) 在fling(译者注:快滑,用户按下触摸屏、快速移动后松开)手势基础上开始滚动。滚动的距离取决于fling的初速度。 参数 startX滚动起始点X坐标 startY滚动起始点Y坐标 velocityX当滑动屏幕时X方向初速度,以每秒像素数计算 velocityY当滑动屏幕时Y方向初速度,以每秒像素数计算 minX X方向的最小值,scroller不会滚过此点。 maxX X方向的最大值,scroller不会滚过此点。 minY Y方向的最小值,scroller不会滚过此点。 maxY Y方向的最大值,scroller不会滚过此点。 public final voidforceFinished(boolean finished) 强制终止的字段到特定值。(译者注:立即停止滚动?) 参数 finished新的结束值 public final intgetCurrX() 返回当前滚动X方向的偏移 返回值 距离原点X方向的绝对值 public final intgetCurrY() 返回当前滚动Y方向的偏移 返回值 距离原点Y方向的绝对值 public final intgetDuration() 返回滚动事件的持续时间,以毫秒计算。 返回值 滚动持续的毫秒数 public final intgetFinalX() 返回滚动结束位置。仅针对“fling”手势有效 返回值 最终位置X方向距离原点的绝对距离 public final intgetFinalY() 返回滚动结束位置。仅针对“fling”操作有效 返回值 最终位置Y方向距离原点的绝对距离 public final intgetStartX() 返回滚动起始点的X方向的偏移 返回值 起始点在X方向距离原点的绝对距离 public final intgetStartY() 返回滚动起始点的Y方向的偏移 返回值 起始点在Y方向距离原点的绝对距离 public final booleanisFinished() 返回scroller是否已完成滚动。 返回值 停止滚动返回true,否则返回false public voidsetFinalX(int newX) 设置scroller的X方向终止位置 参数 newX新位置在X方向距离原点的绝对偏移。 参见 extendDuration(int) setFinalY(int) public voidsetFinalY(int newY) 设置scroller的Y方向终止位置 参数 newY新位置在Y方向距离原点的绝对偏移。 参见 extendDuration(int) setFinalY(int) public voidstartScroll(int startX, int startY, int dx, int dy) 以提供的起始点和将要滑动的距离开始滚动。滚动会使用缺省值250ms作为持续时间。 参数 startX水平方向滚动的偏移值,以像素为单位。负值表明滚动将向左滚动 startY垂直方向滚动的偏移值,以像素为单位。负值表明滚动将向上滚动 dx水平方向滑动的距离,负值会使滚动向左滚动 dy垂直方向滑动的距离,负值会使滚动向上滚动 public voidstartScroll(int startX, int startY, int dx, int dy, int duration) 以提供的起始点和将要滑动的距离开始滚动。 参数 startX水平方向滚动的偏移值,以像素为单位。负值表明滚动将向左滚动 startY垂直方向滚动的偏移值,以像素为单位。负值表明滚动将向上滚动 dx水平方向滑动的距离,负值会使滚动向左滚动 dy垂直方向滑动的距离,负值会使滚动向上滚动 duration滚动持续时间,以毫秒计。 public inttimePassed() 返回自滚动开始经过的时间 返回值 经过时间以毫秒为单位 五、补充 文章精选 Scroller粗浅理解 ScrollTextView - scrolling TextView for Android 示例代码 创建工程MyScroler,或者将下类名“MyScroler”改为自己创建的工程,将下面代码直接覆盖生成的.java文件运行即可: package my.Scroller; import android.app.Activity; import android.os.Bundle; import android.view.View; import android.view.View.OnClickListener; import android.widget.Button; import android.widget.LinearLayout; import android.widget.Scroller; public class MyScroler extends Activity{ /** Calledwhentheactivityisfirstcreated. */ LinearLayoutlay1,lay2,lay; private ScrollermScroller; private boolean s1,s2; @Override public void onCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); mScroller = new Scroller( this ); lay1 = new LinearLayout( this ){ @Override public void computeScroll(){ if (mScroller.computeScrollOffset()){ scrollTo(mScroller.getCurrX(), 0 ); postInvalidate(); } } }; lay2 = new LinearLayout( this ){ @Override public void computeScroll(){ if (mScroller.computeScrollOffset()){ // mScrollX=mScroller.getCurrX(); scrollTo(mScroller.getCurrX(), 0 ); postInvalidate(); } } }; lay1.setBackgroundColor( this .getResources().getColor(android.R.color.darker_gray)); lay2.setBackgroundColor( this .getResources().getColor(android.R.color.white)); lay = new LinearLayout( this ); lay.setOrientation(LinearLayout.VERTICAL); LinearLayout.LayoutParamsp0 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT); this .setContentView(lay,p0); LinearLayout.LayoutParamsp1 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT); p1.weight = 1 ; lay.addView(lay1,p1); LinearLayout.LayoutParamsp2 = new LinearLayout.LayoutParams(LinearLayout.LayoutParams.FILL_PARENT,LinearLayout.LayoutParams.FILL_PARENT); p2.weight = 1 ; lay.addView(lay2,p2); Buttontx = new Button( this ); Buttontx2 = new Button( this ); tx.setText( " Button1 " ); tx2.setText( " Button2 " ); tx.setOnClickListener( new OnClickListener(){ @Override public void onClick(Viewv){ if ( ! s1){ mScroller.startScroll( 0 , 0 , 5 , 10 , 10 ); s1 = true ; } else { mScroller.startScroll( 0 , 0 , - 50 , - 10 , 10 ); s1 = false ; } } }); tx2.setOnClickListener( new OnClickListener(){ @Override public void onClick(Viewv){ if ( ! s2){ mScroller.startScroll( 0 , 0 , 5 , 20 , 10 ); s2 = true ; } else { mScroller.startScroll( 20 , 20 , - 50 , - 20 , 10 ); s2 = false ; } } }); lay1.addView(tx); lay2.addView(tx2); } } 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582535,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android API 中文 (53) —— BaseAdapter

正文 一、结构 public abstract classBaseAdapter extendsObject implementsListAdapter SpinnerAdapter java.lang.Object android.widget.BaseAdapter 直接子类 ArrayAdapter<T>, CursorAdapter, SimpleAdapter 间接子类 ResourceCursorAdapter, SimpleCursorAdapter 二、概述 用于ListView(实现指定的ListAdapter接口)和Spinner(实现指定的SpinnerAdapter接口)的共同实现一个公共基类适配器。 三、公共方法 public abstract booleanareAllItemsEnabled() 在ListAdapter中所有的项目都是可用的?如果是,则代表所有的项目都是可选择,可用鼠标点击的。 返回值 如果所有项目是可用的返回真 public abstractViewgetDropDownView(int position,ViewconvertView,ViewGroupparent) 获得一个在指定位置上显示下拉弹出数据的视图。 参数 position想得到项目视图的索引 convertView如果可能旧有的视图重新使用。注解:在使用之前应该检查这个视图不是空的并且类型合适。如果转换视图显示正确的数据是不可能的,这个方法能够创建一个新的视图 parent视图最终将依附的父对象。 返回值 一个对应指定位置的数据的视图。 public intgetItemViewType(int position) 获取通过getView为指定项目创建的视图的类型。 参数 position在adapter数据里我们想知道视图类型的项目的位置 返回值 一个整形的视图类型的描述。如果一个视图通过getView(int, View, ViewGroup)方法转换成另一个视图,则两个视图将共享同一类型。注意:整形必须在0和getViewTypeCount()– 1之间。IGNORE_ITEM_VIEW_TYPE也可以返回。 public intgetViewTypeCount() 返回通过getView(int, View, ViewGroup))创建的视图的类型数量。每一个类型表示一组通过getView(int, View, ViewGroup)方法转换过的视图。如果adapter针对所有项目返回相同的视图类型,这个方法返回1。 这个方法仅仅当adapter设置在AdapterView时调用。 返回值 通过这个adapter创建的视图类型的数量 public booleanhasStableIds() 表明是否项目ID时对基础数据的变化保持稳定的。 返回值 如果相同的ID指相同的对象,返回真 public booleanisEmpty() adapter数据项是否等于零 public booleanisEnabled(int position) 如果指定的位置不是一个隔离项目(隔离项目是一个不可选择,不可用鼠标点击的项目)则返回真。如果位置是无效的,其结果将是不确定的。在这种情况下一个ArrayIndexOutOfBoundsException(越界)异常将抛出 参数 position项目的索引 返回值 如果这个项目不是一个隔离项目则返回真。 public voidnotifyDataSetChanged() 通知附属的视图基础数据已经改变,视图应该自动刷新。 public voidnotifyDataSetInvalidated() 监控数据的observer不再有效 public voidregisterDataSetObserver(DataSetObserverobserver) 注册一个用于adapter的observer(观察者:监控数据发生改变时被调用) 参数 observer当数据发生改变时得到通知的对象 public voidunregisterDataSetObserver(DataSetObserverobserver) 移除先前通过registerDataSetObserver(DataSetObserver)方法注册过的observer(观察者:监控数据发生改变的类) 参数 observer移除注册的对象 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582575,如需转载请自行联系原作者

优秀的个人博客,低调大师

Android API 中文 (51) —— ZoomButtonsController

正文 一、结构 public classZoomButtonsController extendsViewimplementsView.OnTouchListener java.lang.Object android.widget.ZoomButtonsController 二、概述 ZoomButtonsController处理缩放控件的显示和隐藏并且定位其在相关父视图的位置。他也可以做为缩放控件的容器,允许在缩放控制窗口里面显示一些附加的按钮。 通常情况下,客户端在按下或者移动显示容器需要调用setVisible(ture)方法(不需要调用setVisible(false),来隐藏空间,因为当时间超时,它会自动隐藏),同时,当拥有者不能再进一步缩放的时候,客户端应该调setZoomInEnabled(boolean)和setZoomOutEnabled(boolean) 来及时更新。 如果你需要和自定义视图搭配使用,请在onDetachedFromWindow()方法中调用setVisible(false)。 三、构造函数 publicZoomButtonsController(View ownerView) ZoomButtonsController的构造函数 参数 ownerView被缩放控件进行缩放的可视控件,缩放控件显示将和可视控件保持一致 四、公共方法 public ViewGroupgetContainer() 获取缩放控件的父容器。 客户端可以增加其他的可视控件,和缩放控件一起放到这个容器中 返回 缩放控件的容器,它的布局将和它子控件的布局保持一致 public ViewgetZoomControls() 获取缩放控件的视图 返回 缩放控件视图 public booleanisAutoDismissed() 获取缩放控件是否显示后自动关闭 返回 缩放控件是否显示后自动关闭 public booleanisVisible() 缩放控件是否对用户可视 返回 true或者false public voidsetAutoDismissed(boolean autoDismiss) 设置缩放控件是否显示后自动关闭 参数 AutoDismiss true或者false public voidsetFocusable(boolean focusable) 设置缩放控件是否获取焦点,如果控件获取焦点,就是可以使用轨迹球和方向键进行操作,否则,只能触摸进行操作 参数 focusableTrue和false public voidsetOnZoomListener(ZoomButtonsController.OnZoomListener listener) 设置ZoomButtonsController.OnZoomListener侦听接收回调进行缩放 参数 listener介绍是否缩放的侦听器 public voidsetVisible(boolean visible) 设置缩放控件是否对用户可视 参数 visible缩放控件是否对用户可视(true或者false) public voidsetZoomInEnabled(boolean enabled) 是否允许空间放大 参数 enabled是否允许空间放大(true或者false) public voidsetZoomOutEnabled(boolean enabled) 是否允许控件缩小 参数 enabled是否允许控件缩小(true或者false) public voidsetZoomSpeed(long speed) 设置用户操作缩放按钮到缩放回调的延迟时间 参数 speed以毫秒为单位的缩放回调的间隔时间 五、补充 文章精选 Android Google map使用心得 googlemap加载多个overlay内存溢出 示例代码 本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/582579,如需转载请自行联系原作者

资源下载

更多资源
Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring

Spring框架(Spring Framework)是由Rod Johnson于2002年提出的开源Java企业级应用框架,旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念,提供核心容器、应用上下文、数据访问集成等模块,支持整合Hibernate、Struts等第三方框架,其适用范围不仅限于服务器端开发,绝大多数Java应用均可从中受益。

Sublime Text

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能,例如代码缩略图,Python的插件,代码段等。还可自定义键绑定,菜单和工具栏。Sublime Text 的主要功能包括:拼写检查,书签,完整的 Python API , Goto 功能,即时项目切换,多选择,多窗口等等。Sublime Text 是一个跨平台的编辑器,同时支持Windows、Linux、Mac OS X等操作系统。

用户登录
用户注册