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://over140.blog.51cto.com/

　　　　 

版本

　　Android 2.2 r1

 

正文

　　1、結構

　　　　public class AnalogClock extends View

 
 

　　　　java.lang.Object

　　　　　　android.view.View

　　　　　　      android.widget.AnalogClock

 

　　2、類概述

　　　　

　　　　這是一個帶有時針和分針的模擬時鐘控件。

 

　　3、受保護的方法
 

         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。（譯者注：也就是添加到視圖時，oldw和oldh返回的是0）

　　　　參數

　　　　　　w     　　視圖當前寬度

　　　　　　h      　　視圖當前高度

　　　　　　oldw        視圖之前的寬度

　　　　　　oldh         視圖之前的高度

 

　　4、PDF下載

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

　　
 

結束
 

　　 翻譯組目前成員15名，相關計劃正在進行中，期待51名成員的那天早日到來，歡迎你們踊躍參加。