天天看點

Android2.2 API 中文文檔系列(2) —— EditText

前言

   關鍵字: android api 中文,android sdk 中文,android edittext 詳解

聲明

  歡迎轉載,但請保留文章原始出處:) 

    部落格園:http://www.cnblogs.com

正文

  一、結構

    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中的效果比較搞笑:

Android2.2 API 中文文檔系列(2) —— EditText

 ,居然在文本框裡,而且删不了。

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短資訊(會多一個表情按鈕出來,點開如下圖:

Android2.2 API 中文文檔系列(2) —— EditText

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;

Android2.2 API 中文文檔系列(2) —— 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;

            }

        });

Android2.2 API 中文文檔系列(2) —— EditText

結束

   有朋友提議是否組織一下一起來翻譯,這裡我覺得可以這樣:如果有興趣,可以翻譯好之後給我一個連結或者直接在我部落格裡面整理了釋出出來,在此會補上翻譯人以及原文位址,這樣限制較低但是沒有門檻,希望有志者熱心參與,邊翻譯邊等待完整版的中文api出來 :) 

轉載:http://www.cnblogs.com/over140/archive/2010/09/02/1815439.html

繼續閱讀