组件——TextView(文本框)

Android——文本框（TextView）

一、认识

用来显示文本标签的控件。

可以设置文本的字体大小、字体颜色、文字背景、风格等等。

二、属性使用

android:drawableTop

在text的正上方输出一个drawable。

android:drawableBottom

在text的下方输出一个drawable，如果指定一个颜色的话会把text的背景设为该颜色，并且同时和background使用时覆盖后者。

android:drawableLeft

在text的左边输出一个drawable（如图片）。

android:drawableRight

在text的右边输出一个drawable，如图片。

android:drawableStart

在text的开始位置输出一个drawable，如图片。

android:drawableEnd

在text的结束位置输出一个drawable，如图片。

android:drawablePadding

可绘制和文本text之间的空格，与drawableLeft、drawableRight、drawableTop、drawableBottom一起使用，

可设置为负数，单独使用没有效果。

相关方法： setCompoundDrawablesWithIntrinsicBounds         顶部、底部、左边、右边

                  | setCompoundDrawablesRelativeWithIntrinsicBounds 开始位置、结束位置

                  | setCompoundDrawablePadding                      与文本之间的空

android:editable

设置是否可编辑。仍然可以获取光标，但是无法输入。

指定特定输入法的扩展，如“com.mydomain.im.SOME_FIELD”。源码跟踪至EditorInfo.extras，暂无相关实现代码。

android:editorExtras

指定特定输入法的扩展，如“com.mydomain.im.SOME_FIELD”。源码跟踪至EditorInfo.extras，暂无相关实现代码。

相关方法：setInputExtras（）

android:elegantTextHeight

优雅的文字高度，尤其是对少压实复杂脚本文本。

值：true | false

相关方法：setElegantTextHeight（）

android:ellipsize

当文字过长时如何设置。

值： none（没有 ） |  start （省略号显示在开头） |  middle （省略号显示在中间）| end （省略号显示在结尾）

|  marquee （以跑马灯的形式显示（动画 横向移动））

相关方法：setEllipsize（）

android:ems = "10"

当设置该属性后，控件显示的长度就为10个字符的长度，超出的部分将不显示。

值：int值

相关方法：setEms（）

android:maxEms="40"

设你输入的参数为n， 屏幕显示的数量为m。

值为1-5时，m = n..

6-11时，m = n+1。

12-18时，m = n+2。

值：int值

相关方法：setMaxEms（INT）

android:minEms="40"

设置TextView的宽度为最短为40个字符的宽度。

值：int值

相关方法：setMinEms（INT）

android:fontFamily

字体家庭（由字符串命名）的文本。

相关方法：setTypeface（字体）

android:fontFeatureSettings

字体功能设置

相关方法：setFontFeatureSettings（字符串 fontFeatureSettings）

android:freezesText

设置保存文本的内容以及光标的位置。

值：true | false

相关方法：setFreezesText（布尔值）

android:gravity

设置文本位置，如设置成“center”，文本将居中显示。

值： top  将对象放在其容器的顶部，不改变其大小  |  bottom  将对象放在其容器的底部，不改变其大小.

| left  将对象放在其容器的左侧，不改变其大小.  |   right  将对象放在其容器的右侧，不改变其大小.

| center_vertical将对象纵向居中，不改变其大小. 垂直对齐方式：垂直方向上居中对齐

| center_horizontal将对象横向居中，不改变其大小. 水平对齐方式：水平方向上居中对齐

| fill_vertical 必要的时候增加对象的纵向大小，以完全充满其容器. 垂直方向填充

| fill_horizontal 必要的时候增加对象的横向大小，以完全充满其容器. 水平方向填充

| center 将对象横纵居中，不改变其大小

| fill 必要的时候增加对象的横纵向大小，以完全充满其容器

| clip_vertical  附加选项，用于按照容器的边来剪切对象的顶部和/或底部的内容. 剪切基于其纵向对齐设置：

顶部对齐时，剪切底部；底部对齐时剪切顶部；除此之外剪切顶部和底部.垂直方向裁剪

| clip_horizontal  附加选项，用于按照容器的边来剪切对象的左侧和/或右侧的内容. 剪切基于其横向对齐设置：

左侧对齐时，剪切右侧；右侧对齐时剪切左侧；除此之外剪切左侧和右侧.水平方向裁剪

| start  推对象到其容器的开头，不改变其大小

| end  推对象到其容器的端部，不改变其大小

相关方法：setGravity（）

android:height   

设置文本区域的宽度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)

相关方法：setHeight()

android:width   

设置文本区域的高度，支持度量单位：px(像素)/dp/sp/in/mm(毫米)

相关方法：setWidth（INT）

android:hint    

提示信息

相关方法：setHint()

android:textColorHint    

提示信息颜色

相关方法：setHintTextColor（INT）

android:imeActionId     

设置IME动作ID，在onEditorAction中捕获判断进行逻辑操作。（未写）

值：必须是一个整数值

相关方法：setImeActionLabel(CharSequence,int)

android:imeActionLabel  

设置IME动作标签。但是不能保证一定会使用，      （未写）

相关方法：setImeActionLabel(CharSequence,int)

android:imeOptions        

设置软键盘的Enter键。

值：

相关方法：setImeOptions(int)

android:includeFontPadding  

设置文本是否包含顶部和底部额外空白，默认为true。

值：true | false

相关方法：setIncludeFontPadding(boolean)

android:inputMethod     

为文本指定输入法，需要完全限定名（完整的包名）。

值：必须是一个字符串值

android:inputType   

设置文本的类型，用于帮助输入法显示合适的键盘类型。

android:inputType="none"

none    输入普通字符

text          输入普通字符

textCapCharacters  输入普通字符

值：android:inputType="textCapWords"--单词首字母大小

android:inputType="textCapSentences"--仅第一个字母大小

android:inputType="textAutoCorrect"--前两个自动完成

android:inputType="textAutoComplete"--前两个自动完成

android:inputType="textMultiLine"--多行输入

android:inputType="textImeMultiLine"--输入法多行（不一定支持）

android:inputType="textNoSuggestions"--不提示

android:inputType="textUri"--URI格式

android:inputType="textEmailAddress"--电子邮件地址格式

android:inputType="textEmailSubject"--邮件主题格式

android:inputType="textShortMessage"--短消息格式

android:inputType="textLongMessage"--长消息格式

android:inputType="textPersonName"--人名格式

android:inputType="textPostalAddress"--邮政格式

android:inputType="textPassword"--密码格式

android:inputType="textVisiblePassword"--密码可见格式

android:inputType="textWebEditText"--作为网页表单的文本格式

android:inputType="textFilter"--文本筛选格式

android:inputType="textPhonetic"--拼音输入格式

android:inputType="number"--数字格式

android:inputType="numberSigned"--有符号数字格式

android:inputType="numberDecimal"--可以带小数点的浮点格式

android:inputType="phone"--拨号键盘

android:inputType="datetime"

android:inputType="date"--日期键盘

android:inputType="time"--时间键盘

android:letterSpacing   字母间距

值：必须是一个浮点值

相关方法：setLetterSpacing（浮点）

android:lineSpacingExtra        

行与行之间的间距

值：必须是一个尺寸值

相关方法：setLineSpacing（浮动，浮动）

android:lineSpacingMultiplier="2.0"     

行的间隔，乘数

值：必须是一个浮点值

相关方法：setLineSpacing（浮动，浮动）

android:lines   

设置文本的行数，

相关方法：setLines（INT）

android:linksClickable      

设置链接是否点击连接，即使设置了autoLink

值：true | false

相关方法：setLinksClickable（布尔值）

android:marqueeRepeatLimit      

在ellipsize指定marquee的情况下，设置重复滚动的次数，

值：marquee_forever 表示无限次 | 5   5次

相关方法：setMarqueeRepeatLimit（INT）

android:maxHeight="30dp"       

设置文本区域的最大高度

相关方法：setMaxHeight（INT）

android:maxLength   

最大长度，限制字符的长度

相关方法：setFilters（输入过滤器）

android:maxLines    

设置文本的最大显示行数

值：必须是一个整数值

相关方法：setMaxLines（INT）

android:minLines    

设置文本的最小显示行数

值：必须是一个整数值

相关方法：setMinLines（INT）

android:maxWidth="30dp"     

设置文本区域的最大宽度

相关方法：setMaxWidth（INT）

android:numeric     

若被设置，该TextView有一个数字输入法。

值：integer正整数  |  signed带符号整数  |  decimal带小数点浮点数

相关方法：setKeyListener（的KeyListener）

android:password        

以小点”.”显示文本

值：true | false

相关方法：setTransformationMethod（TransformationMethod）

android:phoneNumber     

设置为电话号码的输入方式。

值：true | false

相关方法：setKeyListener（的KeyListener）

android:privateImeOptions   

提供额外的输入法选项(字符串格式)。依据输入法而决定是否提供，如这里 所见。自定义输入法继承    InputMethodService。

android:scrollHorizontally   

设置文本超出TextView的宽度的情况下，是否出现横拉条。

值：true | false

相关方法：setHorizo??ntallyScrolling（布尔值）

android:selectAllOnFocus   

如果文本是可选择的，让他获取焦点而不是将光标移动为文本的开始位置或者末尾位置。TextView中设置后无效果。

值：true | false

相关方法：setSelectAllOnFocus（布尔值）

android:shadowColor     

指定文本阴影的颜色，需要与shadowRadius一起使用。

值：必须是颜色值

相关方法：setShadowLayer（浮球，浮球，浮球，INT）

android:shadowDx        

设置阴影横向坐标开始位置。

值：必须是一个浮点值

相关方法：setShadowLayer（浮球，浮球，浮球，INT）

android:shadowDy        

设置阴影纵向坐标开始位置。

值：必须是一个浮点值

相关方法：setShadowLayer（浮球，浮球，浮球，INT）

android:shadowRadius    

设置阴影的半径。设置为0.1就变成字体的颜色了，一般设置为3.0的效果比较好。

值：必须是一个浮点值

相关方法：setShadowLayer（浮球，浮球，浮球，INT）

android:singleLine  

单行显示设置

值：true | false

相关方法：setTransformationMethod（TransformationMethod）

android:text        

要显示的文本

值：字符串

相关方法：setText（CharSequence的，TextView.BufferType）

android:textAllCaps     

目前在所有大写的文本。这可以使用小型大写格式时可用。

值：true | false

相关方法：setAllCaps（布尔值）

android:textAppearance      

设置文字外观，基本文本颜色，字体，大小和样式。

android:textColor   

文字颜色

值：颜色值

相关方法：setTextColor（INT）

android:textColorHighlight  

被选中文字的底色，默认为蓝色

值：颜色值

相关方法：setHighlightColor（INT）

android:textColorLink   

文字链接的颜色.

值：颜色值

相关方法：setLinkTextColor（INT）

android:textIsSelectable    

可被选择的不可编辑的文本的内容

值：true | false

相关方法：isTextSelectable（）

android:textScaleX  

设置文字之间间隔，默认为1.0f

值：浮点数

相关方法：setTextScaleX（浮点）

android:textSize    

文字的大小

相关方法：setTextSize（整型，浮点）

android:textStyle   设置字形

值:normal |  bold    粗体  |  italic  斜体

相关方法：setTypeface(Typeface)

android:typeface    设置文本字体

相关方法：setTypeface(Typeface)

android:autolink 

自动识别链接

值：none（没有）  |  web（url自动链接）| email（邮箱自动链接）| phone（电话自动链接）| 

| all（包括之前的全部自动链接）

TextView识别链接的方式有两种，一种是自动识别链接和HTML解析链接。

相关方法：setAutoLinkMask（）   动态设置自动链接

android:autoText    

自动图文集

值：默认值是“假的”。

true：为true，指定该TextView有一个文本输入法，并自动纠正一些常规的拼写错误   |  false：

此方法具有软键盘等多种输入法显著和微妙的相互作用

相关方法：setKeyListener()  限制输入字符

android:bufferType    

指定getText()方式取得的文本类别。

值：normal 正常 | spannable | editable

相关方法：setText()

android:capitalize  

设置英文字母大写类型。

值：none  没有

| sentences  进第一个字母大写

| words       每一个单词首字母大写

| characters  每一个英文字母都大写

相关方法：setKeyListener()  限制输入字符

android:cursorVisible   

使光标可见（默认）或不可见

值: true： 光标可见 |  false： 光标不可见

相关方法：setCursorVisible

android:digits      

设置允许输入哪些字符

值：任意字符

相关方法：setKeyListener（）