Android API中文文檔EditText是本文要介紹的內(nèi)容，主要是來(lái)了解并學(xué)習(xí)Android API文檔的幫助，具體關(guān)于Android API的內(nèi)容的詳解來(lái)看本文。

一、Android API中結(jié)構(gòu)

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

已知直接子類：

AutoCompleteTextView,ExtractEditText 

已知間接子類：

MultiAutoCompleteTextView 

二、Android API中xml屬性

屬性名稱描述

android:autoLink設(shè)置是否當(dāng)文本為URL鏈接/email/電話號(hào)碼/map時(shí)，文本顯示為可點(diǎn)擊的鏈接。可選值(none/web/email/phone/map/all)。這里只有在同時(shí)設(shè)置text時(shí)才自動(dòng)識(shí)別鏈接，后來(lái)輸入的無(wú)法自動(dòng)識(shí)別。

android:autoText自動(dòng)拼寫幫助。這里單獨(dú)設(shè)置是沒(méi)有效果的，可能需要其他輸入法輔助才行，效果參見(jiàn)視頻。

android:bufferType指定getText()方式取得的文本類別。選項(xiàng)editable類似于StringBuilder可追加字符，

也就是說(shuō)getText后可調(diào)用append方法設(shè)置文本內(nèi)容。spannable則可在給定的字符區(qū)域使用樣式，參見(jiàn)這里1、這里2。

android:capitalize設(shè)置英文字母大寫類型。設(shè)置如下值：sentences僅***個(gè)字母大寫；words每一個(gè)單詞首字母大小，用空格區(qū)分單詞；characters每一個(gè)英文字母都大寫。在模擬器上用PC鍵盤直接輸入可以出效果，但是用軟鍵盤無(wú)效果。

android:cursorVisible設(shè)定光標(biāo)為顯示/隱藏，默認(rèn)顯示。如果設(shè)置false，即使選中了也不顯示光標(biāo)欄。

android:digits設(shè)置允許輸入哪些字符。如“1234567890.+-*/%\n()”

android:drawableTop在text的正上方輸出一個(gè)drawable。在EditView中的效果比較搞笑：，居然在文本框里，而且刪不了。

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:editable設(shè)置是否可編輯。仍然可以獲取光標(biāo)，但是無(wú)法輸入。

android:editorExtras指定特定輸入法的擴(kuò)展，如“com.mydomain.im.SOME_FIELD”。源碼跟蹤至EditorInfo.extras，暫無(wú)相關(guān)實(shí)現(xiàn)代碼。

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)畫橫向移動(dòng))

android:freezesText設(shè)置保存文本的內(nèi)容以及光標(biāo)的位置。參見(jiàn)：這里。

android:gravity設(shè)置文本位置，如設(shè)置成“center”，文本將居中顯示。

android:hintText為空時(shí)顯示的文字提示信息，可通過(guò)textColorHint設(shè)置提示信息的顏色。

android:imeOptions設(shè)置軟鍵盤的Enter鍵。有如下值可設(shè)置：normal，actionUnspecified，actionNone，actionGo，actionSearch，actionSend，actionNext，actionDone，flagNoExtractUi，flagNoAccessoryAction，flagNoEnterAction?？捎?rsquo;|’設(shè)置多個(gè)。這里僅設(shè)置顯示圖標(biāo)之用，參見(jiàn)文章末尾例子。

android:imeActionId設(shè)置IME動(dòng)作ID，在onEditorAction中捕獲判斷進(jìn)行邏輯操作。

android:imeActionLabel設(shè)置IME動(dòng)作標(biāo)簽。但是不能保證一定會(huì)使用，猜想在輸入法擴(kuò)展的時(shí)候應(yīng)該有用。

android:includeFontPadding設(shè)置文本是否包含頂部和底部額外空白，默認(rèn)為true。

android:inputMethod為文本指定輸入法，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是這里報(bào)錯(cuò)找不到。關(guān)于自定義輸入法參見(jiàn)這里。

android:inputType設(shè)置文本的類型，用于幫助輸入法顯示合適的鍵盤類型。有如下值設(shè)置：none、text、textCapCharacters字母大小、textCapWords單詞首字母大小、textCapSentences僅***個(gè)字母大小、textAutoCorrect、textAutoComplete自動(dòng)完成、textMultiLine多行輸入、textImeMultiLine輸入法多行（如果支持）、textNoSuggestions不提示、textEmailAddress電子郵件地址、textEmailSubject郵件主題、textShortMessage短信息（會(huì)多一個(gè)表情按鈕出來(lái)，點(diǎn)開(kāi)如下圖：

）、textLongMessage長(zhǎng)訊息？、textPersonName人名、textPostalAddress地址、textPassword密碼、textVisiblePassword可見(jiàn)密碼、textWebEditText作為網(wǎng)頁(yè)表單的文本、textFilte文本篩選過(guò)濾、textPhonetic拼音輸入、numberSigned有符號(hào)數(shù)字格式、numberDecimal可帶小數(shù)點(diǎn)的浮點(diǎn)格式、phone電話號(hào)碼、datetime時(shí)間日期、date日期、time時(shí)間。部分參考這里。

android:marqueeRepeatLimit在ellipsize指定marquee的情況下，設(shè)置重復(fù)滾動(dòng)的次數(shù)，當(dāng)設(shè)置為marquee_forever時(shí)表示無(wú)限次。

android:ems設(shè)置TextView的寬度為N個(gè)字符的寬度。參見(jiàn)TextView中此屬性的截圖。

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限制輸入字符數(shù)。如設(shè)置為5，那么僅可以輸入5個(gè)漢字/數(shù)字/英文字母。

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類似。

android:linksClickable設(shè)置鏈接是否點(diǎn)擊連接，即使設(shè)置了autoLink。

android:lineSpacingExtra設(shè)置行間距。

android:lineSpacingMultiplier設(shè)置行間距的倍數(shù)。如”1.2”

android:numeric如果被設(shè)置，該TextView有一個(gè)數(shù)字輸入法。有如下值設(shè)置：integer正整數(shù)、signed帶符號(hào)整數(shù)、decimal帶小數(shù)點(diǎn)浮點(diǎn)數(shù)。

android:password以小點(diǎn)”.”顯示文本

android:phoneNumber設(shè)置為電話號(hào)碼的輸入方式。

android:privateImeOptions提供額外的輸入法選項(xiàng)(字符串格式)。依據(jù)輸入法而決定是否提供，如這里所見(jiàn)。自定義輸入法繼承InputMethodService。這篇文章也許有幫助。

android:scrollHorizontally設(shè)置文本超出TextView的寬度的情況下，是否出現(xiàn)橫拉條。

android:selectAllOnFocus如果文本是可選擇的，讓他獲取焦點(diǎn)而不是將光標(biāo)移動(dòng)為文本的開(kāi)始位置或者末尾位置。TextView中設(shè)置后無(wú)效果。

android:shadowColor指定文本陰影的顏色，需要與shadowRadius一起使用。參見(jiàn)TextView中此屬性的截圖。

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:attr/textAppearanceLargeInverse

”這里引用的是系統(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。參見(jiàn)TextView的截圖。

android:textSize設(shè)置文字大小，推薦度量單位”sp”，如”15sp”

android:textStyle設(shè)置字形[bold(粗體)0,italic(斜體)1,bolditalic(又粗又斜)2]可以設(shè)置一個(gè)或多個(gè)，用“|”隔開(kāi)

android:typeface設(shè)置文本字體，必須是以下常量值之一：normal0,sans1,serif2,monospace(等寬字體)3]

android:height設(shè)置文本區(qū)域的高度，支持度量單位：px(像素)/dp/sp/in/mm(毫米)

android:maxHeight設(shè)置文本區(qū)域的***高度

android:minHeight設(shè)置文本區(qū)域的最小高度

android:width設(shè)置文本區(qū)域的寬度，支持度量單位：px(像素)/dp/sp/in/mm(毫米)，與layout_width的區(qū)別看這里。

android:maxWidth設(shè)置文本區(qū)域的***寬度

android:minWidth設(shè)置文本區(qū)域的最小寬度

三、Android API例子

<!--[endif]-->android:imeOptions例子  
 
<EditText android:id="@+id/txtTest" android:imeOptions="actionGo" 
     android:layout_width="100dp" android:layout_height="wrap_content"></EditText> 
 
((EditText)findViewById(R.id.txtTest)).setOnEditorActionListener(new TextView.OnEditorActionListener() {  
            @Override  
            public boolean onEditorAction(TextView v, int actionId,  
                    KeyEvent event) {  
                if (actionId == EditorInfo.IME_ACTION_GO) {  
                    Toast.makeText(TestActivity.this, "你點(diǎn)了Go!", Toast.LENGTH_SHORT).show();  
                }  
                return false;  
            }  
        }); 

小結(jié)：Android API中文文檔EditText的內(nèi)容介紹完了，希望通過(guò)Android API內(nèi)容的學(xué)習(xí)能對(duì)你有所幫助~