Android2.2 API 中文文檔系列（1） ―― TextView

 

像機械迷城遊戲裡的小工具一樣——每一個控制項都是我們手裡一個有用的工具，由於時間的問題可以暫時先學會其基本用法，但是只要稍有時候還是需要系統的學習一下，起碼知道有這麼個屬性有這麼個方法，以便對某些問題發揮關鍵的作用，只有充分瞭解了才會運用自如。

出處:農民伯伯： http://www.cnblogs.com/over140/

本文

一、TextView的API 中文文檔

1.1 結構

java.lang.Object
↳ android.view.View
↳ android.widget.TextView

直接子類：

Button, CheckedTextView, Chronometer, DigitalClock, EditText

間接子類：
AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText,MultiAutoCompleteTextView, RadioButton, ToggleButton

1.2 API

 

屬性名稱	描述
android:autoLink	設定是否當文本為URL連結/email/電話號碼/map時，文本顯示為可點擊的連結。可選值(none/web/email/phone/map/all)
android:autoText	如果設定，將自動執行輸入值的拼字糾正。此處無效果，在顯示IME並輸入的時候起作用。
android:bufferType	指定getText()方式取得的文本類別。選項editable 類似於StringBuilder可追加字元， 也就是說getText後可調用append方法設定常值內容。spannable 則可在給定的字元地區使用樣式，參見這裡1、這裡2。
android:capitalize	設定英文字母大寫類型。此處無效果，需要彈出IME才能看得到，參見EditText此屬性說明。
android:cursorVisible	設定游標為顯示/隱藏，預設顯示。
android:digits	設定允許輸入哪些字元。如“1234567890.+-*/%/n()”
android:drawableBottom	在text的下方輸出一個drawable，片。如果指定一個顏色的話會把text的背景設為該顏色，並且同時和background使用時覆蓋後者。
android:drawableLeft	在text的左邊輸出一個drawable，片。
android:drawablePadding	設定text與drawable(圖片)的間隔，與drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可設定為負數，單獨使用沒有效果。
android:drawableRight	在text的右邊輸出一個drawable，片。
android:drawableTop	在text的正上方輸出一個drawable，片。
android:editable	設定是否可編輯。這裡無效果，參見EditView。
android:editorExtras	設定文本的額外的輸入資料。在EditView再討論。
android:ellipsize	設定當文字過長時,該控制項該如何顯示。有如下值設定：”start”—–省略符號顯示在開頭；”end”——省略符號顯示在結尾；”middle”—-省略符號顯示在中間；”marquee” ——以跑馬燈的方式顯示(動畫橫向移動)
android:freezesText	設定儲存文本的內容以及游標的位置。參見：這裡。
android:gravity	設定文本位置，如設定成“center”，文本將置中顯示。
android:hint	Text為空白時顯示的文字提示資訊，可通過textColorHint設定提示資訊的顏色。此屬性在EditView中使用，但是這裡也可以用。
android:imeOptions	附加功能，設定右下角IME動作與編輯框相關的動作，如actionDone右下角將顯示一個“完成”，而不設定預設是一個斷行符號符號。這個在EditText中再詳細說明，此處無用。
android:imeActionId	設定IME動作ID。在EditText再做說明，可以先看這篇文章：這裡。
android:imeActionLabel	設定IME動作標籤。在EditText再做說明。
android:includeFontPadding	設定文本是否包含頂部和底部額外空白，預設為true。
android:inputMethod	為文本指定IME，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是這裡報錯找不到。
android:inputType	設定文本的類型，用於協助IME顯示合適的鍵盤類型。在EditText中再詳細說明，這裡無效果。
android:linksClickable	設定連結是否點擊串連，即使設定了autoLink。
android:marqueeRepeatLimit	在ellipsize指定marquee的情況下，設定重複滾動的次數，當設定為marquee_forever時表示無限次。
android:ems	設定TextView的寬度為N個字元的寬度。這裡測試為一個漢字字元寬度，
android:maxEms	設定TextView的寬度為最長為N個字元的寬度。與ems同時使用時覆蓋ems選項。
android:minEms	設定TextView的寬度為最短為N個字元的寬度。與ems同時使用時覆蓋ems選項。
android:maxLength	限制顯示的文本長度，超出部分不顯示。
android:lines	設定文本的行數，設定兩行就顯示兩行，即使第二行沒有資料。
android:maxLines	設定文本的最大顯示行數，與width或者layout_width結合使用，超出部分自動換行，超出行數將不顯示。
android:minLines	設定文本的最小行數，與lines類似。
android:lineSpacingExtra	設定行間距。
android:lineSpacingMultiplier	設定行間距的倍數。如”1.2”
android:numeric	如果被設定，該TextView有一個數字IME。此處無用，設定後唯一效果是TextView有點擊效果，此屬性在EditText將詳細說明。
android:password	以小點”.”顯示文本
android:phoneNumber	設定為電話號碼的輸入方式。
android:privateImeOptions	設定IME選項，此處無用，在EditText將進一步討論。
android:scrollHorizontally	設定文本超出TextView的寬度的情況下，是否出現橫拉條。
android:selectAllOnFocus	如果文本是可選擇的，讓他擷取焦點而不是將游標移動為文本的開始位置或者末尾位置。EditText中設定後無效果。
android:shadowColor	指定文本陰影的顏色，需要與shadowRadius一起使用。效果：
android:shadowDx	設定陰影橫向座標開始位置。
android:shadowDy	設定陰影縱向座標開始位置。
android:shadowRadius	設定陰影的半徑。設定為0.1就變成字型的顏色了，一般設定為3.0的效果比較好。
android:singleLine	設定單行顯示。如果和layout_width一起使用，當文本不能全部顯示時，後面用“…”來表示。如android:text="test_ singleLine " android:singleLine="true" android:layout_width="20dp"將只顯示“t…”。如果不設定singleLine或者設定為false，文本將自動換行
android:text	設定顯示文本.
android:textAppearance	設定文字外觀。如“?android:attr/textAppearanceLargeInverse ”這裡引用的是系統內建的一個外觀，？表示系統是否有這種外觀，否則使用預設的外觀。可設定的值如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse
android:textColor	設定文本顏色
android:textColorHighlight	被選中文字的底色，預設為藍色
android:textColorHint	設定提示資訊文字的顏色，預設為灰色。與hint一起使用。
android:textColorLink	文字連結的顏色.
android:textScaleX	設定文字之間間隔，預設為1.0f。分別設定0.5f/1.0f/1.5f/2.0f效果如下：
android:textSize	設定文字大小，推薦度量單位”sp”，如”15sp”
android:textStyle	設定字形[bold(粗體) 0, italic(斜體) 1, bolditalic(又粗又斜) 2] 可以設定一個或多個，用“|”隔開
android:typeface	設定文本字型，必須是以下常量值之一：normal 0, sans 1, serif 2, monospace(等寬字型) 3]
android:height	設定文本地區的高度，支援度量單位：px(像素)/dp/sp/in/mm(毫米)
android:maxHeight	設定文本地區的最大高度
android:minHeight	設定文本地區的最小高度
android:width	設定文本地區的寬度，支援度量單位：px(像素)/dp/sp/in/mm(毫米)，與layout_width的區別看這裡。
android:maxWidth	設定文本地區的最大寬度
android:minWidth	設定文本地區的最小寬度

1.3 補充說明

1.3.1 以下幾個屬性以及IME相關的在這裡都沒有效果，在EditText將補充說明。

android:numeric/android:digits/android:phoneNumber/android:inputMethod/android:capitalize/android:autoText

1.4 Word格式的API文檔下載

http://download.csdn.net/source/2649980

二、例子

2.1 跑馬燈的效果

http://www.cnblogs.com/over140/archive/2010/08/20/1804770.html

結束

鑒於至此仍未有完整的Android API中文文檔公布出來，我會一直堅持翻譯到有其他組織或官方出完整的API中文文檔為止。在這裡感謝女朋友的支援和協助，為我提供日中翻譯(將 Android API日文版翻譯成中文)和英中翻譯；感謝翻譯工具和搜尋引擎以及其他提供部分屬性翻譯參考的分享者；感謝大家的支援！

轉載:http://tech.srcsky.com/os/embeddedsystems/421880.html