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