Android API中文文檔EditText

Android API中文文檔EditText是本文要介紹的內容，主要是來瞭解並學習Android API文檔的協助，具體關於Android API的內容的詳解來看本文。

一、Android API中結構

 

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

已知直接子類：

 

  
AutoCompleteTextView,ExtractEditText 
 

已知間接子類：

 

  
MultiAutoCompleteTextView 
 

二、Android API中xml屬性

屬性名稱描述

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

android:autoText自動拼字協助。這裡單獨設定是沒有效果的，可能需要其他IME輔助才行，效果參見視頻。

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指定特定IME的擴充，如“com.mydomain.im.SOME_FIELD”。源碼跟蹤至EditorInfo.extras，暫無相關實現代碼。

android:ellipsize設定當文字過長時,該控制項該如何顯示。有如下值設定：”start”—–省略符號顯示在開頭；”end”——省略符號顯示在結尾；”middle”—-省略符號顯示在中間；”marquee”——以跑馬燈的方式顯示(動畫橫向移動)

android:freezesText設定儲存文本的內容以及游標的位置。參見：這裡。

android:gravity設定文本位置，如設定成“center”，文本將置中顯示。

android:hintText為空白時顯示的文字提示資訊，可通過textColorHint設定提示資訊的顏色。

android:imeOptions設定軟鍵盤的Enter鍵。有如下值可設定：normal，actionUnspecified，actionNone，actionGo，actionSearch，actionSend，actionNext，actionDone，flagNoExtractUi，flagNoAccessoryAction，flagNoEnterAction。可用’|’設定多個。這裡僅設定顯示表徵圖之用，參見文章末尾例子。

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

android:imeActionLabel設定IME動作標籤。但是不能保證一定會使用，猜想在IME擴充的時候應該有用。

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

android:inputMethod為文本指定IME，需要完全限定名完整的包名）。例如：com.google.android.inputmethod.pinyin，但是這裡報錯找不到。關於自訂IME參見這裡。

android:inputType設定文本的類型，用於協助IME顯示合適的鍵盤類型。有如下值設定：none、text、textCapCharacters字母大小、textCapWords單詞首字母大小、textCapSentences僅第一個字母大小、textAutoCorrect、textAutoComplete自動完成、textMultiLine多行輸入、textImeMultiLineIME多行如果支援）、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有一個數字IME。有如下值設定：integer正整數、signed帶正負號的整數、decimal帶小數點浮點數。

android:password以小點”.”顯示文本

android:phoneNumber設定為電話號碼的輸入方式。

android:privateImeOptions提供額外的IME選項(字串格式)。依據IME而決定是否提供，如這裡所見。自訂IME繼承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設定文本字型，必須是以下常量值之一：normal0,sans1,serif2,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 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, "你點了Go!", Toast.LENGTH_SHORT).show();  
  
                }  
  
                return false;  
  
            }  
  
        }); 
 

小結：Android API中文文檔EditText的內容介紹完了，希望通過Android API內容的學習能對你有所協助~