本文主要研究一下EditText的屬性（還沒研究完，邊研究邊寫）

本文主要研究一下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 ，flagNoExtractUi，flagNoAccessoryAction，flagNoEnterAction。可用’|’設定多個。這裡僅設定顯示圖示之用，參見文章末尾例子。
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短資訊（會多一個表情按鈕出來，點開如下圖： ）、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例子

1 <EditText android:id="@+id/txtTest" android:imeOptions="actionGo"

2     android:layout_width="100dp" android:layout_height="wrap_content"></EditText>

3 ((EditText)findViewById(R.id.txtTest)).setOnEditorActionListener(new TextView.OnEditorActionListener() {

4             @Override

5             public boolean onEditorAction(TextView v, int actionId,

6                     KeyEvent event) {

7                 if (actionId == EditorInfo.IME_ACTION_GO) {

8                     Toast.makeText(TestActivity.this, "你點了Go!", Toast.LENGTH_SHORT).show();

9                 }

10                 return false;

11             }

12         });

複制代碼

            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:type//字型，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

更多《移動開發技術文檔》，請登入：千鋒網  http://www.1000phone.net/