Android2.2 API 中文文檔系列（2） —— EditText

一、結構

　　　　java.lang.Object

android.view.View 

已知直接子類：

AutoCompleteTextView, ExtractEditText

已知間接子類：

MultiAutoCompleteTextView　

二、xml屬性

屬性名稱

描述

android:autoLink

設定是否當文本為URL連結/email/電話号碼/map時，文本顯示為可點選的連結。可選值(none/web/email/phone/map/all)。這裡隻有在同時設定text時才自動識别連結，後來輸入的無法自動識别。

android:autoText

android:bufferType

指定getText()方式取得的文本類别。選項editable 類似于StringBuilder可追加字元，

android:capitalize

設定英文字母大寫類型。設定如下值：sentences僅第一個字母大寫；words每一個單詞首字母大小，用空格區分單詞；characters每一個英文字母都大寫。在模拟器上用PC鍵盤直接輸入可以出效果，但是用軟鍵盤無效果。

android:cursorVisible

設定光标為顯示/隐藏，預設顯示。如果設定false，即使選中了也不顯示光标欄。

android:digits

設定允許輸入哪些字元。如“1234567890.+-*/%\n()”

android:drawableTop

在text的正上方輸出一個drawable。在EditView中的效果比較搞笑： ，居然在文本框裡，而且删不了。

android:drawableBottom

在text的下方輸出一個drawable，如圖檔。如果指定一個顔色的話會把text的背景設為該顔色，并且同時和background使用時覆寫後者。

android:drawableLeft

在text的左邊輸出一個drawable（如圖檔）。

android:drawablePadding

設定text與drawable(圖檔)的間隔，與drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，可設定為負數，單獨使用沒有效果。

android:drawableRight

在text的右邊輸出一個drawable，如圖檔。

android:editable

設定是否可編輯。仍然可以擷取光标，但是無法輸入。

android:editorExtras

指定特定輸入法的擴充，如“com.mydomain.im.SOME_FIELD”。源碼跟蹤至EditorInfo.extras，暫無相關實作代碼。

android:ellipsize

android:freezesText

android:gravity

設定文本位置，如設定成“center”，文本将居中顯示。

android:hint

Text為空時顯示的文字提示資訊，可通過textColorHint設定提示資訊的顔色。

android:imeOptions

設定軟鍵盤的Enter鍵。有如下值可設定：normal，actionUnspecified，actionNone，actionGo

，actionSearch，actionSend，actionNext，actionDone

，flagNoExtractUi，flagNoAccessoryAction，flagNoEnterAction。可用’|’設定多個。這裡僅設定顯示圖示之用，參見文章末尾例子。

android:imeActionId

設定IME動作ID，在onEditorAction中捕獲判斷進行邏輯操作。

android:imeActionLabel

設定IME動作标簽。但是不能保證一定會使用，猜想在輸入法擴充的時候應該有用。

android:includeFontPadding

設定文本是否包含頂部和底部額外空白，預設為true。

android:inputMethod

android:inputType

設定文本的類型，用于幫助輸入法顯示合适的鍵盤類型。有如下值設定：none、text、textCapCharacters字母大小、textCapWords單詞首字母大小、textCapSentences僅第一個字母大小、textAutoCorrect、textAutoComplete自動完成、textMultiLine多行輸入、textImeMultiLine輸入法多行（如果支援）、textNoSuggestions不提示、textEmailAddress電子郵件位址、textEmailSubject郵件主題、textShortMessage短資訊（會多一個表情按鈕出來，點開如下圖：

android:marqueeRepeatLimit

在ellipsize指定marquee的情況下，設定重複滾動的次數，當設定為<code>marquee_forever</code><code>時表示無限次。</code>

android:ems

設定TextView的寬度為N個字元的寬度。參見TextView中此屬性的截圖。

android:maxEms

設定TextView的寬度為最長為N個字元的寬度。與ems同時使用時覆寫ems選項。

android:minEms

設定TextView的寬度為最短為N個字元的寬度。與ems同時使用時覆寫ems選項。

android:maxLength

限制輸入字元數。如設定為5，那麼僅可以輸入5個漢字/數字/英文字母。

android:lines

設定文本的行數，設定兩行就顯示兩行，即使第二行沒有資料。

android:maxLines

設定文本的最大顯示行數，與width或者layout_width結合使用，超出部分自動換行，超出行數将不顯示。

android:minLines

設定文本的最小行數，與lines類似。

android:linksClickable

設定連結是否點選連接配接，即使設定了autoLink。

android:lineSpacingExtra

設定行間距。

android:lineSpacingMultiplier

設定行間距的倍數。如”1.2”

android:numeric

如果被設定，該TextView有一個數字輸入法。有如下值設定：integer正整數、signed帶符号整數、decimal帶小數點浮點數。

android:password

以小點”.”顯示文本

android:phoneNumber

設定為電話号碼的輸入方式。

android:privateImeOptions

android:scrollHorizontally

設定文本超出TextView的寬度的情況下，是否出現橫拉條。

android:selectAllOnFocus

如果文本是可選擇的，讓他擷取焦點而不是将光标移動為文本的開始位置或者末尾位置。TextView中設定後無效果。

android:shadowColor

指定文本陰影的顔色，需要與shadowRadius一起使用。參見TextView中此屬性的截圖。

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

”這裡引用的是系統自帶的一個外觀，？表示系統是否有這種外觀，否則使用預設的外觀。可設定的值如下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge/textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse

android:textColor

設定文本顔色

android:textColorHighlight

被選中文字的底色，預設為藍色

android:textColorHint

設定提示資訊文字的顔色，預設為灰色。與hint一起使用。

android:textColorLink

文字連結的顔色.

android:textScaleX

設定文字之間間隔，預設為1.0f。參見TextView的截圖。

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

android:maxWidth

設定文本區域的最大寬度

android:minWidth

設定文本區域的最小寬度

 　　　　補充說明：

　　　　　　a).　　由于是繼承自TextView，是以屬性是一樣的，但是這裡重點補充了輸入法相關的屬性說明和研究，部分注釋也做了相應的調整。

　　　　　　b).　　Word格式下載下傳

三、例子

　　　　3.1　　 android:imeOptions例子

&lt;EditText android:id="@+id/txtTest" android:imeOptions="actionGo"

     android:layout_width="100dp" android:layout_height="wrap_content"&gt;&lt;/EditText&gt;

((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, "你點了Go!", Toast.LENGTH_SHORT).show();

                }

                return false;

            }

        });