android 基础控件 EditText

2022-12-04 13:50:42

EditText 简介：

EditText 控件继承 TextView ，它有TextView的所有属性和方法，并且自身是可编辑的；

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

Known
Direct Subclasses

AutoCompleteTextView,ExtractEditText,SearchEditText,TintEditText

Known
Indirect Subclasses

MultiAutoCompleteTextView,TintAutoCompleteTextView,TintMultiAutoCompleteTextView

EditText 常用属性和方法：

属性名称	描述
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	设置文本字体，必须是以下常量值之一：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	设置文本区域的最小宽度

常用方法：

getText

public Editable getText()

从类 TextView 复制的描述

Return the text the TextView is displaying. If setText() was called with an argument of BufferType.SPANNABLE or BufferType.EDITABLE, you can cast the return value from this method to Spannable or Editable, respectively. Note:
The content of the return value should not be modified. If you want a modifiable one, you should make your own copy first.

覆盖：: 类 TextView 中的 getText

setText

public void setText(CharSequence text,

                    TextView.BufferType type)

从类 TextView 复制的描述

Sets the text that this TextView is to display (see TextView.setText(CharSequence)) and also sets whether it is stored in a styleable/spannable buffer and whether it is editable.

覆盖：: 类 TextView 中的 setText

EditText 使用：

长度和空白提示文字,提示文字颜色,是否可编辑等

EditText有一些属性可以设置EditText的特性，比如最大长度，空白提示文字等。

有时候我们有一些特属的需要，要求只能在EditText中输入特定个数的字符，比如身份证号、手机号吗等。这时候就可以通过android:maxLength属性来设置最大输入字符个数，比如android:maxLength=“4”就表示最多能输入4个字符，再多了就输入不进去了。
空白提示文字。有时候我们需要说明你定义的这个EditText是做什么用的，比如让输入“用户名”，或者输入“电话号码”等，但是你又不想在EditText前面加一个TextView来说明这是输入“用户名”的，因为这会使用一个TextView，那么怎么办呢？EditText为我们提供了android:hint来设置当EditText内容为空时显示的文本，这个文本只在EditText为空时显示，你输入字符的时候就消失了，不影响你的EditText的文本。。修改main.xml如下：

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

    android:orientation="vertical"

    android:layout_width="fill_parent"

    android:layout_height="fill_parent"

    >

<EditText

	android:id="@+id/edit_text"

    android:layout_width="fill_parent"

    android:layout_height="wrap_content"

    android:maxLength="40"

    android:hint="请输入用户名..."/>

</LinearLayout>

方法使用：

 EditText myEdit = (EditText)findViewById(R.id.edit_text);

        // 获取 控件显示文字

        String showText = myEdit.getText().toString();

     // 设置 控件显示文字

        myEdit.setText("显示文字");

EditText Demo： http://download.csdn.net/detail/q610098308/9226359

码农公寓

getText

setText

长度和空白提示文字,提示文字颜色,是否可编辑等

相关文章