Android API中文文檔TextView
Android API中文文檔TextView是本文要介紹的內(nèi)容,主要是來了解并學(xué)習(xí)Android API文檔的內(nèi)容,具體關(guān)于Android API文檔內(nèi)容的詳解來看本文。
像機(jī)械迷城游戲里的小工具一樣,每一個(gè)控件都是我們手里一個(gè)有用的工具,由于時(shí)間的問題可以暫時(shí)先學(xué)會其基本用法,但是只要稍有時(shí)候還是需要系統(tǒng)的學(xué)習(xí)一下,起碼知道有這么個(gè)屬性有這么個(gè)方法,以便對某些問題發(fā)揮關(guān)鍵的作用,只有充分了解了才會運(yùn)用自如。
Android API中TextView的API 中文文檔
1、結(jié)構(gòu)
java.lang.Object android.view.View android.widget.TextView
直接子類:
- Button, CheckedTextView, Chronometer, DigitalClock, EditText
間接子類:
- AutoCompleteTextView, CheckBox, CompoundButton, ExtractEditText,MultiAutoCompleteTextView, RadioButton, ToggleButton
2、Android API
屬性名稱 描述
android:autoLink:設(shè)置是否當(dāng)文本為URL鏈接email電話號碼map時(shí),文本顯示為可點(diǎn)擊的鏈接。可選值(nonewebemailphonemapall)
android:autoText:如果設(shè)置,將自動執(zhí)行輸入值的拼寫糾正。此處無效果,在顯示輸入法并輸入的時(shí)候起作用。
android:bufferType:指定getText()方式取得的文本類別。選項(xiàng)editable 類似于StringBuilder可追加字符,也就是說getText后可調(diào)用append方法設(shè)置文本內(nèi)容。spannable 則可在給定的字符區(qū)域使用樣式,參見這里1、這里2
android:capitalize: 設(shè)置英文字母大寫類型。此處無效果,需要彈出輸入法才能看得到,參見EditText此屬性說明
android:cursorVisible:設(shè)定光標(biāo)為顯示隱藏,默認(rèn)顯示
android:digits:設(shè)置允許輸入哪些字符。如“1234567890.+-*%\n()”
android:drawableBottom:在text的下方輸出一個(gè)drawable,如圖片。如果指定一個(gè)顏色的話會把text的背景設(shè)為該顏色,并且同時(shí)和background使用時(shí)覆蓋后者。
android:drawableLeft:在text的左邊輸出一個(gè)drawable,如圖片。
android:drawablePadding:設(shè)置text與drawable(圖片)的間隔,與drawableLeft、drawableRight、drawableTop、drawableBottom一起使用,可設(shè)置為負(fù)數(shù),單獨(dú)使用沒有效果。
android:drawableRight:在text的右邊輸出一個(gè)drawable,如圖片。
android:drawableTop:在text的正上方輸出一個(gè)drawable,如圖片。
android:editable:設(shè)置是否可編輯。這里無效果,參見EditView。
android:editorExtras:設(shè)置文本的額外的輸入數(shù)據(jù)。在EditView再討論。
android:ellipsize:設(shè)置當(dāng)文字過長時(shí),該控件該如何顯示。有如下值設(shè)置:
”start”—–省略號顯示在開頭;
”end”——省略號顯示在結(jié)尾;
”middle”—-省略號顯示在中間;
”marquee” ——以跑馬燈的方式顯示(動畫橫向移動)
android:freezesText:設(shè)置保存文本的內(nèi)容以及光標(biāo)的位置。參見:這里。
android:gravity:設(shè)置文本位置,如設(shè)置成“center”,文本將居中顯示。
android:hint:Text為空時(shí)顯示的文字提示信息,可通過textColorHint設(shè)置提示信息的顏色。此屬性在EditView中使用,但是這里也可以用。
android:imeOptions:附加功能,設(shè)置右下角IME動作與編輯框相關(guān)的動作,如actionDone右下角將顯示一個(gè)“完成”,而不設(shè)置默認(rèn)是一個(gè)回車符號。這個(gè)在EditText中再詳細(xì)說明,此處無用。
android:imeActionId:設(shè)置IME動作ID。在EditText再做說明,可以先看這篇帖子:這里。
android:imeActionLabel:設(shè)置IME動作標(biāo)簽。在EditText再做說明。
android:includeFontPadding:設(shè)置文本是否包含頂部和底部額外空白,默認(rèn)為true。
android:inputMethod:為文本指定輸入法,需要完全限定名(完整的包名)。例如:com.google.android.inputmethod.pinyin,但是這里報(bào)錯(cuò)找不到。
android:inputType:設(shè)置文本的類型,用于幫助輸入法顯示合適的鍵盤類型。在EditText中再詳細(xì)說明,這里無效果。 android:linksClickable:設(shè)置鏈接是否點(diǎn)擊連接,即使設(shè)置了autoLink。
android:marqueeRepeatLimit:在ellipsize指定marquee的情況下,設(shè)置重復(fù)滾動的次數(shù),當(dāng)設(shè)置為marquee_forever時(shí)表示無限次。
android:ems:設(shè)置TextView的寬度為N個(gè)字符的寬度。這里測試為一個(gè)漢字字符寬度,如圖:
android:maxEms:設(shè)置TextView的寬度為最長為N個(gè)字符的寬度。與ems同時(shí)使用時(shí)覆蓋ems選項(xiàng)。
android:minEms:設(shè)置TextView的寬度為最短為N個(gè)字符的寬度。與ems同時(shí)使用時(shí)覆蓋ems選項(xiàng)。
android:maxLength:限制顯示的文本長度,超出部分不顯示。
android:lines:設(shè)置文本的行數(shù),設(shè)置兩行就顯示兩行,即使第二行沒有數(shù)據(jù)。
android:maxLines:設(shè)置文本的最大顯示行數(shù),與width或者layout_width結(jié)合使用,超出部分自動換行,超出行數(shù)將不顯示。
android:minLines:設(shè)置文本的最小行數(shù),與lines類似
android:lineSpacingExtra:設(shè)置行間距。
android:lineSpacingMultiplier:設(shè)置行間距的倍數(shù)。如”1.2”
android:numeric:如果被設(shè)置,該TextView有一個(gè)數(shù)字輸入法。此處無用,設(shè)置后唯一效果是TextView有點(diǎn)擊效果,此屬性在EditText將詳細(xì)說明。
android:password:以小點(diǎn)”.”顯示文本
android:phoneNumber:設(shè)置為電話號碼的輸入方式。
android:privateImeOptions:設(shè)置輸入法選項(xiàng),此處無用,在EditText將進(jìn)一步討論。
android:scrollHorizontally:設(shè)置文本超出TextView的寬度的情況下,是否出現(xiàn)橫拉條。
android:selectAllOnFocus:如果文本是可選擇的,讓他獲取焦點(diǎn)而不是將光標(biāo)移動為文本的開始位置或者末尾位置。EditText中設(shè)置后無效果。
android:shadowColor:指定文本陰影的顏色,需要與shadowRadius一起使用。效果:
android:shadowDx:設(shè)置陰影橫向坐標(biāo)開始位置。
android:shadowDy:設(shè)置陰影縱向坐標(biāo)開始位置。
android:shadowRadius:設(shè)置陰影的半徑。設(shè)置為0.1就變成字體的顏色了,一般設(shè)置為3.0的效果比較好。
android:singleLine:設(shè)置單行顯示。如果和layout_width一起使用,當(dāng)文本不能全部顯示時(shí),后面用“…”來表示。
如
- android:text="test_ singleLine "
- android:singleLine="true"
- android:layout_width="20dp"將只顯示“t…”。如果不設(shè)置singleLine或者設(shè)置為false,文本將自動換行
android:text:設(shè)置顯示文本
android:textAppearance:設(shè)置文字外觀。如“?android:attrtextAppearanceLargeInverse
”這里引用的是系統(tǒng)自帶的一個(gè)外觀,?表示系統(tǒng)是否有這種外觀,否則使用默認(rèn)的外觀。可設(shè)置的值如下:
- textAppearanceButton
- textAppearanceInverse
- textAppearanceLarge
- textAppearanceLargeInverse
- textAppearanceMedium
- textAppearanceMediumInverse
- textAppearanceSmall
- textAppearanceSmallInverse
android:textColor:設(shè)置文本顏色
android:textColorHighlight:被選中文字的底色,默認(rèn)為藍(lán)色
android:textColorHint:設(shè)置提示信息文字的顏色,默認(rèn)為灰色。與hint一起使用。
android:textColorLink:文字鏈接的顏色.
android:textScaleX:設(shè)置文字之間間隔,默認(rèn)為1.0f。分別設(shè)置0.5f1.0f1.5f2.0f效果如下:
android:textSize:設(shè)置文字大小,推薦度量單位”sp”,如”15sp”
android:textStyle:設(shè)置字形[bold(粗體) 0, italic(斜體) 1, bolditalic(又粗又斜) 2] 可以設(shè)置一個(gè)或多個(gè),用“|”隔開
android:typeface:設(shè)置文本字體,必須是以下常量值之一:normal 0, sans 1, serif 2, monospace(等寬字體) 3]
android:height:設(shè)置文本區(qū)域的高度,支持度量單位:px(像素)dpspinmm(毫米)
android:maxHeight:設(shè)置文本區(qū)域的最大高度
android:minHeight:設(shè)置文本區(qū)域的最小高度
android:width:設(shè)置文本區(qū)域的寬度,支持度量單位:px(像素)dpspinmm(毫米),與layout_width的區(qū)別看這里。
android:maxWidth:設(shè)置文本區(qū)域的最大寬度
android:minWidth:設(shè)置文本區(qū)域的最小寬度。
小結(jié):Android API中文文檔TextView的內(nèi)容介紹完了,希望通過Android API內(nèi)容的學(xué)習(xí)能對你有所幫助!