首页 文章 精选 留言 我的

精选列表

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

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，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

Android API 中文 （50） —— SpinnerAdapter

正文 一、结构 public interfaceSpinnerAdapterextendsAdapter 直接子类 ArrayAdapter<T>, BaseAdapter, CursorAdapter, ResourceCursorAdapter, SimpleAdapter, SimpleCursorAdapter 二、概述 扩展自Adapter的适配器是在Spinner与数据之间的一座桥梁。一个Spinner Adapter允许定义两个不同的视图：一是在Spinner上显示数据，另一个是当Spinner按下时在下拉列表里显示数据。 三、公共方法 public abstractViewgetDropDownView(int position,ViewconvertView,ViewGroupparent) 获得一个在指定位置上显示下拉弹出数据的视图。 参数 position项目视图的索引 convertView如果可能旧有的视图重新使用。注解：在使用之前应该检查这个视图不是空的并且类型合适。如果转换视图显示正确的数据是不可能的，这个方法能够创建一个新的视图 parent视图最终将依附的父对象 返回值 一个对应指定位置的数据的视图 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582583，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

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，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

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，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

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，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

Android中文API(117)——WrapperListAdapter

正文 一、结构 public interfaceWrapperListAdapter implementsListAdapter android.widget. WrapperListAdapter 间接子类 HeaderViewListAdapter 二、概述 封装了另一个列表适配器的列表适配器。调用getWrappedAdapter()可以取得封装在其中的适配器。 参见 ListView 三、公共方法 public abstract ListAdaptergetWrappedAdapter() 返回封装在列表适配器中的适配器。 返回值 封装在该适配器中的ListAdapter。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582351，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

Android中文API(114)——TabWidget

正文 一、结构 public classTabWidget extendsLinearLayout implementsView.OnFocusChangeListener java.lang.Object android.view.View android.view.ViewGroup android.widget.LinearLayout android.widget.TabWidget 二、概述 显示选项卡标签的列表，用于代表父选项卡集合的每一页。当前widget的容器对象是TabHost。当用户选择一个选项卡时，此对象给父容器对象TabHost发送一个消息，告诉TabHost切换到对应的页面显示。此对象上的很多方法，你通常不会直接使用。容器TabHost被用来添加标签，添加并管理回调函数。你可能会调用此对象以迭代选项卡列表，或者调整选项卡列表的布局，但大多数方法应该是通过容器TabHost对象调用。 参见Tab Layout tutorial。 三、XML属性 属性名称 描述 android:divider 可绘制对象，被绘制在选项卡窗口间充当分割物。 android:tabStripEnabled 确定是否在选项卡绘制 android:tabStripLeft 被用来绘制选项卡下面的分割线左边部分的可视化对象。 android:tabStripRight 被用来绘制选项卡下面的分割线右边部分的可视化对象。 四、公共方法 public voidaddView(View child) 增加子视图。如果子视图没有设置布局参数，那么将为子视图设置此ViewGroup默认的布局参数。 参数 child新增的子视图 public voidchildDrawableStateChanged(View child) 如果调用addStatesFromChildren函数返回true，刷新此组的可视化对象的状态（包括它的子元素的状态）。 参数 child可视化对象状态被改变的子元素。 public voiddispatchDraw(Canvas canvas) 绘制时调用此方法来绘制子视图。派生类在被绘制之前，为获取控制可能会重写此方法（但必须在它自己的视图已经被绘制之后）。 参数 canvas绘制视图的画布(canvas) public voidfocusCurrentTab(int index) 设置当前选项卡并且让其获得焦点。此方法确保获取焦点的选项卡窗口匹配选中的窗口，一般情况下类似setCurrentTab(int)。通常当我们通过操作UI实现时，这些都不是问题，因为UI负责调用TabWidget.onFocusChanged()，但如果我们通过程序控制选中选项卡窗口，那么我们就必须确认保持焦点。（译者注：setCurrentTab(int)执行后，选中指定索引的选项卡窗口，但不获取焦点。focusCurrentTab(int)执行后，不仅通过调用setCurrentTab(int)选中指定索引的选项卡窗口还获取焦点。） 参数 index你想要设置焦点（橘色高亮）并且选中（选项卡被至于部件widget的前端）的选项卡。 参见 setCurrentTab(int) public ViewgetChildTabViewAt(int index) 返回位于指定索引位置的选项卡标识符的视图 参数 index选项卡指示符视图返回的从零开始的索引 返回值 在提供的索引位置上的选项卡指示符视图 public intgetTabCount() 返回选项卡的数量 返回值 选项卡指示符视图的数量 public booleanisStripEnabled() 指明选项卡指示符的底部分隔线是否绘制 public voidonFocusChange(View v, boolean hasFocus) 当视图的焦点状态被改变时调用。 参数 v状态变化的视图 hasFocus 视图的新焦点状态。 public voidsendAccessibilityEventUnchecked(AccessibilityEvent event) 处理用于发送AccessibilityEvent的请求。如果再发送之前调度事件，本方法不保证可访问性检查。可以通过调用者调用isEnabled()检查。 参数 event事件 public void setCurrentTab (int index) 设置当前选项卡。此方法被用来将选项卡置于widget的前部，并且通知其它的UI元素，一个不同的选项卡被调整到了前台。注意，这不同于传统的“焦点”，是从视图逻辑的焦点。 例如，如果我们在选项卡式视图中有一个列表，一个用户可能会上下移动列表，通过列表选项移动UI焦点（橘色高亮）。光标的移动并不影响选项卡的选中状态，因为滚动是在同一个选项卡上的。选中的选项卡仅仅当我们在选项卡上切换时（在此例中，从列表视图移到下一选项卡视图）更改。如果想要一次性的设置焦点并选中选项卡，请使用setCurrentTab(int)。 正常情况下，视图逻辑关注调整焦点，除非你规避了UI，你可能仅仅将你的兴趣集中在这里。 参数 index你想要指做选中选项卡的选项卡索引（选项卡被显示到widget的前部） 参见 focusCurrentTab(int) public voidsetDividerDrawable(Drawable drawable) 设置用于在选项窗口指示符间分隔的可绘制对象 参数 drawable用于分隔的可绘制对象 public voidsetDividerDrawable(int resId) 设置用于在两个选项卡标识符之间进行分隔的可绘制对象 参数 resId 被用来分隔的可绘制对象的资源标识 public voidsetEnabled(boolean enabled) 设置当前视图的启用状态。子类的不同而其对应的启用状态的解释也不相同。 参数 enabled是否启动 public voidsetLeftStripDrawable(int resId) 设置被用来当作选项卡指示符下面的分割线，左边部分的可绘制对象。 参数 resId the被用来当作左边分隔线的可绘制对象的资源标识符 public voidsetLeftStripDrawable(Drawable drawable) 设置被用来当作选项卡指示符下面的分割线，左边部分的可绘制对象。 参数 drawable左边分隔线的可绘制对象 public voidsetRightStripDrawable(int resId) 设置被用来当作选项卡指示符下面的分割线，右边部分的可绘制对象。 参数 resId 被用来当作右边分隔线的可绘制对象的资源标识符 public voidsetRightStripDrawable(Drawable drawable) 设置被用来当作选项卡指示符下面的分割线，右边部分的可绘制对象。 参数 drawable右边分隔线的可绘制对象 public voidsetStripEnabled(boolean stripEnabled) 控制选项卡指示符底部的分隔线是否绘制。默认是绘制。如果用户为选项卡指示符指定一个定制的视图，那么TabHost类调用此方法以禁用绘制底部分割线。 参数 stripEnabled如果需要绘制底部分割线为true 五、受保护方法 protected int getChildDrawingOrder (int childCount, int i) 返回要绘制的子元素在当前迭代中的索引。如果你需要修改子元素的绘制顺序，可以覆写此方法。默认情况下返回参数i值。 注意：为使此方法被调用，你必须先通过调用setChildrenDrawingOrderEnabled(boolean)启用子元素排序 参数 i 当前的迭代值 返回值 将要绘制的子元素在当前迭代的索引 protected void onSizeChanged (int w, int h, int oldw, int oldh) 布局过程中，当此视图的大小发生改变时被调用的。如果你只是添加到视图的层次结构，你调用时可以使用0当作之前的值（old value）。 参数 w 此视图的当前宽度 h 此视图的当前高度 oldw Old此视图之前的宽度 oldh此视图之前的高度 六、补充 术语对照 indicator指示符 drawable可绘制对象 iteration迭代 strips分割线 文章精选 Android选项卡(TabWidget)例子 {Android学习指南}TabWidget Android将TAB选项卡放在屏幕底部 示例代码 Java: public class TabDemo1 extends Activity implements OnClickListener{ TabHostmTabHost = null ; TabWidgetmTabWidget = null ; ButtonbtnVisiable,btnStrip; @Override protected void onCreate(BundlesavedInstanceState){ // TODOAuto-generatedmethodstub super .onCreate(savedInstanceState); setContentView(R.layout.tabdemo1); mTabHost = (TabHost)findViewById(android.R.id.tabhost); mTabHost.setup(); mTabWidget = mTabHost.getTabWidget(); mTabHost.addTab(mTabHost.newTabSpec( " tab1 " ).setContent( R.id.LinearLayout001).setIndicator( " Tab1 " )); mTabHost.addTab(mTabHost.newTabSpec( " tab2 " ).setContent( R.id.LinearLayout002).setIndicator( " Tab2 " )); mTabHost.addTab(mTabHost.newTabSpec( " tab3 " ).setContent( R.id.LinearLayout003).setIndicator( " Tab3 " )); // mTabHost.setCurrentTab(1); btnVisiable = (Button)findViewById(R.id.btnVisiable); btnStrip = (Button)findViewById(R.id.btnStrip); btnVisiable.setOnClickListener( this ); btnStrip.setOnClickListener( this ); setTitle( " 共有 " + mTabWidget.getTabCount() + " 个tab " ); } @Override public void onClick(Viewv){ // TODOAuto-generatedmethodstub switch (v.getId()){ case R.id.btnVisiable: if (mTabWidget.getVisibility() != android.view.View.VISIBLE) mTabWidget.setVisibility(android.view.View.VISIBLE); else mTabWidget.setVisibility(android.view.View.INVISIBLE); break ; case R.id.btnStrip: mTabWidget.setStripEnabled( ! mTabWidget.isStripEnabled()); mTabWidget.setRightStripDrawable(android.R.color.transparent); break ; default : break ; } } } XML: <? xmlversion="1.0"encoding="utf-8" ?> < TabHost xmlns:android ="http://schemas.android.com/apk/res/android" android:layout_width ="fill_parent" android:layout_height ="fill_parent" android:id ="@android:id/tabhost" > < LinearLayout android:layout_width ="fill_parent" android:orientation ="vertical" android:layout_height ="fill_parent" > < TabWidget android:id ="@android:id/tabs" android:layout_width ="fill_parent" android:layout_height ="wrap_content" ></ TabWidget > < FrameLayout android:id ="@android:id/tabcontent" android:layout_height ="wrap_content" android:layout_width ="fill_parent" > < LinearLayout android:id ="@+id/LinearLayout001" android:orientation ="vertical" android:layout_width ="fill_parent" android:layout_height ="fill_parent" > < Button android:id ="@+id/btnVisiable" android:text ="显示状态切换" android:layout_width ="fill_parent" android:layout_height ="wrap_content" ></ Button > < Button android:id ="@+id/btnStrip" android:layout_width ="fill_parent" android:layout_height ="wrap_content" android:text ="分隔线状态切换" ></ Button > < TextView android:id ="@+id/TextView1" android:layout_width ="fill_parent" android:layout_height ="wrap_content" android:text ="小龙是好人!!!" ></ TextView > </ LinearLayout > < LinearLayout android:id ="@+id/LinearLayout002" android:layout_width ="fill_parent" android:layout_height ="fill_parent" > < TextView android:id ="@+id/TextView2" android:layout_width ="fill_parent" android:layout_height ="wrap_content" android:text ="小龙是坏蛋!" ></ TextView > </ LinearLayout > < LinearLayout android:id ="@+id/LinearLayout003" android:layout_width ="fill_parent" android:layout_height ="fill_parent" > < TextView android:id ="@+id/TextView3" android:layout_width ="fill_parent" android:layout_height ="wrap_content" android:text ="小龙还是坏蛋!" ></ TextView > </ LinearLayout > </ FrameLayout > </ LinearLayout > </ TabHost > 结束 每次合集发布就像受检部队在接受检阅，紧张而又荣耀。为了每次的检阅，大家尽心尽力的筹备，做同一件事情，鼓励自己坚持，鼓励“战友”坚持。致力于可持续发展开源事业的建设。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582358，如需转载请自行联系原作者
2017-11-13
优秀的个人博客,低调大师

Android中文API (110) —— CursorTreeAdapter

正文 一、结构 public abstract classCusrorTreeAdapter extendsBaseExpandableListAdpaterimplementsFilterable java.lang.Object android.widget.BaseExpandableListAdapter android.widget.CursorTreeAdapter 直接子类 ResourceCursorTreeAdapter 间接子类 SimpleCursorTreeAdapter 二、概述 通过该适配类可以用一连续的游标(Coursor)对象访问数据库，并将查询出来的数据展示到可伸缩的列表视图(ExpandableListView)部件上。顶层游标(Cursor)对象(在构造器中指定)显示全部组，后面的游标(Cursor)对象从getChildrenCursor(Cursor)获取并展示子元素组。其中游标携带的结果集中必须有个名为“_id”的列，否则这个类不起任何作用。 三、构造函数 publicCursorTreeAdapter(Cursor cursor, Context context) 构造函数。每当数据库的数据发生改变时，适配器将调用requery()重新查询以显示最新的数据。 参数 cursor为组(groups)提供数据的游标(Coursor) context应用程序上下文。 publicCursorTreeAdapter(Cursor cursor, Context context, boolean autoRequery) 构造函数。 参数 cursor为组(groups)提供数据的游标(Coursor) context应用程序上下文。 autoRequery设置为true时，每当数据库的数据发生改变时，适配器将调用requery()重新查询以显示最新的数据。 四、公共方法 public voidchangeCursor(Cursor cursor) 更改相关的游标为新传入的游标。如果游标已经存在则先关闭这个已存在的游标。 参数 cursor 新游标(Cursor)对象。 public CharSequenceconvertToString(Cursor cursor) 将cursor转换成CharSequence。子类应该重写这个方法并转换它们的结果。这个方法的默认实现是：当cursor为空时返回一个空串，否则直接返回调用cursor的toString()方法。 参数 cursor 将cursor转换成CharSequence对象。 返回值 返回CharSequence类型的值（译者注：这个值是通过转换参数cursor类型而获得的。） public CursorgetChild(int groupPosition, int childPosition) 获取指定组中的指定子元素的相关数据。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（相对于其它子元素） 返回值 返回指定子元素数据。 public longgetChildId(int groupPosition, int childPosition) 获取指定组中的指定子元素ID，这个ID在组里一定是唯一的。联合ID（参见getCombinedChildId(long, long)）在所有条目（所有组和所有元素）中也是唯一的。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（相对于其它子元素） 返回值 子元素关联ID。 public ViewgetChildView(int groupPosition, int childPosition, boolean isLastChild,View convertView, ViewGroup parent) 获取一个视图对象，显示指定组中的指定子元素数据。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置（决定返回哪个视图） isLastChild子元素是否处于组中的最后一个 convertView重用已有的视图(View)对象。注意：在使用前你应该检查一下这个视图对象是否非空并且这个对象的类型是否合适。由此引伸出，如果该对象不能被转换并显示正确的数据，这个方法就会调用getChildView(int, int, boolean, View, ViewGroup)来创建一个视图(View)对象。 parent返回的视图(View)对象始终依附于的视图组。 返回值 指定位置上的子元素返回的视图对象 public intgetChildrenCount(int groupPosition) 获取指定组中的子元素个数 参数 groupPosition组位置（决定返回哪个组的子元素个数） 返回值 返回组中的子元素个数 public CursorgetCursor() 返回当前适配器绑定的Cursor对象。 返回值 Cursor对象。 public FiltergetFilter() 返回一个可以通过一种过滤模式来约束数据的过滤器。 这个方法通常在Adapter类中实现。 返回值 返回一个用来限制数据的过滤器(Filter)对象。 public FilterQueryProvidergetFilterQueryProvider() 返回一个提供过滤的查询过滤器。若过滤器为null，则不再过滤。 返回值 返回当前过滤器对象，如果不存在返回null。 参考 getFilterQueryProvider() public CursorgetGroup(int groupPosition) 获取指定组中的数据 参数 groupPosition组位置 返回值 返回组中的数据，也就是该组中的子元素数据。 public intgetGroupCount() 获取组的个数 返回值 组的个数 public longgetGroupId(int groupPosition) 获取指定组的ID，这个组ID必须是唯一的。联合ID(参见getCombinedGroupId(long))在所有条目(所有组和所有元素)中也是唯一的。 参数 groupPosition 组位置 返回值 返回组ID public ViewgetGroupView(int groupPosition, boolean isExpanded, ViewconvertView, ViewGroup parent) 获取显示指定组的视图对象。这个方法仅返回关于组的视图对象，要想获取子元素的视图对象，就需要调用getChildView(int, int, boolean, View, ViewGroup)。 参数 groupPosition组位置（决定返回哪个视图） isExpanded该组是展开状态还是伸缩状态 convertView重用已有的视图对象。注意：在使用前你应该检查一下这个视图对象是否非空并且这个对象的类型是否合适。由此引伸出，如果该对象不能被转换并显示正确的数据，这个方法就会调用getGroupView(int, boolean, View, ViewGroup)来创建一个视图(View)对象。 parent返回的视图对象始终依附于的视图组。 返回值 返回指定组的视图对象 public booleanhasStableIds() 组和子元素是否持有稳定的ID,也就是底层数据的改变不会影响到它们。 返回值 返回一个Boolean类型的值，如果为TRUE，意味着相同的ID永远引用相同的对象。 public booleanisChildSelectable(int groupPosition, int childPosition) 是否选中指定位置上的子元素。 参数 groupPosition组位置（该组内部含有子元素） childPosition子元素位置 返回值 是否选中子元素 public voidnotifyDataSetChanged(boolean releaseCursors) 通知数据集已改变，该方法还为任何带有缓存功能的游标提供不用释放资源的可选功能。 参数 releaseCursors是否释放任何带有缓冲功能的游标资源 public voidnotifyDataSetChanged() 该方法内部实现了在每个观察者上面调用onChanged事件。每当发现数据集有改变的情况，或者读取到数据的新状态时，就会调用此方法。 public voidnotifyDataSetInvalidated() 该方法内部实现了在每个观察者上面调用onInvalidated事件。每当发现数据集监控有改变的情况，比如该数据集不再有效，就会调用此方法。 public voidonGroupCollapsed(int groupPosition) 当指定组收缩状态的时候调用此方法。 参数 groupPosition指定组收缩状态 public CursorrunQueryOnBackgroundThread(CharSequence constraint) 执行含指定约束的查询。此查询依赖于适配器的过滤器。查询是由FilterQueryProvider提供。如果没有指定FilterQueryProvider，当前cursor不过滤只返回。该方法会通过changeCursor(Cursor)方法返回一个Cursor对象，并且关闭掉先前的Cursor对象。这个方法始终在后台线程执行，而不是在应用程序的主线程（或是UI线程）中运行。规定：当参数constraint为null或为空时，该方法返回原始结果。 参数 constraint当某个查询需要过滤功能，使用参数constraint作为约束条件。 返回值 返回含有新的查询结果的Cursor。 参考 getFilter() getFilterQueryProvider() setFilterQueryProvider(android.widget.FilterQueryProvider) public voidsetChildrenCursor(int groupPosition, Cursor childrenCursor) 为指定组子元素设置游标(Cursor)，并关闭已存在的游标。这个方法是非常有用的，当进行异步查询操作的时候用来避免UI发生阻塞的情况。 参数 groupPosition组位置(组中的哪个子元素要设置游标对象) childrenCursor组子元素的游标(Cursor) public voidsetFilterQueryProvider(FilterQueryProvider filterQueryProvider) 设置一个过滤器，用来过滤当前的Cursor对象。当这个适配器需要进行过滤操作时，runQuery(CharSequence)方法被调用。 参数 filterQueryProvider 过滤生成器对象，设置为null时，就相当于移除了该生成器。 参考 getFilterQueryProvider() runQueryOnBackgroundThread(CharSequence) public voidsetGroupCursor(Cursor cursor) 设置组游标对象。 参数 cursor设置组游标对象，并关闭已存在的游标对象。 五、受保护方法 protected abstract voidbindChildView(View view, Context context, Cursor cursor,boolean isLastChild) 用游标(Coursor)的方式将子元素数据绑定在一个已存在的视图(View)对象上。 参数 view 已存在的视图(View)对象,也就是之前new出来的。 context应用程序上下文对象 cursor获取数据的游标对象，它已经移动到正确的位置 IsLastChild子元素是否处于组中的最后一个 protected abstract voidbindGroupView(View view, Context context, Cursor cursor,boolean isExpanded) 用游标(Coursor)的方式将组数据绑定在一个已存在的视图(View)对象上。 参数 view 已存在的组视图(View)对象,也就是早先new出来的。 context应用程序上下文对象，它已经移动到正确的位置 cursor获取数据的游标对象 isExpanded该组是展开状态还是伸缩状态 protected abstract CursorgetChildrenCursor(Cursor groupCursor) 获取指定组中的子元素游标对象。子类必须实现这个方法，用于在指定组中返回子元素数据。 如果你想用异步查询的方式避免UI阻塞的情况发生，可能会返回null或是在稍后调用setChildrenCursor(int, Cursor)。 你有责任在Activity生命周期中管理这个游标对象，有一个非常好的思路：使用managedQuery(Uri, String[], String, String[], String)来管理它们。在某些情况下，适配器本身会使游标停止工作，但这个特例不会总是出现，所以我们要确保有效地管理好游标对象。 参数 groupCursor组游标对象，决定返回哪个组中的子元素游标对象。 返回值 返回指定组中的子元素游标对象或者为null。 protected abstract ViewnewChildView(Context context, Cursor cursor, booleanisLastChild, ViewGroup parent) 创建一个新的子元素视图并持有指向数据的游标cursor。 参数 context应用程序上下文对象 cursor获取数据的游标对象，它已经移动到正确的位置 IsLastChild子元素是否处于组中的最后一个 parent新视图(View)所依附于的父对象。 protected abstract ViewnewGroupView(Context context, Cursor cursor, booleanisExpanded, ViewGroup parent) 创建一个新的组视图并持有组中指向数据的游标cursor。 参数 context应用程序上下文对象 cursor获取数据的游标对象，它已经移动到正确的位置 isExpanded该组是否展开状态 parent 新视图 (View) 所依附于的父对象。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582373，如需转载请自行联系原作者
2017-11-07
优秀的个人博客,低调大师

android中文api(85)——HorizontalScrollView

正文 一、结构 public classHorizontalScrollView extendsFrameLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.HorizontalScrollView 二、概述 用于布局的容器，可以放置让用户使用滚动条查看的视图层次结构，允许视图结构比手机的屏幕大。HorizontalScrollView是一种FrameLayout（框架布局），其子项被滚动查看时是整体移动的，并且子项本身可以是一个有复杂层次结构的布局管理器。一个常见的应用是子项在水平方向中，用户可以滚动显示顶层水平排列的子项(items)。 HorizontalScrollView不可以和ListView同时用，因为ListView有自己的滚动条设置。最重要的是，如果在需要显示很大的list的情况下，两者同时用则会使ListView在一些重要的优化上失效。出现这种失效的原因在于，HorizontalScrollView会强迫ListView用HorizontalScrollView本身提供的空间容器（infinite container）来显示完整的列表。 类似的情况，TextView也有自己的滚动条，所以不需要ScrollView。但这两者是可以同时使用的，使用的结果会是在一个更大的容器里显示文本视图。 HorizontalScrollView 只支持水平方向的滚动显示。 三、公共方法 public voidaddView(View child) 添加一个子视图。若这个子视图没有被设置布局参数，则使用ViewGroup的缺省参数。 参数 child要添加的子视图 public voidaddView(View child, int index) 添加一个子视图。若这个子视图没有被设置布局参数，则使用ViewGroup的缺省参数。 参数 child要添加的子视图 index子视图要加入的位置 public voidaddView(View child, int index, ViewGroup.LayoutParams params) 添加一个带有指定布局参数的子视图。 参数 child要添加的子视图 index子视图要加入的位置 params 子视图的布局参数 public voidaddView(View child, ViewGroup.LayoutParams params) 添加一个带有指定布局参数的子视图。 参数 child要添加的子视图 params 子视图的布局参数 public booleanarrowScroll(int direction) 响应点击左右箭头时对滚动条的处理。 参数 direction The direction corresponding to the arrow key that was pressed箭头按键所表示的方向 返回值 若此事件成功完成，则返回true；否则返回false。 public voidcomputeScroll() 被父视图调用，用于必要时候对其子视图的值（mScrollX和mScrollY）进行更新。典型的情况如：父视图中某个子视图使用一个Scroller对象来实现滚动操作，会使得此方法被调用。 public booleandispatchKeyEvent(KeyEvent event) 按照可以获得焦点的顺序（从视图树的顶端到当前获得焦点的视图），分派一个按键事件给下一个视图。若此视图为焦点视图，事件将会分派给它自己。否则它将按照顺序，分派给下一个节点。此方法同时触动所有按键监听器。 参数 event被分派的事件. 返回值 若事件被处理，则返回true；否则为false public voiddraw(Canvas canvas) 手动绘制视图（及其子视图）到指定的画布(Canvas)。这个视图必须在调用这个函数之前做好了整体布局。。当实现一个视图时，不需要继承这个方法；相反，你应该实现onDraw(Canvas)方法。 参数 canvas绘制视图的画布 public booleanexecuteKeyEvent(KeyEvent event) 需要通过按键事件来实现滚动操作时，可以调用此方法。效果类似于由视图树型结构分派事件。 参数 event需要执行的事件 返回值 若事件被处理，则返回true；否则为false public voidfling(int velocityX) 滚动视图的fling手势。 参数 velocityX方向的初始速率。正值表示手指/光标向屏幕右边滑动，而内容相对向左滚动。 public booleanfullScroll(int direction) 处理按下"home/end"快捷键之后的滚动响应。此方法会将视图移左或移右，同时将焦点赋予移动后可视的最左或最右的组件。如果没有任何组件适合得到焦点，此scrollview将收回焦点。 参数 direction滚动方向：FOCUS_LEFT表示向视图的左边移动，FOCUS_RIGHT表示向视图的右边移动 返回值 若此方法消耗(consumed)了按键事件则返回true，否则返回false。 public intgetMaxScrollAmount() 返回值 按左右箭头时视图可以滚动的最大值。 public booleanisFillViewport() 表示此ScrollView的内容是否被拉伸以适应视口（viewport）的大小。 返回值 若内容填充了视口则返回true，否则返回false。 public booleanisSmoothScrollingEnabled() 返回值 按箭头方向滚动时，是否显示滚动的平滑效果。 public booleanonInterceptTouchEvent(MotionEvent ev) 使用此方法可以拦截所有触摸屏动作引发的事件。这意味着你可以监视分派给子项的事件，并且可以拿到任何当前手势的所有权。 使用此方法需谨慎。因为它与View.onTouchEvent(MotionEvent)有相当复杂的交互影响。这两者都必须同时正确地实现。事件将按以下顺序来被方法接收： 1.接收到down事件 2.事件将被视图组的一个子视图处理，或者被传递给自己的onTouchEvent()方法处理；这意味着你必须实现onTouchEvent()，并且返回true，这样才可以接着接受到其他的手势（而不是寻求一个父视图来处理它）。onTouchEvent()返回true后，你将不再接受到onInterceptTouchEvent()的任何事件，同时所有对触摸动作的处理必须像往常一样在onTouchEvent()中进行。 3.如果返回false，则接下来的每个事件（所有的up事件，包含最后一个up）将会首先被传递到这里，然后到目标对象view的onTouchEvent()。 4.如果返回ture，你将不会接收到以下任何事件：目标view将会接收到相同的事件，但是带着ACTION_CANCEL的动作。所有在此之后的事件将会被传递到你的onTouchEvent()方法中，并且不再在这里出现。 参数 ev沿着树型结构往下分派的动作事件 返回值 若将动作事件从子视图中截获并通过onTouchEvent()将他们分派给当前ViewGroup，则返回true。当前目标将收到一个ACTION_CANCEL事件，并且不再会有其他消息被传递到这里。 public booleanonTouchEvent(MotionEvent ev) 此方法用于处理触摸屏的动作事件。 参数 ev动作事件 返回值 若事件被成功处理，则返回true；否则返回false public booleanpageScroll(int direction) 处理按下"page up/down"快捷键之后的滚动响应。此方法会将视图往左或往右滚动一个页面的距离，同时将焦点赋予移动后可视的最左或最右的组件。如果没有任何组件适合得到焦点，此scrollview将收回焦点。 参数 direction滚动方向：FOCUS_LEFT表示向视图的左边移动一个页面FOCUS_RIGHT表示向视图的右边移动一个页面 返回值 若此方法处理(consumed)了按键事件则返回true，否则返回false。 public voidrequestChildFocus(View child, View focused) 当父视图的一个子视图要获得焦点时，调用此方法。 参数 child要获得焦点的子视图。此视图将包含焦点视图，但其本身不必为焦点。 focused 事实上拥有焦点的子视图的下层视图。 public booleanrequestChildRectangleOnScreen(View child, Rect rectangle, boolean immediate) 当组里的某个子视图需要被定位在屏幕的某个矩形范围时，调用此方法。重载此方法的ViewGroup可确认以下几点： *子项目将是组里的直系子项 *矩形将在子项目的坐标体系中 重载此方法的ViewGroup应该支持以下几点： *若矩形已经是可见的，则没有东西会改变 *为使矩形区域全部可见，视图将可以被滚动显示 参数 child发出请求的子视图 rectangle子项目坐标系内的矩形，即此子项目希望在屏幕上的定位 immediate设为true，则禁止动画和平滑移动滚动条 返回值 进行了滚动操作的这个组（group），是否处理此操作 public voidrequestLayout() 当出现使视图布局失效的改变时，调用此方法。它将规划一个视图树的布局路径。 public voidscrollTo(int x, int y) 设置视图滚动后的位置。这将引起onScrollChanged(int,int,int,int)的调用，同时使此视图失效。 此版本同时将滚动锁定于子视图的范围。 参数 x要滚动到的x位置 y要滚动到的y位置 public voidsetFillViewport(boolean fillViewport) 设置此滚动视图是否将内容宽度拉伸来适应视口（viewport）。 参数 fillViewport设置为true表示将拉伸内容宽度；否则会设置为false。 public voidsetOverScrollMode(int mode) 为视图设置over-scroll模式。有效的over-scroll模式有OVER_SCROLL_ALWAYS（缺省值），OVER_SCROLL_IF_CONTENT_SCROLLS（只允许当视图内容大过容器时，进行over-scrolling）和OVER_SCROLL_NEVER。只有当视图可以滚动时，此项设置才起作用。 参数 mode视图的新over-scroll模式值 public voidsetSmoothScrollingEnabled(boolean smoothScrollingEnabled) 设置是否呈现按下箭头后的平滑滚动效果（动画效果）。 参数 smoothScrollingEnabled设置是否呈现平滑滚动效果 public final voidsmoothScrollBy(int dx, int dy) 类似scrollBy(int, int)，但是呈现平滑滚动，而非瞬间滚动（译者注：瞬间滚动——指不显示滚动过程，直接显示滚动后达到的位置）。 参数 dx要滚动的X轴像素差值（译者注：横向像素差值） dy要滚动的Y轴像素差值（译者注：纵向像素差值） public final voidsmoothScrollTo(int x, int y) 类似scrollTo(int, int)，但是呈现平滑滚动，而不是瞬间滚动。 参数 x滚动要到达位置的X轴值 y 滚动要到达位置的 Y 轴值 四、受保护方法 protected intcomputeHorizontalScrollOffset() 计算水平方向滚动条的滑块的偏移值。此值用来计算滚动时滑块的位置。 偏移值的范围可以以任何单位表示，但必须与computeHorizontalScrollRange()和computeHorizontalScrollExtent()的单位一致。 缺省的偏移值为视图滚动的偏移差值。 返回值 滚动条滑块在水平方向上的偏移值 protected intcomputeHorizontalScrollRange() scroll view的可滚动水平范围是所有子视图的宽度总合。 返回值 水平滚动条表示的全部水平滚动范围 protected intcomputeScrollDeltaToGetChildRectOnScreen(Rect rect) 计算X方向滚动的总合，以便在屏幕上显示子视图的完整矩形（或者，若矩形宽度超过屏幕宽度，至少要填满第一个屏幕大小）。 参数 rect矩形 返回值 滚动差值 protected floatgetLeftFadingEdgeStrength() 返回左渐变边缘的强度或密集度。强度的值介于0.0（无渐变）到1.0（全渐变）之间。缺省实现只返回0.0或1.0，而不返回中间值。子类必须重载次方法来给滚动动作提供更平滑的渐变过程。 返回值 左渐变的强度，即介于0.0f和1.0f之间的浮点值 protected floatgetRightFadingEdgeStrength() 返回右渐变边缘的强度或密集度。强度的值介于0.0（无渐变）到1.0（全渐变）之间。缺省实现只返回0.0或1.0，而不返回中间值。子类必须重载此方法来给滚动动作提供更平滑的渐变过程。 返回值 右渐变的强度，即介于0.0f和1.0f之间的浮点值 protected voidmeasureChild(View child, int parentWidthMeasureSpec, int parentHeightMeasureSpec) 要求子视图测量自身，需要将视图的MeasureSpec和其附加内容同时考虑在内。getChildMeasureSpec在其中承担了重要角色，它计算出MeasureSpec，并传递给子视图。 参数 child要测量的子视图 parentWidthMeasureSpec此视图的宽度要求 parentHeightMeasureSpec此视图的高度要求 protected voidmeasureChildWithMargins(View child, int parentWidthMeasureSpec, int widthUsed, int parentHeightMeasureSpec, int heightUsed) 要求子视图测量自身，需要将视图的MeasureSpec、附加内容和边缘部分同时考虑在内。子项必须有MarginLayoutParams（边缘布局参数）。getChildMeasureSpec在其中承担了重要角色，它计算出MeasureSpec，并传递给子视图。 参数 child要测量的子视图 parentWidthMeasureSpec此视图的宽度要求 widthUsed被父视图（也可能是其他子视图）占用的横向额外空间 parentHeightMeasureSpec此视图的高度要求 heightUsed被父视图（也可能是其他子视图）占用的纵向额外空间 protected voidonLayout(boolean changed, int l, int t, int r, int b) 当此视图要给每个子视图赋值大小和位置时，layout会调用此方法。子项的派生类应当重载此方法，并且调用各个子项的layout。 参数 changed此视图有新的大小或位置 l左边界位置，相对于父视图 t上边界位置，相对于父视图 r右边界位置，相对于父视图 b下边界位置，相对于父视图 protected voidonMeasure(int widthMeasureSpec, int heightMeasureSpec) 调用此方法来确定本身和所包含内容的大小（宽度和高度）。此方法被measure(int,int)唤起，而且必须被子类重载以得到所包含内容的确切大小。 注意：当重载此方法时，必须调用setMeasureDimension(int,int)来保存View的大小。如果没有做到，将会引发一个measure(int,int)抛出的IllegalStateException（非法状态错误）。超类onMeasure(int,int)可以被调用。 编写基类的确认大小的方法，缺省情况下是根据其背景大小来确认，除非MeasureSepc允许有更大的高度或宽度。子类必须重载onMeasure(int,int)以得到对其内容大小的更准确的测量。 若此方法被重载，它的子类需要确保其高度和宽度至少达到View所规定的最小值（可通过getSuggestedMinimumHeight()和getSuggestedMinimumWidth()得到）。 参数 widthMeasureSpec受上一层大小影响下的对水平空间的要求。可参看View.MeasureSpec。 heightMeasureSpec受上一层大小影响下的对垂直空间的要求。可参看View.MeasureSpec。 protected voidonOverScrolled(int scrollX, int scrollY, boolean clampedX, boolean clampedY) 被overScrollBy(int, int, int, int, int, int, int, int, boolean)调用，来对一个over-scroll操作的结果进行响应。 参数 scrollX新的X滚动像素值 scrollY新的Y滚动像素值 clampedX当scrollX被over-scroll的边界限制时，值为true clampedY当scrollY被over-scroll的边界限制时，值为true protected booleanonRequestFocusInDescendants(int direction, Rect previouslyFocusedRect) 当在某个scroll view的子视图中寻找焦点时，需要小心不能让屏幕之外的组件得到焦点。这比缺省ViewGroup的实现代价更高，否则此行为被设为缺省。 参数 direction值可以为FOCUS_UP，FOCUS_DOWN，FOCUS_LEFT或FOCUS_RIGHT previouslyFocusedRect能够给出一个较好的提示的矩形（当前视图的坐标系统）表示焦点从哪里得来。如果没有提示则为null。 返回值 是否取到了焦点。 protected voidonSizeChanged(int w, int h, int oldw, int oldh) 当View的大小改变时此方法被调用。如果View是刚刚被加入，则视之前的值为0。 参数 wView的当前宽度 hView的当前高度 oldwView大小改变之前的宽度 oldhView大小改变之前的高度 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582426，如需转载请自行联系原作者
2017-11-07
优秀的个人博客,低调大师

Android 中文 API (101) —— AsyncTask

正文 一、结构 public abstract classAsyncTask extendsObject java.lang.Object android.os.AsyncTask<Params, Progress, Result> 二、类概述 AsyncTask能够适当地、简单地用于UI线程。 这个类不需要操作线程(Thread)就可以完成后台操作将结果返回UI。 异步任务的定义是一个在后台线程上运行，其结果是在UI线程上发布的计算。 异步任务被定义成三种泛型类型：Params，Progress和Result；和四个步骤：begin,doInBackground，processProgress和end。 三、用法 AysncTask 必须被继承使用。子类至少 覆盖 一个方法 ( doInBackground(Params...) ) ，最经常 覆盖 另一个 ( onPostExecute(Result) .) 下面是一个子类的例子： private class DownloadFilesTask extends AsyncTask < URL,Integer,Long > { protected LongdoInBackground(URL...urls){ int count = urls.length; long totalSize = 0 ; for ( int i = 0 ;i < count;i ++ ){ totalSize += Downloader.downloadFile(urls[i]); publishProgress(( int )((i / ( float )count) * 100 )); } return totalSize; } protected void onProgressUpdate(Integer...progress){ setProgressPercent(progress[ 0 ]); } protected void onPostExecute(Longresult){ showDialog( " Downloaded " + result + " bytes " ); } } 一旦创建，一个任务执行起来就非常简单： new DownloadFilesTask().execute(url1,url2,url3); 四、AsyncTask的泛型类型 这三个类型被用于一个异步任务，如下： 1.Params，启动任务执行的输入参数 2.Progress，后台任务执行的百分比 3.Result，后台计算的结果类型 在一个异步任务里，不是所有的类型总被用。假如一个类型不被使用，可以简单地使用Void类型： private class MyTask extends AsyncTask < Void,Void,Void > {...} 五、4个步骤 当一个异步任务被执行，任务经过四各步骤： 1．onPreExecute()，在UI线程上调用任务后立即执行。这步通常被用于设置任务，例如在用户界面显示一个进度条。 2．doInBackground(Params...)，后台线程执行onPreExecute()完后立即调用，这步被用于执行较长时间的后台计算。异步任务的参数也被传到这步。计算的结果必须在这步返回，将传回到上一步。在执行过程中可以调用publishProgress(Progress...)来更新任务的进度。 3．onProgressUpdate(Progress...),一次呼叫publishProgress(Progress...)后调用 UI线程。执行时间是不确定的。这个方法用于当后台计算还在进行时在用户界面显示进度。例如：这个方法可以被用于一个进度条动画或在文本域显示记录。 4．onPostExecute(Result),当后台计算结束时，调用 UI线程。后台计算结果作为一个参数传递到这步。 六、线程规则 有一些线程规则必须去遵守，这个类才会正确的工作: 任务实例必须创建在 UI线程 execute(Params...)必须在UI线程上调用 不要手动调用onPreExecute(),onPostExecute(Result),doInBackground(Params...),onProgressUpdate(Progress...) 这个任务只执行一次（如果执行第二次将会抛出异常） 七、内部类 enum AsyncTask.Status 表示任务的当前状态 八、构造函数 public AsyncTask () 创建一个新的异步任务。这个构造函数必须在UI线程上调用。 九、公共方法 public final booleancancel(boolean mayInterruptIfRunning) 尝试取消这个任务的执行，如果这个任务已经结束或者已经取消或者不能被取消或者某些其他原因，那么将导致这个操作失败，当调用此方法时，此方法执行成功并且这个任务还没有执行，那么此任务将不再执行。如果任务已经开始，这时执行此操作传入的参数mayInterruptIfRunning为true，执行此任务的线程将尝试中断该任务。 参数 mayInterruptIfRunning如果为true则正在执行的线程将会中断，如果false，则会允许正在执行的任务线程执行完毕。 返回值 如果此任务不能取消返回false，如果已经正常的执行完毕，返回true 参见 isCancelled() onCancelled() public final AsyncTask<Params, Progress, Result>execute(Params... params) 用指定的参数来执行此任务，这个方法将会返回此任务本身，所以调用者可以拥有此任务的引用。此方法必须在UI线程中调用 参数 params 任务参数 返回值 AsyncTask的实例 异常 IllegalStateException如果getStatus()返回的是RUNNING或者FINISHED public final Resultget() 等待计算结束并返回结果 返回值 计算结果 异常 CancellationException如果计算取消 ExecutionException如果计算抛出异常 InterruptedException当等待时当前线程抛出异常 public final Resultget(long timeout, TimeUnit unit) 等待计算结束并返回结果，最长等待时间为：timeOut（超时时间）. 参数 timeout计算等待超时时间 unit超时的时间单位 返回值 计算结果 异常 CancellationException如果计算取消 ExecutionException如果计算抛出异常 InterruptedException当等待时当前线程抛出异常 TimeoutException等待时间超时 public final AsyncTask.StatusgetStatus() 获得任务的当前状态 返回值 当前状态 public final booleanisCancelled() 如果在任务正常结束之前取消任务成功则返回true，否则返回false 返回值 如果任务正常结束之前取消任务成功返回true。 参见 cancel(boolean) 十、受保护方法 protected abstract ResultdoInBackground(Params... params) 覆盖此方法在后台线程执行计算，此方法中的参数是此任务的execute(Params...)方法的调用这传递的参数，此方法可以调用publishProgress(Progress...)在UI线程中来更新数据 参数 params 此任务的参数 返回值 返回一个由此任务子类定义的结果Result 参见 onPreExecute() onPostExecute(Result) publishProgress(Progress...) protected voidonCancelled() 此方法在UI线程中当cancel(boolean)被调用后调用 参见 cancel(boolean) isCancelled() protected voidonPostExecute(Result result) 此方法在UI线程中doInBackground(Params...)。方法调用之后调用，此方法中的参数的值是doInBackground(Params...)的返回值或者当此任务已经被取消或有异常发生时此参数值为空null 参数 result由doInBackground(Params...)计算出的操作的结果。 参见 onPreExecute() doInBackground(Params...) protected voidonPreExecute() 在方法doInBackground(Params...)调用之前调用 参见 onPostExecute(Result) doInBackground(Params...) protected voidonProgressUpdate(Progress... values) 该方法在UI线程中publishProgress(Progress...)被调用之后调用，该方法中的参数values是已经被传递到publishProgress(Progress...)中的参数 参数 values进度表示值 参见 publishProgress(Progress...) doInBackground(Params...) protected final voidpublishProgress(Progress... values) 当调用doInBackground(Params...)在后台执行计算时会调用该方法，每当在UI线程中调用此方法时将触发onProgressUpdate(Progress...)方法的执行 参数 values将进度值更新到UI 参见 onProgressUpdate(Progress...) doInBackground(Params...) 十一、补充 文章精选 Android AsyncTask理解 TabActivity下在AsyncTask中使用ProgressDialog存在问题的解决方法 小心，AsyncTask不是萬能的[blogspot] 十二、公告 内部类、内部接口由于内容较少均不再单独发布。 结束 随着春节的结束，翻译组工作重新回到正轨，感谢大家的关注与支持！ —————————————————————————————————————————— AsyncTask.Status 一、结构 public static final enumAsyncTask.Status extendsEnum<E extends Enum<E>> java.lang.Object java.lang.Enum<E extends java.lang.Enum<E>> android.os.AsyncTask.Status 二、类概述 标志任务的当前状态，每个状态在任务的生命周期中只会出现一次。 三、枚举值 public static final AsyncTask.StatusFINISHED 标志onPostExecute(Result)方法已经结束 public static final AsyncTask.StatusPENDING 标志任务还没有执行 public static final AsyncTask.StatusRUNNING 标志任务正在执行 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582388，如需转载请自行联系原作者
2017-11-07
优秀的个人博客,低调大师

Android 中文API （94） —— MediaController

正文 一、结构 public classMediaController extendsFrameLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.MediaController 二、类概述 一个包含媒体播放器(MediaPlayer)控件的视图。包含了一些典型的按钮，像"播放(Play)/暂停(Pause)", "倒带(Rewind)", "快进(Fast Forward)"与进度滑动器(progress slider)。它管理媒体播放器(MediaController)的状态以保持控件的同步。 通过编程来实例化使用这个类。这个媒体控制器将创建一个具有默认设置的控件，并把它们放到一个窗口里漂浮在你的应用程序上。具体来说，这些控件会漂浮在通过setAnchorView()指定的视图上。如果这个窗口空闲3秒那么它将消失，直到用户触摸这个视图的时候重现。 当媒体控制器是在一个XML布局资源文件中创建的时候，像show()和hide()这些函数是无效的。媒体播放器将根据这些规则去显示和隐藏： *在调用setPrevNextListeners()函数之前，"previous"和"next"按钮都是隐藏的。 * 如果setPrevNextListeners() 函数被调用但传入的监听器参数是null ，那么"previous" 和"next" 按钮是可见的但是处于禁用状态。 * "rewind" 和 "fastforward" 按钮是显示的，如果不需要可以使用构造函数 MediaController(Context, boolean) 将 boolean 设置为 false 。 三、公共方法 public booleandispatchKeyEvent(KeyEvent event) 在焦点路径上分发按钮事件到下一个视图。该路径从视图树的顶端遍历到当前获得焦点的视图。如果当前视图已获得焦点，就分发给自身。否则，就分发到下一个节点的焦点路径上。这个方法也可以激发任何一个按键消息监听器。 参数 event被分发的事件 返回值 如果这个事件被处理了返回true，否则返回false。 public voidhide() 从屏幕中移除控制器。 public booleanisShowing() （译者注：判断媒体控制器是否处于可见状态。） public voidonFinishInflate() XML文件加载视图完成时调用。这个函数在加载的最后阶段被调用，所有的子视图已经被添加。 即使子类重写了onFinishInflate方法，也应该始终确保调用父类方法，以便我们调用。 public booleanonTouchEvent(MotionEvent event) 实现这个方法来处理触摸屏幕引发的事件。 参数 event动作事件 返回值 如果这个事件被处理了返回true，否则返回false。 public booleanonTrackballEvent(MotionEvent ev) 实现这个方法处理轨迹球的动作事件，轨迹球相对运动的最后一个事件能用MotionEvent.getX()和MotionEvent.getY()函数获取。这些都是标准化的，用1表示用户按下一个DPAD按键。（因此他们将经常使用小数值表示，为轨迹球提供更多的的细微运动信息）（译者注：DPAD按键事件: KeyEvent.KEYCODE_DPAD_CENTER（居中）、KeyEvent.KEYCODE_DPAD_DOWN（向下）、KeyEvent.KEYCODE_DPAD_LEFT（向左）、KeyEvent.KEYCODE_DPAD_RIGHT（向右）、KeyEvent.KEYCODE_DPAD_UP（向上）作比较。分别表示居中、下移、左移、右移、上移的操作。相关链接：onTrackBallEvent方法简介） 参数 ev动作事件 返回值 如果这个事件被处理了返回true，否则返回false。 public void setAnchorView (View view) 设置这个控制器绑定(anchor/锚)到一个视图上。例如可以是一个VideoView对象，或者是你的activity的主视图。 参数 view 将视图来绑定控制器时可见 public voidsetEnabled(boolean enabled) 设置视图对象的有效状态。这也可以改变子类的有效状态。 参数 enabled如果要让这个视图对象可用就设置为true，否则设置为false。 public voidsetMediaPlayer(MediaController.MediaPlayerControl player) （译者注：把这个媒体控制器设置到VideoView对象上。） public voidsetPrevNextListeners(View.OnClickListener next, View.OnClickListener prev) （译者注：设置"previous"和"next"按钮的监听器函数。） public voidshow(int timeout) 在屏幕上显示这个控制器。它将在闲置’超时(timeout)’毫秒到达后自动消失。 参数 timeout这个参数以毫秒为单位。如果设置为0将一直显示到调用hide()函数为止。 public voidshow() 在屏幕上显示这个控制器。它将在 3 秒以后自动消失。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582407，如需转载请自行联系原作者
2017-11-07
优秀的个人博客,低调大师

Android 中文 API （35） —— ImageSwitcher

正文 一、结构 public classImageSwitcherextendsViewSwitcher java.lang.Objectandroid.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.ViewAnimator android.widget.ViewSwitcher android.widget.ImageSwitcher 二、概述 （译者注：ImageSwitcher是Android中控制图片展示效果的一个控件，如：幻灯片效果...，颇有感觉啊，做相册一绝。） 三、公共方法 public void setImageDrawable (Drawable drawable) 绘制图片 public void setImageResource (int resid) 设置图片资源库 public void setImageURI (Uri uri) 设置图片地址 四、补充 4.1 文章链接 Android ImageSwitcher Image Switcher View | Android Developer Tutorial 4.2 示例代码（本文代码转载自这里） java文件 public class mainactivity extends Activity implements OnItemSelectedListener,ViewFactory{ private ImageSwitcheris; private Gallerygallery; private Integer[]mThumbIds = {R.drawable.b,R.drawable.c, R.drawable.d,R.drawable.f,R.drawable.g, }; private Integer[]mImageIds = {R.drawable.b,R.drawable.c, R.drawable.d,R.drawable.f,R.drawable.g,}; @Override protected void onCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); requestWindowFeature(Window.FEATURE_NO_TITLE); setContentView(R.layout.main); is = (ImageSwitcher)findViewById(R.id.switcher); is.setFactory( this ); is.setInAnimation(AnimationUtils.loadAnimation( this , android.R.anim.fade_in)); is.setOutAnimation(AnimationUtils.loadAnimation( this , android.R.anim.fade_out)); gallery = (Gallery)findViewById(R.id.gallery); gallery.setAdapter( new ImageAdapter( this )); gallery.setOnItemSelectedListener( this ); } @Override public ViewmakeView(){ ImageViewi = new ImageView( this ); i.setBackgroundColor( 0xFF000000 ); i.setScaleType(ImageView.ScaleType.FIT_CENTER); i.setLayoutParams( new ImageSwitcher.LayoutParams( LayoutParams.MATCH_PARENT,LayoutParams.MATCH_PARENT)); return i; } public class ImageAdapter extends BaseAdapter{ public ImageAdapter(Contextc){ mContext = c; } public int getCount(){ return mThumbIds.length; } public ObjectgetItem( int position){ return position; } public long getItemId( int position){ return position; } public ViewgetView( int position,ViewconvertView,ViewGroupparent){ ImageViewi = new ImageView(mContext); i.setImageResource(mThumbIds[position]); i.setAdjustViewBounds( true ); i.setLayoutParams( new Gallery.LayoutParams( LayoutParams.WRAP_CONTENT,LayoutParams.WRAP_CONTENT)); i.setBackgroundResource(R.drawable.e); return i; } private ContextmContext; } @Override public void onItemSelected(AdapterView <?> parent,Viewview, int position, long id){ is.setImageResource(mImageIds[position]); } @Override public void onNothingSelected(AdapterView <?> parent){ } } xml文件 <? xmlversion="1.0"encoding="utf-8" ?> < RelativeLayout xmlns:android ="http://schemas.android.com/apk/res/android" android:layout_width ="match_parent" android:layout_height ="match_parent" > < ImageSwitcher android:id ="@+id/switcher" android:layout_width ="match_parent" android:layout_height ="match_parent" android:layout_alignParentTop ="true" android:layout_alignParentLeft ="true" /> < Gallery android:id ="@+id/gallery" android:background ="#55000000" android:layout_width ="match_parent" android:layout_height ="60dp" android:layout_alignParentBottom ="true" android:layout_alignParentLeft ="true" android:gravity ="center_vertical" android:spacing ="16dp" /> </ RelativeLayout > 结束 wallace2010居然弄个这么好看的图片 - - # 吸引帝...... 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582635，如需转载请自行联系原作者
2017-11-07
优秀的个人博客,低调大师

Android中文API（122） —— AudioRecord

结构 继承关系 public classAudioRecord extendsObject java.lang.Object android.media.AudioRecord 类概述 AudioRecord类在Java应用程序中管理音频资源，用来记录从平台音频输入设备产生的数据。通过AudioRecord对象来完成"pulling"（读取）数据。应用通过以下几个方法负责立即从AudioRecord对象读取：read(byte[], int, int)，read(short[], int, int)或read(ByteBuffer, int).无论使用哪种音频格式，使用AudioRecord是最方便的。 在创建AudioRecord对象时，AudioRecord会初始化，并和音频缓冲区连接，用来缓冲新的音频数据。根据构造时指定的缓冲区大小，来决定AudioRecord能够记录多长的数据。从硬件设备读取的数据，应小于整个记录缓冲区。 内部类 interface AudioRecord.OnRecordPositionUpdateListener 接口定义为：当AudioRecord收到一个由setNotificationMarkerPosition(int)设置的通知标志，或由setPositionNotificationPeriod(int)设置的周期更新记录的进度状态时，回调此接口。 常量 public static final intERROR 表示操作失败。 常量值: -1 (0xffffffff) public static final intERROR_BAD_VALUE 表示使用了一个不合理的值导致的失败。 常量值: -2 (0xfffffffe) public static final intERROR_INVALID_OPERATION 表示不恰当的方法导致的失败。 常量值: -3 (0xfffffffd) public static final intRECORDSTATE_RECORDING 指示AudioRecord录制状态为“正在录制”。 常量值: 3 (0x00000003) public static final intRECORDSTATE_STOPPED 指示AudioRecord录制状态为“不在录制”。 常量值: 1 (0x00000001) public static final intSTATE_INITIALIZED 指示AudioRecord准备就绪。 常量值: 1 (0x00000001) public static final intSTATE_UNINITIALIZED 指示AudioRecord状态没有初始化成功。 常量值: 0 (0x00000000) public static final intSUCCESS 表示操作成功。 常量值: 0 (0x00000000) 构造函数 publicAudioRecord(int audioSource, int sampleRateInHz, int channelConfig, int audioFormat, int bufferSizeInBytes) 类构造函数。 参数 audioSource录制源。请见MediaRecorder.AudioSource录制源定义。 sampleRateInHz默认采样率，单位Hz。44100Hz是当前唯一能保证在所有设备上工作的采样率，在一些设备上还有22050, 16000或11025。 channelConfig描述音频通道设置。请见CHANNEL_IN_MONO和CHANNEL_IN_STEREO。CHANNEL_IN_MONO保证能在所有设备上工作。 audioFormat 音频数据保证支持此格式。请见ENCODING_PCM_16BIT和ENCODING_PCM_8BIT。 bufferSizeInBytes在录制过程中，音频数据写入缓冲区的总数（字节）。从缓冲区读取的新音频数据总会小于此值。getMinBufferSize(int, int, int)返回AudioRecord实例创建成功后的最小缓冲区。设置的值比getMinBufferSize()还小则会导致初始化失败。 异常 IllegalArgumentException 公共方法 public intgetAudioFormat() 返回设置的音频数据格式。请见ENCODING_PCM_16BIT和ENCODING_PCM_8BIT。 public intgetAudioSource() 返回音频录制源。 参见 MediaRecorder.AudioSource public intgetChannelConfiguration() 返回设置的频道设置。请见CHANNEL_IN_MONO和CHANNEL_IN_STEREO。 public intgetChannelCount() 返回设置的频道数目。 public static intgetMinBufferSize(int sampleRateInHz, int channelConfig, int audioFormat) 返回成功创建AudioRecord对象所需要的最小缓冲区大小。注意：这个大小并不保证在负荷下的流畅录制，应根据预期的频率来选择更高的值，AudioRecord实例在推送新数据时使用此值。 参数 sampleRateInHz默认采样率，单位Hz。 channelConfig描述音频通道设置。 请见CHANNEL_IN_MONO和CHANNEL_IN_STEREO。 audioFormat音频数据保证支持此格式。参见ENCODING_PCM_16BIT。 返回值 如果硬件不支持录制参数，或输入了一个无效的参数，则返回ERROR_BAD_VALUE，如果硬件查询到输出属性没有实现，或最小缓冲区用byte表示，则返回ERROR。 参见 更多信息请见有效的设置参数 public intgetNotificationMarkerPosition() 返回通知，标记框架中的位置。 public intgetPositionNotificationPeriod() 返回通知，更新框架中的时间位置。 public intgetRecordingState() 返回AudioRecord实例的录制状态。 参见 RECORDSTATE_STOPPED RECORDSTATE_RECORDING public intgetSampleRate() 返回设置的音频数据样本采样率，单位Hz。 public intgetState() 返回AudioRecord实例的状态。这点非常有用，用在AudioRecord实例创建成功后，检查初始化属性。它能肯定请求到了合适的硬件资源。 参见 STATE_INITIALIZED STATE_UNINITIALIZED public intread(short[] audioData, int offsetInShorts, int sizeInShorts) 从音频硬件录制缓冲区读取数据。 参数 audioData写入的音频录制数据。 offsetInShorts目标数组audioData的起始偏移量。 sizeInShorts请求读取的数据大小。 返回值 返回short型数据，表示读取到的数据，如果对象属性没有初始化，则返回ERROR_INVALID_OPERATION，如果参数不能解析成有效的数据或索引，则返回ERROR_BAD_VALUE。返回数值不会超过sizeInShorts。 public intread(byte[] audioData, int offsetInBytes, int sizeInBytes) 从音频硬件录制缓冲区读取数据。 参数 audioData写入的音频录制数据。 offsetInBytesaudioData的起始偏移值，单位byte。 sizeInBytes读取的最大字节数。 返回值 读入缓冲区的总byte数，如果对象属性没有初始化，则返回ERROR_INVALID_OPERATION，如果参数不能解析成有效的数据或索引，则返回ERROR_BAD_VALUE。读取的总byte数不会超过sizeInBytes。 public intread(ByteBuffer audioBuffer, int sizeInBytes) 从音频硬件录制缓冲区读取数据，直接复制到指定缓冲区。如果audioBuffer不是直接的缓冲区，此方法总是返回0。 参数 audioBuffer存储写入音频录制数据的缓冲区。 sizeInBytes请求的最大字节数。 返回值 读入缓冲区的总byte数，如果对象属性没有初始化，则返回ERROR_INVALID_OPERATION，如果参数不能解析成有效的数据或索引，则返回ERROR_BAD_VALUE。读取的总byte数不会超过sizeInBytes。 public voidrelease() 释放本地AudioRecord资源。对象不能经常使用此方法，而且在调用release()后，必须设置引用为null。 public intsetNotificationMarkerPosition(int markerInFrames) 如果设置了setRecordPositionUpdateListener(OnRecordPositionUpdateListener)或setRecordPositionUpdateListener(OnRecordPositionUpdateListener, Handler)，则通知监听者设置位置标记。 参数 markerInFrames在框架中快速标记位置。 返回值 返回错误或成功代码，请见SUCCESS、ERROR_BAD_VALUE、ERROR_INVALID_OPERATION。 public intsetPositionNotificationPeriod(int periodInFrames) 如果设置了setRecordPositionUpdateListener(OnRecordPositionUpdateListener)或setRecordPositionUpdateListener(OnRecordPositionUpdateListener, Handler)，则通知监听者设置时间标记。 参数 markerInFrames在框架中快速更新时间标记。 返回值 返回错误或成功代码，请见SUCCESS、ERROR_INVALID_OPERATION。 public voidsetRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener, Handler handler) 当之前设置的标志已经成立，或者周期录制位置更新时，设置处理监听者。使用此方法来将Handler和别的线程联系起来，来接收AudioRecord事件，比创建AudioTrack实例更好一些。 参数 handler用来接收事件通知消息。 public voidsetRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener) 当之前设置的标志已经成立，或者周期录制位置更新时，设置处理监听者。 public voidstartRecording() AudioRecord实例开始进行录制。 异常 IllegalStateException 受保护方法 protected voidfinalize() 通知VM回收此对象内存。此方法只能用在运行的应用程序没有任何线程再使用此对象，来告诉垃圾回收器回收此对象。 此方法用于释放系统资源，由垃圾回收器清除此对象。默认没有实现，由VM来决定，但子类根据需要可重写finalize()。在执行期间，调用此方法可能会立即抛出未定义异常，但是可以忽略。 注意：VM保证对象可以一次或多次调用finalize()，但并不保证finalize()会马上执行。例如，对象B的finalize()可能延迟执行，等待对象A的finalize()延迟回收A的内存。为了安全起见，请看ReferenceQueue，它提供了更多地控制VM的垃圾回收。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582334，如需转载请自行联系原作者
2017-11-06
优秀的个人博客,低调大师

Android中文API (109) —— SimpleCursorTreeAdapter

正文 一、结构 public abstract classSimpleCusrorTreeAdapter extends ResourceCusorTreeAdpater java.lang.Object android.widget.BaseExpandableListAdapter android.widget.CursorTreeAdapter android.widget.ResourceCusorTreeAdapter android.widget.SimpleCursorTreeAdapter 二、概述 这是一个用起来很方便的适配器类，它主要将Cursor与在XML文件中定义的TextView或ImageView进行映射。比如，你想设定要展示三列，那么当做好绑定之后，视图就会展示你设定好的那些列；当然了，视图的外观是定义在XML文件里面的，你只需用这个类与视图做好绑定就可以了。（译者注：Android推荐我们尽可能的将组视图和子视图分离开，也就是说不要把整体定义在一个布局文件当中。）与视图绑定有两个阶段。第一阶段：如果使用SimpleCursorTreeAdapter.ViewBinder时，那么就会调用setViewValue(android.view.View, android.database.Cursor, int)方法。该方法返回true就说明绑定成功，否则返回false，这就到了第二阶段，SimpleCursorAdapter内部开始自行绑定，过程是这样的，若绑定到TextView上，调用setViewText(TextView, String)；若绑定到ImageView上，调用setViewImage(ImageView, String),如果视图不是TextView或ImageView则抛出IllegalStateException异常。 三、内部类 public interfaceSimpleCursorTreeAdapter.ViewBinder 这个内部接口可以在外部通过SimpleCursorTreeAdapter.ViewBinder的方式进行Cursor与View的绑定。 四、构造函数 publicSimpleCursorTreeAdapter(Context context, Cursor cursor, int collapsedGroupLayout, int expandedGroupLayout, String[] groupFrom, int[] groupTo, int childLayout, int lastChildLayout, String[] childFrom, int[] childTo) 构造函数。 参数 context上下文，多指ExpandableListView的上下文 cursor数据库游标 collapsedGroupLayout布局资源文件标识ID，其定义的是收缩时的ExpandableListView布局样式，并且内部至少要包含参数“groupTo”中指定的视图ID。 expandedGroupLayout布局资源文件标识ID，其定义的是展开时的ExpandableListView布局样式，并且内部至少要包含参数“groupTo”中指定的视图ID。 groupFrom列名列表，显示ExpandableListView的组节点。 groupTo展示参数“groupFrom”中的列，也就是说ExpandableListView中的视图显示的是参数“groupFrom”的列值，它们应该都是TextView或是ImageView。 childLayout布局资源文件标识ID，其定义的是子视图的布局样式(不包括最后一个子视图)，内部至少要包含参数“childTo”中指定的视图ID。lastChildLayout布局资源文件标识ID，其定义的是最后一个子视图的布局样式，内部至少要包含参数“childTo”中指定的视图ID。 lastChildLayout布局资源文件标识ID，其定义的是最后一个子视图的布局样式，内部至少要包含参数“childTo”中指定的视图ID。lastChildLayout布局资源文件标识ID，其定义的是最后一个子视图的布局样式，内部至少要包含参数“childTo”中指定的视图ID。 childFrom列名列表，显示ExpandableListView的子节点。 childTo展示参数“childFrom”中的列，也就是说ExpandableListView中的视图显示的是参数“childFrom”的列值，它们应该都是TextView或是ImageView。 publicSimpleCursorTreeAdapter(Context context, Cursor cursor, int collapsedGroupLayout, int expandedGroupLayout, String[] groupFrom, int[] groupTo, int childLayout, String[] childFrom, int[] childTo) 构造函数。（译者注：该构造函数只是少了一个参数lastChildLayout） 参数 context上下文，多指ExpandableListView的上下文 cursor数据库游标 collapsedGroupLayout布局资源文件标识ID，其定义的是收缩时的ExpandableListView布局样式，并且内部至少要包含参数“groupTo”中指定的视图ID。 expandedGroupLayout布局资源文件标识ID，其定义的是展开时的ExpandableListView布局样式，并且内部至少要包含参数“groupTo”中指定的视图ID。 groupFrom列名列表，显示ExpandableListView的组节点。 groupTo展示参数“groupFrom”中的列，也就是说ExpandableListView中的视图显示的是参数“groupFrom”的列值，它们应该都是TextView或是ImageView。 childLayout布局资源文件标识ID，其定义的是子视图的布局样式(不包括最后一个子视图)，内部至少要包含参数“childTo”中指定的视图ID。lastChildLayout布局资源文件标识ID，其定义的是最后一个子视图的布局样式，内部至少要包含参数“childTo”中指定的视图ID。 childFrom列名列表，显示ExpandableListView的子节点。 childTo展示参数“childFrom”中的列，也就是说ExpandableListView中的视图显示的是参数“childFrom”的列值，它们应该都是TextView或是ImageView。 publicSimpleCursorTreeAdapter(Context context, Cursor cursor, int groupLayout, String[] groupFrom, int[] groupTo, int childLayout, String[] childFrom, int[] childTo) 构造函数。 参数 context上下文，多指ExpandableListView的上下文 cursor数据库游标 groupLayout 显示组元素的资源文件。该资源文件定义了如何显示组元素。该布局文件必须至少包括groupTo中所定义的View。(即groupTo中的View id数组必须都在该布局文件中找到) groupFrom列名列表，显示ExpandableListView的组节点。 groupTo展示参数“groupFrom”中的列，也就是说ExpandableListView中的视图显示的是参数“groupFrom”的列值，它们应该都是TextView或是ImageView。 childLayout布局资源文件标识ID，其定义的是子视图的布局样式(不包括最后一个子视图)，内部至少要包含参数“childTo”中指定的视图ID。lastChildLayout布局资源文件标识ID，其定义的是最后一个子视图的布局样式，内部至少要包含参数“childTo”中指定的视图ID。 childFrom列名列表，显示ExpandableListView的子节点。 childTo 展示参数“ childFrom ”中的列，也就是说 ExpandableListView 中的视图显示的是参数 “ childFrom ”的列值， 它们应该都是 TextView 或是 ImageView 。 五、公共方法 public SimpleCursorAdapter.ViewBindergetViewBinder() 返回SimpleCursorTreeAdapter.ViewBinder引用，这个ViewBinder用来将数据绑定到视图上的。 返回值 如果ViewBinder不存在，则返回null。 参考 setViewBinder(android.widget.SimpleCursorTreeAdapter.ViewBinder) public voidsetViewBinder(SimpleCursorTreeAdapter.ViewBinder viewBinder) .设置视图绑定器。 参数 viewBinder视图绑定器。可以设置为null来删除已经存在的绑定器。 参考 getViewBinder() public voidsetViewText(TextView v, String text) 仅当ViewBinder不存在或是当ViewBinder不为TextView绑定时（也就是setViewValue()返回false），则这个方法会被bindView()调用，以便为TextView设置文本。可重写适配器从数据库中检索过滤字符串。 参数 v 文本控件引用 value为文本控件设置的文本信息（译者注：是从Cursor获取到的）。 六、受保护方法 protected voidbindChildView(View view, Context context, Cursor cursor, boolean isExpanded) 通过参数cursor将数据绑定到已有的子视图上。。 参数 view已有视图，返回之前调用newChildView创建的视图。 context应用程序上下文 cursor用于获取数据的Coursor。Coursor已经移到正确的位置。 isLastChild子元素是否处于组中的最后一个 protected voidbindGroupView(View view, Context context, Cursor cursor, boolean isExpanded) 通过参数cursor将数据绑定到已有组视图上。 参数 view已有组视图，返回之前调用newGroupView创建的视图。 context应用程序上下文 cursor用于获取数据的Coursor。Coursor已经移到正确的位置。 isExpanded组视图是否呈展开状态 protected voidsetViewImage(ImageView v, String value) 这个方法会被bindView()调用，以便为ImageView设置图片。默认情况下，参数value作为图片资源ID来看待，否则会视为图片的Uri。另外还可以通过过滤器来获得更灵活的设置。 参数 v 图片控件引用 value图片资源ID，是从Cursor获取到的。 七、补充 文章精选 android播放器（music player）源码分析2 示例代码 SimpleCursorTreeAdapter（深夜未眠）.rar SimpleCursorTreeAdapter.ViewBinder 译者署名：深夜未眠 译者链接：http://chris1012f.javaeye.com/ 翻译时间：2011-3-3 版本：Android 3.0 r1 结构 继承关系 public static interfaceSimpleCusrorTreeAdapter.ViewBinder java.lang.Object android.widget.SimpleCursorTreeAdapter.ViewBinder 类概述 这个内部接口可以在外部通过SimpleCursorTreeAdapter.ViewBinder的方式进行Cursor与View的绑定。Android推荐我们采用这种方式进行绑定操作，而不是沿用SimpleCursorTreeAdapter内部的方式。 参见 setViewImage(ImageView, String) setViewText(TextView, String) 公共方法 public abstract booleansetViewValue(View view, Cursor cursor, int columnIndex) 将指定的列数据绑定到指定的视图上。当ViewBinder处理绑定时，这个方法必须返回true；否则SimpleAdapter将尝试通过其内部默认的方法绑定数据。 参数 view被绑定的视图。 cursor数据库游标，绑定数据从它这里获取 columnIndex列位置，能够在数据库游标中寻找到。 返回值 返回 true 意味着数据与视图已经绑定上，否则为未绑定上。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582375，如需转载请自行联系原作者
2017-11-06
优秀的个人博客,低调大师

Android中文API(115)——AudioFormat

正文 一、结构 public classAudioFormat extendsObject java.lang.Object android.media.AudioFormat 二、概述 AndioFormat 类用于访问一些音频格式和通道配置常量。这些常量应用在 AudioTrack 和 AudioRecord 类中。 三、常量 public static final intCHANNEL_CONFIGURATION_DEFAULT 已弃用。 用CHANNEL_OUT_DEFAULT or CHANNEL_IN_DEFAULT代替。 常量值：1 (0x00000001) public static final intCHANNEL_CONFIGURATION_INVALID 已弃用。 用CHANNEL_INVALID代替。 常量值：0 (0x00000000) public static final intCHANNEL_CONFIGURATION_MONO 已弃用。 用CHANNEL_OUT_MONO or CHANNEL_IN_MONO代替。 常量值：2 (0x00000002) public static final intCHANNEL_CONFIGURATION_STEREO 已弃用。 用CHANNEL_OUT_STEREO or CHANNEL_IN_STEREO代替。 常量值：3 (0x00000003) public static final intCHANNEL_INVALID 无效的音频通道掩码 常量值：0 (0x00000000) public static final intCHANNEL_IN_BACK 常量值：32 (0x00000020) public static final intCHANNEL_IN_BACK_PROCESSED 常量值：512 (0x00000200) public static final intCHANNEL_IN_DEFAULT 常量值：1 (0x00000001) public static final intCHANNEL_IN_FRONT 常量值：16 (0x00000010) public static final intCHANNEL_IN_FRONT_PROCESSED 常量值：256 (0x00000100) public static final intCHANNEL_IN_LEFT 常量值：4 (0x00000004) public static final intCHANNEL_IN_LEFT_PROCESSED 常量值：64 (0x00000040) public static final intCHANNEL_IN_MONO 常量值：16 (0x00000010) public static final intCHANNEL_IN_PRESSURE 常量值：1024 (0x00000400) public static final intCHANNEL_IN_RIGHT 常量值：8 (0x00000008) public static final intCHANNEL_IN_RIGHT_PROCESSED 常量值：128 (0x00000080) public static final intCHANNEL_IN_STEREO 常量值：12 (0x0000000c) public static final intCHANNEL_IN_VOICE_DNLINK 常量值：32768 (0x00008000) public static final intCHANNEL_IN_VOICE_UPLINK 常量值：16384 (0x00004000) public static final intCHANNEL_IN_X_AXIS 常量值：2048 (0x00000800) public static final intCHANNEL_IN_Y_AXIS 常量值：4096 (0x00001000) public static final intCHANNEL_IN_Z_AXIS 常量值：8192 (0x00002000) public static final intCHANNEL_OUT_5POINT1 常量值：252 (0x000000fc) public static final intCHANNEL_OUT_7POINT1 常量值：1020 (0x000003fc) public static final intCHANNEL_OUT_BACK_CENTER 常量值：1024 (0x00000400) public static final intCHANNEL_OUT_BACK_LEFT 常量值：64 (0x00000040) public static final intCHANNEL_OUT_BACK_RIGHT 常量值：128 (0x00000080) public static final intCHANNEL_OUT_DEFAULT 默认的音频通道掩码。 常量值：1 (0x00000001) public static final intCHANNEL_OUT_FRONT_CENTER 常量值：16 (0x00000010) public static final intCHANNEL_OUT_FRONT_LEFT 常量值：4 (0x00000004) public static final intCHANNEL_OUT_FRONT_LEFT_OF_CENTER 常量值：256 (0x00000100) public static final intCHANNEL_OUT_FRONT_RIGHT 常量值：8 (0x00000008) public static final intCHANNEL_OUT_FRONT_RIGHT_OF_CENTER 常量值：512 (0x00000200) public static final intCHANNEL_OUT_LOW_FREQUENCY 常量值：32 (0x00000020) public static final intCHANNEL_OUT_MONO 常量值：4 (0x00000004) public static final intCHANNEL_OUT_QUAD 常量值：204 (0x000000cc) public static final intCHANNEL_OUT_STEREO 常量值：12 (0x0000000c) public static final intCHANNEL_OUT_SURROUND 常量值：1052 (0x0000041c) public static final intENCODING_DEFAULT 默认的音频数据格式 常量值：1 (0x00000001) public static final intENCODING_INVALID 无效的音频数据格式 常量值：0 (0x00000000) public static final intENCODING_PCM_16BIT 音频数据格式：脉冲编码调制（PCM）每个样品16位。设备保证提供支持。(参见：这里) 常量值：2 (0x00000002) public static final intENCODING_PCM_8BIT 音频数据格式：脉冲编码调制（PCM）每个样品8位。设备不保证提供支持。 常量值：3 (0x00000003) 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582354，如需转载请自行联系原作者
2017-11-06
优秀的个人博客,低调大师

android 中文 api （87） —— BaseInputConnection

正文 一、结构 public classBaseInputConnection extendsObjectimplementsInputConnection java.lang.Object android.view.inputmethod.BaseInputConnection 二、概述 InputConnection接口实现的基类，注意大多数行为提供的是Editable联接。本类的实现一定要实现getEditable()提供对它们自己的可编辑对象的访问。 三、公共方法 public booleanbeginBatchEdit() 缺省实现什么也不做。 public booleanclearMetaKeyStates(int states) 缺省实现用MetaKeyKeyListener.clearMetaKeyState(long, int)来清除状态。 参数 states要清除的状态，每个KeyEvent.getMetaState()中可能是1或个状态。 返回值 成功返回true，输入连接无效时返回false。 public booleancommitCompletion(CompletionInfo text) 缺省实现什么也不做。 参数 text提交的完成。 返回值 成功返回true，输入连接无效时返回false。 public booleancommitText(CharSequence text, int newCursorPosition) 缺省实现将用给出的文本替代正在构建的文本。另外在虚拟状态时，将发送包含新文本的按键事件并清空可编辑控件的缓存。 参数 text提交的文本。 newCursorPosition文本范围内新光标位置。如> 0，从文本未尾－1起计算；如<= 0，从文本起始处计算。所以是1时总是在刚插入文本之后。注意这意味着你不能将位置定义在文本中，因为编辑器可以修改你提交的文本，所以无必要将光标定位在文本中。 返回值 成功返回true，输入连接无效时返回false。 public booleandeleteSurroundingText(int leftLength, int rightLength) 缺省实现将删除当前光标位置附近的可编辑文本。 参数 leftLength删除文本在当前光标位置前的字符数 rightLength删除文本在当前光标位置后的字符数。 返回值 成功返回true，输入连接无效时返回false。。 public booleanendBatchEdit() 缺省实现什么也不做。 public booleanfinishComposingText() 缺省实现将用给定的文本替代正在构建的文本。另外在虚拟状态时，将发送包含新文本的按键事件并清空可编辑控件的缓存。 public static int getComposingSpanEnd (Spannable text) public static int getComposingSpanStart (Spannable text) public intgetCursorCapsMode(int reqModes) 缺省实现时，由TextUtils.getCapsMode返回当前可编辑文本的选定文本的光标大小写状态，虚拟状态时总是返回0。 参数 reqModes依据TextUtils.getCapsMode的定义取得期望的状态。通过已定义的常数，你可以轻易地传递TextBoxAttribute.contentType到当前。 返回值 返回当前有效的大小写状态。 public EditablegetEditable() 返回编辑操作的目标。缺省的实现是返回自己的虚拟可编辑控件，子类须重载一个可编辑控件并提供给它自己。 public ExtractedTextgetExtractedText(ExtractedTextRequest request, int flags) 缺省实现总是返回空。 参数 request 描述如何返回文本。 flags额外的客户端控制选项，0或GET_EXTRACTED_TEXT_MONITOR。 返回值 返回ExtractedText对象描述文本视窗的状态并包含提取文本的本身。 public CharSequencegetSelectedText(int flags) 缺省实现是返回当前选择文本，没有选取则为空。 参数 flags额外选项控制文本如何返回，可能为0或GET_TEXT_WITH_STYLES。 返回值 返回当前选择文本，没有选取则为空。 public CharSequencegetTextAfterCursor(int length, int flags) 缺省的实现是返回缓存中当前光标位置后给定数量的文本。 参数 length期望的文本长度。 flags如何返回文本的额外控制。可能为0或GET_TEXT_WITH_STYLES。 返回值 返回光标位置后的文本，返回文本的长度可能小于n。 public CharSequencegetTextBeforeCursor(int length, int flags) 缺省的实现是返回缓存中当前光标位置前给定数量的文本。 参数 length期望的文本长度。 flags如何返回文本的额外控制。可能为0或GET_TEXT_WITH_STYLES。 返回值 返回光标位置前的文本，返回文本的长度可能小于n。 public booleanperformContextMenuAction(int id) 缺省实现是什么也不做。 public booleanperformEditorAction(int actionCode) 缺省实现将其发送至返回键(enter key)。 参数 actionCode必须是EditorInfo.editorType中一常量之一，如EditorInfo.EDITOR_ACTION_GO。 返回值 成功返回true，输入连接无效时返回false。 public booleanperformPrivateCommand(String action, Bundle data) 缺省实现是什么也不做。 参数 action执行的命令名称。必须是作用域的名称（译者注：带包名，如”com.test.Command”），如以你自己的包名称前缀，这样不同的开发者就不会创建产生冲突的命令。 data命令中的数据。 返回值 命令发送返回true（无论相关的编辑器是否理解它），如输入连接无效返回false。 public static final void removeComposingSpans (Spannable text) public booleanreportFullscreenMode(boolean enabled) 以当前的全屏模式更新InputMethodManager。 public booleansendKeyEvent(KeyEvent event) 提供窗口附属输入连接视窗的发送按键事件的标准实现。 参数 event按键事件。 返回值 成功返回true，输入连接无效时返回false。 public booleansetComposingRegion(int start, int end) 将特定区域标记为正在构建文本。任何以前设置的正在构建文本自动清除。正在构建文本应用缺省样式。 参数 start文本中正在构建区域开始位置。 end文本中正在构建区域结束位置。 返回值 成功返回true，输入连接无效时返回false。 public static void setComposingSpans (Spannable text) public booleansetComposingText(CharSequence text, int newCursorPosition). 缺省实现是将给定文本置入可编辑文本，替代任何正在构建文本。新文本标记为正在构建文本并应用构建样式。 参数 text正在构建文本，如必要应用样式。如文本无附属样式，将正在构建文本应用缺省样式。参见how to attach style object to the text。{#link android.text.SpannableString}和{#link android.text.SpannableStringBuilder}是实现的接口。 newCursorPosition文本范围内新光标位置。如> 0，从文本未尾－1起计算；如<= 0，从文本起始处计算。所以是1时总是在刚插入文本之后。注意这意味着你不能将位置定义在文本中，因为编辑器可以修改你提交的文本，所以无必要将光标定位在文本中。 返回值 成功返回true，输入连接无效时返回false。 public booleansetSelection(int start, int end) 缺省实现是在当前可编辑文本中改变选取的位置。 返回值 成功返回true，输入连接无效时返回false。 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582421，如需转载请自行联系原作者
2017-11-06

资源下载

更多资源
Mario

Mario

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

时间: 2026-04-11 大小: 211.28KB 下载: 56次
腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

时间: 2026-08-21 大小: 1MB 下载: 10次
Nacos

Nacos

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

时间: 2026-09-24 大小: 189MB 下载: 9次
Spring

Spring

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

时间: 2026-08-21 大小: 5MB 下载: 2次
热门标签
DeepSeek Jdk25 OpenAi HarmonyOS6 Nacos3 SpringBoot4 SpringCloud Docker Kubernetes Service Mesh Redis Gemini3 Rocky

欢迎您来访！

登录后，您将获得更多功能！
热门文章
联系我们

有任何问题或合作意向欢迎联系我们

Email: 99873273@qq.com

QQ: 99873273

用户登录
用户注册