本文主要研究一下EditText的屬性（還沒研究完，邊研究邊寫）
一、結構
java.lang.Object
↳ android.view.View
↳ android.widget.TextView
↳ android.widget.EditText
已知直接子類：
AutoCompleteTextView, ExtractEditText
已知間接子類：
MultiAutoCompleteTextView
二、xml屬性
| 屬性名稱 |
描述 |
| android:autoLink |
設置是否當文本為URL鏈接/email/電話號碼/map時， 文本顯示為可點擊的鏈接。 可選值(none/web/email/phone/map/all)。 這里只有在同時設置text時才自動識別鏈接，后來輸入的無法自動識別。 |
| android:autoText |
自動拼寫幫助。這里單獨設置是沒有效果的， 可能需要其他輸入法輔助才行，效果參見視頻 。 |
| android:bufferType |
指定getText()方式取得的文本類別。選項editable 類似於StringBuilder可追加字符， 也就是說getText后可調用append方法設置文本內容。 spannable 則可在給定的字符區域使用樣式，參見這里1 、這里2 。 |
| 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 |
設置當文字過長時,該控件 該如何顯示。 有如下值設置：”start”—–省略號顯示在開頭；”end”——省略號 顯示在結尾；”middle”—-省略號顯示在中間； ”marquee” ——以跑馬燈 的方式顯示(動畫 橫向移動)
|
| android:freezesText |
設置保存文本的內容以及光標的位置。參見：這里 |
| android:gravity |
設置文本位置，如設置成“center”，文本將居中顯示。 |
| android:hint |
Text為空時顯示的文字提示信息， 可通過textColorHint設置提示信息的顏色。 |
| android:imeOptions |
設置軟鍵盤的Enter鍵。 有如下值可設置：normal，actionUnspecified，actionNone，actionGo ，actionSearch，actionSend，actionNext，actionDone 可用’|’設置多個。這里僅設置顯示圖標之用，參見文章末尾例子。 |
| android:imeActionId |
設置IME動作ID，在onEditorAction中捕獲判斷進行邏輯操作。 |
| android:imeActionLabel |
設置IME動作標簽。但是不能保證一定會使用，猜想在輸入法擴展的時候應該有用。 |
| android:includeFontPadding |
設置文本是否包含頂部和底部額外空白，默認為true。 |
| android:inputMethod |
為文本指定輸入法，需要完全限定名（完整的包名）。例如：com.google.android.inputmethod.pinyin，但是這里報錯找不到。關於自定義輸入法參見這里 。 |
| android:inputType |
設置文本的類型，用於幫助輸入法顯示合適的鍵盤類型。 有如下值設置：none、text、 textCapCharacters字母大小、 textCapWords單詞首字母大小、textCapSentences僅第一個字母大小、 textAutoCorrect、textAutoComplete自動完成、textMultiLine多行輸入、 textImeMultiLine輸 入法多行（如果支持）、textNoSuggestions不提示、 textEmailAddress電子郵件地址、textEmailSubject郵 件主題、 textShortMessage短信息（會多一個表情按鈕出來，點開如下圖： <IGNORE_JS_OP>
）、textLongMessage長訊息？、 textPersonName人名、 textPostalAddress地址、 textPassword密碼、textVisiblePassword可見密碼、 textWebEditText作為網頁表單的文本、textFilte文本篩選過濾、 textPhonetic拼音輸入、numberSigned有符 號數字格式、 numberDecimal可帶小數點的浮點格式、 phone電話號碼、datetime時間日期、 date日期、time時間。部分參考這里 。 |
| android:marqueeRepeatLimit |
在ellipsize指定marquee的情況下， 設置重復滾動的次數， 當設置為marquee_forever時表示無限次。 |
| 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 |
提供額外的輸入法選項(字符串格式)。依據輸入法而決定是否提供，如這里 所見。自定義輸入法繼承 InputMethodService。這篇 文章也許有幫助。 |
| 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 |
設置文字外觀。如“?android:attr/textAppearanceLargeInverse ”這里引用的是系統自帶的一個外觀，？表示系統是否有這種外觀，否則使用默認的外觀。可設置的值如 下： 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 |
|
| android:height |
設置文本區域的高度，支持度量單位：px(像素)/dp/sp/in/mm(毫米) |
| android:maxHeight |
設置文本區域的最大高度 |
| android:minHeight |
設置文本區域的最小高度 |
| android:width |
設置文本區域的寬度，支持度量單位：px(像素)/dp/sp/in/mm(毫米)，與layout_width的區別看這里 。 |
| android:maxWidth |
設置文本區域的最大寬度 |
| android:minWidth |
設置文本區域的最小寬度 |
補充說明：
a). 由於是繼承自TextView，所以屬性是一樣的，但是這里重點補充了輸入法相關的屬性說明和研究，部分注釋也做了相應的調整。
三、例子
3.1 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, "你點了Go!", Toast.LENGTH_SHORT).show();
- }
- return false;
- }
- });
android:layout_gravity="center_vertical"//設置控件顯示的位置：默認top ，這里居中顯示，還有bottom
android:hint="請輸入數字！"//設置顯示在空間上的提示信息
android:numeric="integer"//設置只能輸入整數，如果是小數則是：decimal
android:singleLine="true"//設置單行輸入，一旦設置為true，則文字不會自動換行。
<!--
android:gray="top" //多行中指針在第一行第一位置
et.setSelection(et.length());//調整光標到最后一行Android:autoText // 自動拼寫幫助
Android:capitalize // 首字母大寫
Android:digits // 設置只接受某些數字
Android ： singleLine // 是否單行或者多行，回車是離開文本框還是文本框增加新行
Android ： numeric // 只接受數字
Android ： password // 密碼
Android ： phoneNumber // 輸入電話號碼
Android ： editable // 是否可編輯
Android:autoLink=”all” // 設置文本超鏈接樣式 當點擊網址時，跳向該網址
android:password="true" //設置只能輸入密碼
android:textColor = "#ff8c00"//字體顏色
android:textStyle="bold"//字體，bold, italic, bolditalic
android:textSize="20dip"//大小
android:capitalize = "characters"//以大寫字母寫
android:textAlign="center"//EditText沒有這個屬性，但TextView有
android:textColorHighlight="#cccccc"//被選中文字的底色，默認為藍色
android:textColorHint="#ffff00"//設置提示信息文字的顏色，默認為灰色
android:textScaleX="1.5"//控制字與字之間的間距
android:typeface="monospace"//字型，normal, sans, serif, monospace
android:background="@null"//空間背景，這里沒有，指透明
android:layout_weight="1"//權重 在控制控 件顯示的大小時蠻有用的。
android:textAppearance="?android:attr/textAppearanceLargeInverse"//文字外 觀，這里引用的是系統自帶的一個外觀，？表示系統是否有這種外觀，否則使用默認的外觀。不知道這樣理解對不對？
屬性名稱描述 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設置英文字母大寫類型。此處無效果，需要彈出輸入法才能看得到，參見EditView此屬性說明。
android:cursorVisible設定光標為顯示/隱藏，默認顯示。
android:digits設置允許輸入哪些字符。如“1234567890.+-*/% ()”
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:hintText為空時顯示的文字提示信息，可通過textColorHint設置提示信息的顏色。此屬性在EditView中使用，但是這里也可以用。
android:imeOptions附加功能，設置右下角IME動作與編輯框相關的動作，如actionDone右下角將顯示一個“完成”，而不設置默認是一個回車符號。這個在EditView中再詳細說明，此處無用。
android:imeActionId設置IME動作ID。在EditView再做說明，可以先看這篇帖子：這里。
android:imeActionLabel設置IME動作標簽。在EditView再做說明。
android:includeFontPadding設置文本是否包含頂部和底部額外空白，默認為true。
android:inputMethod為文本指定輸入法，需要完全限定名(完整的包名)。例如：com.google.android.inputmethod.pinyin，但是這里報錯找不到。
android:inputType設置文本的類型，用於幫助輸入法顯示合適的鍵盤類型。在EditView中再詳細說明，這里無效果。
android:linksClickable設置鏈接是否點擊連接，即使設置了autoLink。
android:marqueeRepeatLimit在ellipsize指定marquee的情況下，設置重復滾動的次數，當設置為marquee_forever時表示無限次。
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有點擊效果，此屬性在EdtiView將詳細說明。
android:password以小點”.”顯示文本
android:phoneNumber設置為電話號碼的輸入方式。
android:privateImeOptions設置輸入法選項，此處無用，在EditText將進一步討論。
android:scrollHorizontally設置文本超出TextView的寬度的情況下，是否出現橫拉條。
android:selectAllOnFocus如果文本是可選擇的，讓他獲取焦點而不是將光標移動為文本的開始位置或者末尾位置。TextView中設置后無效果。
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: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: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設置文本區域的最小寬度
android:textAppearance設置文字外觀。如“?android:attr/textAppearanceLargeInverse
”這里引用的是系統自帶的一個外觀，?表示系統是否有這種外觀，否則使用默認的外觀。可設置的值如 下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge /textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAppearanceSmallInverse
android:textAppearance設置文字外觀。如“?android:attr/textAppearanceLargeInverse
”這里引用的是系統自帶的一個外觀，?表示系統是否有這種外觀，否則使用默認的外觀。可設置的值如 下：textAppearanceButton/textAppearanceInverse/textAppearanceLarge /textAppearanceLargeInverse/textAppearanceMedium/textAppearanceMediumInverse/textAppearanceSmall/textAp