Android EditText的属性和方法介绍使用及值得注意的点

转自：http://blog.youkuaiyun.com/u014651216/article/details/53199870

、EditView属性详细介绍：

属性名称	描述
Android:utoLink	设置是否当文本为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。 可用’|’设置多个。 <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: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	设置文本字体，必须是以下常量值之一：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	设置文本区域的最小宽度

二 、主要方法介绍：

1.设置默认输入法 

有时候为了提高用户体验，在弹出输入法时需要设置默认的输入状态，比如单词应用弹出输入法时，输入法最好是在英文输入状态下。如果是字典应用，弹出输入法时最好是在中文输入状态下，Android并没有提供设置默认的输入状态的接口，但我们可以通过如下方法一样能够达到想要的效果：

默认中文：

[java]  view plain  copy

 

1. mEditText.setInputType(EditorInfo.TYPE_CLASS_TEXT);  

默认英文：

[java]  view plain  copy

 

1. mEditText.setInputType(EditorInfo.TYPE_TEXT_VARIATION_URI);  

2.打开和关闭输入法

手动控制输入法的开关状态也能提升用户体验，比如：

• 有的搜索框会有一个清除按钮，点击清除按钮时就应该弹出输入法，因为用户清除搜索内容的目的多数时候是需要输入新的内容；

• 执行搜索时应该隐藏输入法，因为显示输入法时会遮挡搜索结果，用户体验不太好；

• 闹钟来时或者有其它window弹出时应该隐藏输入法，因为输入法也是window，如果不隐藏可能导致输入法遮挡住了其它window等用户体验不太友好的问题。

打开输入法：

[java]  view plain  copy

 

1. private void open(Context context, View editText){  
2.     InputMethodManager inputMethodManager = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE);  
3.     inputMethodManager.showSoftInput(editText, 0);  
4. }  

关闭输入法：

[java]  view plain  copy

 

1. private void close(Context context, View editText){  
2.     InputMethodManager inputMethodManager = (InputMethodManager) context.getSystemService(Context.INPUT_METHOD_SERVICE);  
3.     inputMethodManager.hideSoftInputFromWindow(editText.getWindowToken(), 0);  
4. }  

3.监听EditText的输入状态

• 类似新浪微博，在输入内容时会提示还可以输入多少字；

• 有的搜索引擎，输入内容时实时显示搜索结果；

• 有的输入框有输入长度限制，输入内容超过长度限制时弹出提示信息。

上面这些都可以通过监听EditText的输入状态来实现，具体实现方式如下：

[java]  view plain  copy

 

1. mInputEditTxt.addTextChangedListener(new TextWatcher() {  
2.   
3.         @Override  
4.         public void beforeTextChanged(CharSequence s, int start, int count, int after) {  
5.   
6.         }     
7.   
8.         @Override  
9.         public void onTextChanged(CharSequence s, int start, int before, int count) {  
10.             System.out.println("监听EditText输入内容的变化，在这里可以监听输入内容的长度。");  
11.         }  
12.   
13.         @Override  
14.         public void afterTextChanged(Editable s) {  
15.             System.out.println("这里可以实现所输即所得，用户输入的同时可以立即在这里根据输入内容执行操作，显示搜索结果！");  
16.         }  
17.   
18.     });  

4.监听输入法中的回车按钮

比如搜狗输入法的右下角有一个回车按钮，我们希望用户点击它时也执行确认功能，可以通过监听EditText的按键点击事件来实现：

[java]  view plain  copy

 

1. /** 
2.   * 监听输入法按键 
3.   * 
4.   */  
5.  mInputEditTxt.setOnKeyListener(new OnKeyListener() {  
6.   
7.      @Override  
8.      public boolean onKey(View v, int keyCode, KeyEvent event) {  
9.          if (keyCode == KeyEvent.KEYCODE_ENTER && event.getAction() == KeyEvent.ACTION_UP) {  
10.              System.out.println("手指弹起时执行确认功能");  
11.              return true;  
12.          }  
13.          return false;  
14.      }  
15.  });  

5.改变输入法中回车按钮的显示内容

如果回车按钮是执行搜索功能，则回车按钮上显示”搜索”，如果是执行发送功能，则显示”发送”,如果是下一步，则显示”下一步”。

实现这个功能需要调用EditText的setImeOptions方法：

[java]  view plain  copy

 

1. /** 
2.   * 
3.   * IME_ACTION_SEARCH 搜索 
4.   * IME_ACTION_SEND 发送 
5.   * IME_ACTION_NEXT 下一步 
6.   * IME_ACTION_DONE 完成 
7.   */  
8.   mInputEditTxt.setImeOptions(EditorInfo.IME_ACTION_SEARCH);  

6.限制输入内容

有时候我们根本就不想用户输入一些杂七杂八的内容，因为这需要程序针对输入的内容做各种处理，如果处理不当还会有好多不可预见的问题，索性在输入内容时就禁止用户输入一些非法字符，这可以通过下面的方式实现，新建一个类InputTxtFilter：

[java]  view plain  copy

 

1. public class InputTxtFilter {  
2.         public static final int INPUT_TYPE_EN = 0x01;  
3.         public static final int INPUT_TYPE_CH = 0x02;  
4.         private static final String[] SPELL = new String[]{  
5.                 "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z",  
6.                 "ā", "á", "ǎ", "à", "ō", "ó", "ǒ", "ò", "ē", "é", "ě", "è", "ī", "í", "ǐ", "ì", "ū", "ú", "ǔ", "ù", "ǖ", "ǘ", "ǚ", "ǜ", "ü"  
7.         };  
8.         private static char[] chineseParam = new char[]{'」', '，', '。', '？', '…', '：', '～', '【', '＃', '、', '％', '＊', '＆', '＄', '（', '‘', '’', '“', '”', '『', '〔', '｛', '【'  
9.                 , '￥', '￡', '‖', '〖', '《', '「', '》', '〗', '】', '｝', '〕', '』', '”', '）', '！', '；', '—'};  
10.   
11.         private InputTxtFilter() {  
12.   
13.         }  
14.   
15.         public static void inputFilter(final Context context, final EditText editText, final int type, final int inputLimit) {  
16.             InputFilter[] filters = new InputFilter[1];  
17.             filters[0] = new InputFilter.LengthFilter(inputLimit) {  
18.                 public CharSequence filter(CharSequence source, int start, int end, Spanned dest, int dstart, int dend) {  
19.                     boolean isRightCharater = false;  
20.                     if (type == INPUT_TYPE_EN) {  
21.                         isRightCharater = isLetter(source.toString());  
22.                     } else if (type == INPUT_TYPE_CH) {  
23.                         isRightCharater = isChineseWord(source.toString());  
24.                     }  
25.                     if (!isRightCharater || dest.toString().length() >= inputLimit) {  
26.                         return "";  
27.                     }  
28.                     return source;  
29.                 }  
30.             };  
31.             editText.setFilters(filters);  
32.         }  
33.   
34.   
35.         /** 
36.          * 检测String是否全是中文 
37.          */  
38.         public static boolean isChineseWord(String name) {  
39.             boolean res = true;  
40.             char[] cTemp = name.toCharArray();  
41.             for (int i = 0; i < name.length(); i++) {  
42.                 if (!isChinese(cTemp[i])) {  
43.                     res = false;  
44.                     break;  
45.                 }  
46.             }  
47.             return res;  
48.         }  
49.   
50.   
51.         /** 
52.          * 是否为英文字母 
53.          */  
54.         public static boolean isLetter(String inputStr) {  
55.             char[] inputArray = inputStr.toCharArray();  
56.             List<String> spellList = Arrays.asList(SPELL);  
57.             for (char input : inputArray) {  
58.                 if (!spellList.contains(input + "")) {  
59.                     return false;  
60.                 }  
61.             }  
62.             return true;  
63.         }  
64.   
65.   
66.         /** 
67.          * 判定输入汉字 
68.          */  
69.         public static boolean isChinese(char c) {  
70.             for (char param : chineseParam) {  
71.                 if (param == c) {  
72.                     return false;  
73.                 }  
74.             }  
75.             Character.UnicodeBlock ub = Character.UnicodeBlock.of(c);  
76.             if (ub == Character.UnicodeBlock.CJK_UNIFIED_IDEOGRAPHS  
77.                     || ub == Character.UnicodeBlock.CJK_COMPATIBILITY_IDEOGRAPHS  
78.                     || ub == Character.UnicodeBlock.CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A  
79.                     || ub == Character.UnicodeBlock.GENERAL_PUNCTUATION  
80.                     || ub == Character.UnicodeBlock.CJK_SYMBOLS_AND_PUNCTUATION  
81.                     || ub == Character.UnicodeBlock.HALFWIDTH_AND_FULLWIDTH_FORMS) {  
82.                 return true;  
83.             }  
84.             return false;  
85.         }  
86.     }  

在初始化EditText时，调用InputTxtFilter的inputFilter方法，传入输入长度限制、输入内容的类型限制等即可，eg：

[java]  view plain  copy

 

1. InputTxtFilter.inputFilter(this, mInputEditTxt, InputTxtFilter.INPUT_TYPE_EN, 5);  

7.屏蔽EditText的复制、粘贴功能

在低版本的Android SDK中，如果对EditText的输入长度有限制时，长按EditText并将选中的内容拖动到EditText输入框中，如果这时候的长度超过了EditText的输入长度限制，程序会直接崩溃掉，在高版本的Android SDK中这个问题已经改了，如果出现上面的情况会直接清空输入框中的内容，为了避免这种讨厌的问题，我们可以屏蔽EditText的复制和粘贴功能，只需要屏蔽EditText的长按响应即可：

[java]  view plain  copy

 

1. /** 
2.   * 屏蔽复制、粘贴功能 
3.   * 
4.   */  
5.  mInputEditTxt.setCustomSelectionActionModeCallback(new ActionMode.Callback() {  
6.   
7.      public boolean onCreateActionMode(ActionMode actionMode, Menu menu) {  
8.          return false;  
9.      }  
10.   
11.   
12.      public boolean onPrepareActionMode(ActionMode actionMode, Menu menu) {  
13.          return false;  
14.      }  
15.   
16.      public boolean onActionItemClicked(ActionMode actionMode, MenuItem menuItem) {  
17.          return false;  
18.      }  
19.   
20.      @Override  
21.      public void onDestroyActionMode(ActionMode mode) {  
22.   
23.      }  
24.  });  

1.  mInputEditTxt.setLongClickable(false);