zoukankan      html  css  js  c++  java
  • Android2.2 API 中文文档系列(5) —— View


    前言

      关于View日文转中文的工作在上周女朋友就已经帮我做完,如果要感谢我的翻译成果请先感谢她!但本周太忙,几乎天天加班赶项目,只好把时间挤到周末才完成,这里努力保持一周一篇的进度。View很重要,很多控件都继承自它,所以这里先翻译这篇。

    声明

      欢迎转载,但请保留文章原始出处:)

        博客园:http://www.cnblogs.com

        Android中文翻译组:http://androidbox.sinaapp.com/

    正文

      一、结构

        java.lang.Object
          android.view.View

        已知直接子类:

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

        已知间接子类:

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


      二、xml属性

    属性名称

    描述

    android:background

    设置背景色/背景图片。可以通过以下两种方法设置背景为透明:"@android:color/transparent""@null"。注意TextView默认是透明的,不用写此属性,但是Buttom/ImageButton/ImageView想透明的话就得写这个属性了。

    android:clickable

    是否响应点击事件。 

    android:contentDescription

    设置View的备注说明,作为一种辅助功能提供,为一些没有文字描述的View提供说明,如ImageButton。这里在界面上不会有效果,自己在程序中控制,可临时放一点字符串数据。

    android:drawingCacheQuality

    设置绘图时半透明质量。有以下值可设置:auto(默认,由框架决定)/high(高质量,使用较高的颜色深度,消耗更多的内存/low(低质量,使用较低的颜色深度,但是用更少的内存)。

    android:duplicateParentState

    如果设置此属性,将直接从父容器中获取绘图状态(光标,按下等)。 见下面代码部分,注意根据目前测试情况仅仅是获取绘图状态,而没有获取事件,也就是你点一下LinearLayoutButton有被点击的效果,但是不执行点击事件。

    android:fadingEdge

    设置拉滚动条时 ,边框渐变的放向。none(边框颜色不变),horizontal(水平方向颜色变淡),vertical(垂直方向颜色变淡)。参照fadingEdgeLength的效果图

    android:fadingEdgeLength

    设置边框渐变的长度。

    android:fitsSystemWindows

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

    android:focusable

    设置是否获得焦点。若有requestFocus()被调用时,后者优先处理。注意在表单中想设置某一个如EditText获取焦点,光设置这个是不行的,需要将这个EditText前面的focusable都设置为false才行。在Touch模式下获取焦点需要设置focusableInTouchMode为true。

    android:focusableInTouchMode

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

    android:hapticFeedbackEnabled

    设置触感反馈。(译者注:按软键以及进行某些UI交互时振动,暂时不知道用法,大家可以找找performHapticFeedbackHapticFeedback这个关键字的资料看看。)

    android:id

    给当前View设置一个在当前layout.xml中的唯一编号,可以通过调用View.findViewById() Activity.findViewById()根据这个编号查找到对应的View。不同的layout.xml之间定义相同的id不会冲突。格式如”@+id/btnName”

    android:isScrollContainer

    设置当前View为滚动容器。这里没有测试出效果来,ListView/ GridView/ ScrollView根本就不用设置这个属性,而EdidText设置android:scrollbars也能出滚动条。

    android:keepScreenOn

    View在可见的情况下是否保持唤醒状态。常在LinearLayout使用该属性,但是模拟器这里没有效果。

            

    android:longClickable

    设置是否响应长按事件.

    android:minHeight

    设置视图最小高度

    android:minWidth

    设置视图最小宽度度

    android:nextFocusDown

    设置下方指定视图获得下一个焦点。焦点移动是基于一个在给定方向查找最近邻居的算法。如果指定视图不存在,移动焦点时将报运行时错误。可以设置imeOptions= actionDone,这样输入完即跳到下一个焦点。

    android:nextFocusLeft

    设置左边指定视图获得下一个焦点。

    android:nextFocusRight

    设置右边指定视图获得下一个焦点。

    android:nextFocusUp

    设置上方指定视图获得下一个焦点。

    android:onClick

    点击时从上下文中调用指定的方法。这里指定一个方法名称,一般在Activity定义符合如下参数和返回值的函数并将方法名字符串指定为该值即可:

    public void onClickButton(View view)

    android:onClick=” onClickButton”

    android:padding

    设置上下左右的内边距,以像素为单位填充空白。(译者注:下图是Button外部嵌套了一个容器,设置了容器的内边距)

     

    android:paddingBottom

    设置底部的边距,以像素为单位填充空白。(译者注:下图是Button外部嵌套了一个容器,设置了容器的内边距)

                   

    android:paddingLeft

    设置左边的边距,以像素为单位填充空白。(译者注:下图是Button外部嵌套了一个容器,设置了容器的内边距)

                  

    android:paddingRight

    设置右边的边距,以像素为单位填充空白。(译者注:下图是Button外部嵌套了一个容器,设置了容器的内边距)

                 

    android:paddingTop

    设置上方的边距,以像素为单位填充空白。(译者注:下图是Button外部嵌套了一个容器,设置了容器的内边距)

                   

    android:saveEnabled

    设置是否在窗口冻结时(如旋转屏幕)保存View的数据,默认为true,但是前提是你需要设置id才能自动保存,参见这里

    android:scrollX

    以像素为单位设置水平方向滚动的的偏移值,在GridView中可看的这个效果。

    android:scrollY

    以像素为单位设置垂直方向滚动的的偏移值

    android:scrollbarAlwaysDraw

    HorizontalTrack

    设置是否始终显示垂直滚动条。这里用ScrollViewListView测试均没有效果。

    android:scrollbarAlwaysDraw

    VerticalTrack

    设置是否始终显示垂直滚动条。这里用ScrollViewListView测试均没有效果。

    android:scrollbarDefault

    DelayBeforeFade

    设置N毫秒后开始淡化,以毫秒为单位。

    android:scrollbarFadeDuration

    设置滚动条淡出效果(从有到慢慢的变淡直至消失)时间,以毫秒为单位。Android2.2中滚动条滚动完之后会消失,再滚动又会出来,在1.51.6版本里面会一直显示着。

    android:scrollbarSize

    设置滚动条的宽度。

    android:scrollbarStyle

    设置滚动条的风格和位置。设置值:insideOverlayinsideInsetoutsideOverlayoutsideInset。这里没有试出太多效果,以下依次是outsideOverlayoutsideInset效果截图比较:

     

     

    android:scrollbarThumbHorizontal

    设置水平滚动条的drawable

                      

    android:scrollbarThumbVertical

    设置垂直滚动条的drawable.

                      

    android:scrollbarTrackHorizontal

    设置水平滚动条背景(轨迹)的色drawable

                      

    android:scrollbarTrackVertical

    设置垂直滚动条背景(轨迹)的drawable注意直接
    设置颜色值如”android:color/white”将得出很难看的效果,
    甚至都不理解这个属性了,这里可以
    参见ApiDemos里res/drawable/ 
    scrollbar_vertical_thumb.xml和
    scrollbar_vertical_track.xml,设置代码为:
    android:scrollbarTrackVertical 
    ="@drawable/scrollbar_vertical_track"
                

    android:scrollbars

    设置滚动条显示。none(隐藏),horizontal(水平),vertical(垂直)。见下列代码演示使用该属性让EditText内有滚动条。但是其他容器如LinearLayout设置了但是没有效果。

                        

    android:soundEffectsEnabled

    设置点击或触摸时是否有声音效果

    android:tag

    设置一个文本标签。可以通过View.getTag() for with

    View.findViewWithTag()检索含有该标签字符串的View。但

    一般最好通过ID来查询View,因为它的速度更快,并且允

    许编译时类型检查。

    android:visibility

    设置是否显示View。设置值:visible(默认值,显示),invisible(不显示,但是仍然占用空间),gone

    (不显示,不占用空间)

     

      四、代码

        4.1  android:duplicateParentState

    <LinearLayout android:clickable="true" android:background="#ff0fff" android:layout_width="100dp" android:layout_height="100dp">
            
    <Button android:duplicateParentState="true" android:layout_width="wrap_content" android:layout_height="wrap_content"/>
    </LinearLayout>

        4.2  android:scrollbars

    <EditText android:layout_width="fill_parent"
    android:layout_height="wrap_content" android:minHeight="50dp"
    android:background="@android:drawable/editbox_background"
    android:scrollbars="vertical"
            android:maxLines="4">
    </EditText>

      五、遗留问题

        5.1  以下几个属性翻遍了资料试了很多次都没有效果,只能暂时搁置,以后补上,也欢迎的大家提供意见和线索,分享大家的经验:

          android:scrollbarAlwaysDrawHorizontalTrack   

          android:scrollbarAlwaysDrawVerticalTrack

          android:isScrollContainer

      六、下载

        Word下载地址:http://download.csdn.net/source/2687015 

        

    结束

      目前已经联系到了2名译者不定期提供翻译稿,欢迎更多译者一起参与Android API 的中文翻译行动!我的邮箱over140@gmail.com。 凡是我翻译的,我尽量保证宁可少翻译一篇,也不要翻译一个我自己都看不懂的属性,个别由于能力有限翻译不出来的会特别标注出来,欢迎大家指正!

  • 相关阅读:
    Scala学习笔记(四)—— 数组
    Scala学习笔记(三)—— 方法和函数
    Scala学习笔记(二)——Scala基础
    Scala学习笔记(一)
    HDFS和GFS对比学习
    HDFS原理学习
    c++日历问题
    Mapreduce学习
    c++动态规划解决数塔问题
    C++——数码管
  • 原文地址:https://www.cnblogs.com/over140/p/1823806.html
Copyright © 2011-2022 走看看