前言php
關鍵字: Android API 中文文檔,android sdk 中文,Android TextView 詳解
html
像機械迷城遊戲裏的小工具同樣——每個控件都是咱們手裏一個有用的工具,因爲時間的問題能夠暫時先學會其基本用法,可是隻要稍有時候仍是須要系統的學習一下,起碼知道有這麼個屬性有這麼個方法,以便對某些問題發揮關鍵的做用,只有充分了解了纔會運用自如。
java
聲明android
歡迎轉載,但請保留文章原始出處:)
git
農民伯伯:http://over140.blog.51cto.com/web
正文api
1、TextView的API 中文文檔
app
1.1 結構ide
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 |
若是設置,將自動執行輸入值的拼寫糾正。此處無效果,在顯示輸入法並輸入的時候起做用。 |
android:bufferType |
指定getText()方式取得的文本類別。選項editable 相似於StringBuilder可追加字符, 也就是說getText後可調用append方法設置文本內容。spannable 則可在給定的字符區域使用樣式,參見這裏1、這裏2。 |
android:capitalize |
設置英文字母大寫類型。此處無效果,須要彈出輸入法才能看獲得,參見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 |
爲文本指定輸入法,須要徹底限定名(完整的包名)。例如:com.google.android.inputmethod.pinyin,可是這裏報錯找不到。 |
android:inputType |
設置文本的類型,用於幫助輸入法顯示合適的鍵盤類型。在EditText中再詳細說明,這裏無效果。 |
android:linksClickable |
設置連接是否點擊鏈接,即便設置了autoLink。 |
android:marqueeRepeatLimit |
在ellipsize指定marquee的狀況下,設置重複滾動的次數,當設置爲 |
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有一個數字輸入法。此處無用,設置後惟一效果是TextView有點擊效果,此屬性在EditText將詳細說明。 |
android:password |
以小點」.」顯示文本 |
android:phoneNumber |
設置爲電話號碼的輸入方式。 |
android:privateImeOptions |
設置輸入法選項,此處無用,在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 如下幾個屬性以及輸入法相關的在這裏都沒有效果,在EditText將補充說明。
android:numeric/android:digits/android:phoneNumber/android:inputMethod/android:capitalize/android:autoText
1.4 Word格式的API文檔下載
http://download.csdn.net/source/2649980
2、例子
2.1 ×××燈的效果
http://www.cnblogs.com/over140/archive/2010/08/20/1804770.html
3、系列
Android 2.2 API 中文文檔系列(1) —— TextView
Android 2.2 API 中文文檔系列(2) —— EditText
Android 2.2 API 中文文檔系列(3) —— AccessibilityService
Android 2.2 API 中文文檔系列(4) —— Manifest
Android 2.2 API 中文文檔系列(5) —— View
Android 2.2 API 中文文檔系列(6) —— ImageView
Android 2.2 API 中文文檔系列(7) —— ImageButton
Android 2.2 API 中文文檔系列(8) —— QuickContactBadge
Android 2.2 API 中文文檔系列(9) —— ZoomButton
Android 2.2 r1 API 中文文檔系列(10) —— CheckBox
Android 2.2 r1 API 中文文檔系列(11) —— RadioButton
Android 2.2 r1 API 中文文檔系列(12) —— Button
Android API 中文(13) —— ToggleButton
Android API 中文(14) —— ViewStub
Android API 中文 (15) —— GridView
Android 中文 API (16) —— AnalogClock
Android 中文 API (17) —— TextSwitcher
Android 中文 API (18) —— AbsSeekBar
Android 中文 API (19) —— TwoLineListItem
Android 中文 API (20) —— DatePicker
結束
鑑於至此仍未有完整的Android API中文文檔公佈出來,我會一直堅持翻譯到有其餘組織或官方出完整的API中文文檔爲止。在這裏感謝女友的支持和幫助,爲我提供日中翻譯(將Android API日文版翻譯成中文)和英中翻譯;感謝翻譯工具和搜索引擎以及其餘提供部分屬性翻譯參考的分享者;感謝你們的支持!