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

　　　　參數

　　　　　　w     　　視圖當前寬度

　　　　　　h      　　視圖當前高度

　　　　　　oldw        視圖以前的寬度

　　　　　　oldh         視圖以前的高度

 

　　四、PDF下載

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

　　

結束

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