Android 中文 API (16) —— AnalogClock


前言

  关键字: android.widget.AnalogClock, Android 2.2 r1 AnalogClock, AnalogClock api

  本章翻译的是android.widget.AnalogClock,译为时钟/模拟时钟。从本章开始,系列翻译文章正式更名为“Android 中文 ?”,如当前系列为“Android 中文 API”,此外已经有人在翻译测试相关的内容,欢迎一起参与Android API 的中文翻译行动,联系我over140@gmail.com。

 

声明

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

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

    农民伯伯: http://www.cnblogs.com/over140/

 

版本

  Android 2.2 r1

 

正文

  一、结构

    public class AnalogClock extends View

 

    java.lang.Object

      android.view.View

            android.widget.AnalogClock

 

  二、类概述

    

    这是一个带有时针和分针的模拟时钟控件。

 

  三、受保护的方法

         protected void onAttachedToWindow ()

         视图(AnalogClock)附在窗体时调用。在调用时,视图在窗体表面并开始绘制。注意保证这个方法在onDraw(Canvas)以前被调用,但是它可以在首次onDraw以前任何时间调用——包括onMeasure(int, int)之前或之后。

 

         protected void onDetachedFromWindow ()

         视图(DigitalClock)从窗体上分离(移除)时调用,同时窗体表面不再绘制视图。

 

         protected void onDraw (Canvas canvas)

         实现你自己的绘制。

                   参数

                            canvas    在画布上绘制背景

 

         protected void onMeasure (int widthMeasureSpec, int heightMeasureSpec)

  测量这个视图以确定其内容的高度和宽度。通过measure(int, int)来调用这个方法,并且应该由子类重写以提高内容测量的效率和精确度。

  约定:当该方法被重写时,你必须调用setMeasuredDimension(int, int)来存储已测量视图的高度和宽度。否则将通过measure(int, int)抛出一个IllegalStateException异常。调用父类的onMeasure(int, int)方法是一个有效的办法。

  父类的实现是以背景大小为默认大小,除非MeasureSpec(测量细则)允许更大的背景。 为了更好测量内容子类应该重写onMeasure(int, int)

  如果这个方法被重写,子类有责任确保测量它的高度和宽度至少是视图的最小宽度和高度(getSuggestedMinimumHeight()getSuggestedMinimumWidth())。

参数

widthMeasureSpec         由于父类有横向空间要求,参见View.MeasureSpec

                            heightMeasureSpec        由于父类有纵向空间要求,参见View.MeasureSpec

 

         protected void onSizeChanged (int w, int h, int oldw, int oldh)

         布局期间当视图的大小发生改变时调用。如果只是添加到视图,调用时显示的是旧值0。(译者注:也就是添加到视图时,oldwoldh返回的是0

    参数

      w       视图当前宽度

      h        视图当前高度

      oldw        视图以前的宽度

      oldh         视图以前的高度

 

  四、PDF下载

    CSDN: http://download.csdn.net/source/2772172

  

结束

   翻译组目前成员15名,相关计划正在进行中,期待51名成员的那天早日到来,欢迎大家踊跃参加。

posted @ 2010-10-21 10:01  农民伯伯  阅读(6377)  评论(0编辑  收藏  举报