TextViewXML属性和相关方法说明。
android:allowUndo
是否应允许对可编辑文本进行撤消。默认为真。
可以是布尔值,例如 "true"或"false"。
android:autoLink
控制是否自动找到 url 和电子邮件地址等链接并将其转换为可点击的链接。默认值为"none",禁用此功能。
必须是以下常量值中的一个或多个(以"|"分隔)。
Constant |
Value |
Description |
all |
f |
匹配所有模式(相当于 web|email|phone|map)。 |
2 |
匹配电子邮件地址。 |
|
map |
8 |
匹配地图地址。弃用:见。Linkify.MAP_ADDRESSES |
none |
0 |
不匹配任何模式(默认)。 |
phone |
4 |
匹配电话号码。 |
web |
1 |
匹配 Web URL。 |
相关方法:setAutoLinkMask(int)
android:autoSizeMaxTextSize
自动调整文本大小时要使用的最大文本大小约束。
可以是一个维度值,它是一个浮点数,附加一个单位,例如" 14.5sp"。可用单位有:px(像素)、dp(与密度无关的像素)、sp(基于首选字体大小的缩放像素)、in(英寸)和 mm(毫米)。
相关方法:setAutoSizeTextTypeUniformWithConfiguration(int,int,int,int)
android:autoSizeMinTextSize
自动调整文本大小时要使用的最小文本大小约束。
相关方法:setAutoSizeTextTypeUniformWithConfiguration(int,int,int,int)
android:autoSizePresetSizes
要与autoSizeTextTypeset to结合使用的维度的资源数组 uniform。autoSizeStepGranularity如果设置则覆盖 。
相关方法:setAutoSizeTextTypeUniformWithPresetSizes(int,int)
android:autoSizeStepGranularity
如果autoSizeTextType设置为"uniform",请指定自动调整步长。默认值为1px。覆盖autoSizePresetSizes(如果设置)。
相关方法:setAutoSizeTextTypeUniformWithConfiguration(int,int,int,int)
android:autoSizeTextType
指定自动调整大小的类型。请注意,此功能不受EditText支持,仅适用于 TextView。
必须是以下常量值之一。
Constant |
Value |
Description |
none |
0 |
没有自动调整大小(默认)。 |
uniform |
1 |
统一的水平和垂直文本大小缩放以适应容器。 |
相关方法:setAutoSizeTextTypeWithDefaults(int)
android:autoText
如果设置,则指定此 TextView 具有文本输入法并自动更正一些常见的拼写错误。默认值为"假"。
相关方法:setKeyListener(KeyListener)
android:breakStrategy
中断策略(控制段落布局)。
必须是以下常量值之一。
、
Constant |
Value |
Description |
balanced |
2 |
断线策略平衡线长度。 |
high_quality |
1 |
换行使用高质量的策略,包括连字符。 |
simple |
0 |
换行使用简单的策略。 |
相关方法:setBreakStrategy(int)
android:bufferType
确定 getText() 将返回的最小类型。默认值为"正常"。请注意,EditText 和 LogTextBox 始终返回 Editable,即使您在此处指定的功能不那么强大。
必须是以下常量值之一。
Constant |
Value |
Description |
editable |
2 |
只能返回 Spannable 和 Editable。 |
normal |
0 |
可以返回任何 CharSequence,如果源文本是 Spanned,则可以是 Spanned 。 |
spannable |
1 |
只能返回 Spannable。 |
相关方法:setText(int,TextView.BufferType)
android:capitalize
如果设置,则指定此 TextView 具有文本输入法并应自动将用户键入的内容大写。默认值为"无"。
必须是以下常量值之一。
Constant |
Value |
Description |
characters |
3 |
大写每个字符。 |
none |
0 |
不要自动大写任何东西。 |
sentences |
1 |
将每个句子的第一个单词大写。 |
words |
2 |
将每个单词的第一个字母大写。 |
相关方法:setKeyListener(KeyListener)
android:cursorVisible
使光标可见(默认)或不可见。
相关方法:setCursorVisible(boolean)
android:digits
如果设置,则指定此 TextView 具有数字输入法,并且这些特定字符是它将接受的字符。如果设置了此项,则暗示数字为真。默认值为假。
相关方法:setKeyListener(KeyListener)
android:drawableBottom
要在文本下方绘制的可绘制对象。
相关方法:setCompoundDrawablesWithIntrinsicBounds(int,int,int,int)
android:drawableEnd
要绘制到文本末尾的可绘制对象。
相关方法:setCompoundDrawablesRelativeWithIntrinsicBounds(int,int,int,int)
android:drawableLeft
要绘制到文本左侧的可绘制对象。
相关方法:setCompoundDrawablesWithIntrinsicBounds(int,int,int,int)
android:drawablePadding
可绘制对象和文本之间的填充。
相关方法:setCompoundDrawablePadding(int)
android:drawableRight
相关方法:setCompoundDrawablesWithIntrinsicBounds(int,int,int,int)
android:drawableStart
要绘制到文本开头的可绘制对象。
相关方法:setCompoundDrawablesRelativeWithIntrinsicBounds(int,int,int,int)
android:drawableTint
应用于复合(左侧、顶部等)可绘制对象的色调。
相关方法:setCompoundDrawableTintList(ColorStateList)
android:drawableTintMode
用于应用复合(左侧、顶部等)可绘制色调的混合模式。
相关方法:setCompoundDrawableTintMode(PorterDuff.Mode)
android:drawableTop
要在文本上方绘制的可绘制对象。
相关方法:setCompoundDrawablesWithIntrinsicBounds(int,int,int,int)
android:editable
如果设置,则指定此 TextView 具有输入法。除非另有说明,否则它将是文本文件。对于 TextView,默认为 false。对于 EditText,默认为 true。
android:editorExtras
对<input-extras> 包含要提供给输入法的附加数据的XML 资源的引用,该 资源对输入法的实现是私有的。这只是在EditorInfo.extras输入法连接时填写该字段。
相关方法:setInputExtras(int)
android:elegantTextHeight
优雅的文本高度,特别是对于不太紧凑的复杂脚本文本。可以是一个布尔值,例如 "true"或"false"。
相关方法:setElegantTextHeight(boolean)
android:ellipsize
如果设置,会导致长于视图宽度的单词被椭圆化而不是在中间断开。您通常还希望设置 scrollHorizontally 或 singleLine,以便将整个文本也限制在一行中,而不是仍然允许分成多行。
相关方法:setEllipsize(TextUtils.TruncateAt)
android:ems
使TextView正好有这么多em宽。可以是一个整数值,例如" 100"。
相关方法:setEms(int)
android:enabled
指定是否启用小部件。启用状态的解释因子类而异。例如,未启用的 EditText 会阻止用户编辑包含的文本,而未启用的 Button 会阻止用户点击按钮。如果评估 state_enabled 时引用的可绘制对象不同,则启用和非启用小部件的外观可以不同。
android:fallbackLineSpacing
是否尊重用于显示文本的回退字体的上升和下降。如果为真,最终被使用的后备字体可以增加使用它们的行的上升和下降。
相关方法:setFallbackLineSpacing(boolean)
android:firstBaselineToTopHeight
从 TextView 顶部到第一个文本基线的距离。如果设置,这将覆盖为 paddingTop 设置的值。
相关方法:setFirstBaselineToTopHeight(int)
android:fontFamily
文本的字体系列(由字符串命名或作为字体资源参考)。可以是字符串值,使用 '\\;' 转义 Unicode 字符的字符,例如 '\\n' 或 '\\uxxxx';
相关方法:setTypeface(Typeface)
android:fontFeatureSettings
字体功能设置。可以是字符串值,使用 '\\;' 转义 Unicode 字符的字符,例如 '\\n' 或 '\\uxxxx';
相关方法:setFontFeatureSettings(String)
android:fontVariationSettings
字体变化设置。可以是字符串值,使用 '\\;' 转义 Unicode 字符的字符,例如 '\\n' 或 '\\uxxxx';
相关方法:setFontVariationSettings(String)
android:freezesText
如果设置,除了元数据(例如当前光标位置)之外,文本视图将在其冻结的冰柱内包含其当前完整文本。默认情况下这是禁用的;当文本视图的内容未存储在持久性位置(例如内容提供程序)中时,它会很有用。因为 EditText无论属性值如何,它始终处于启用状态。
相关方法:setFreezesText(boolean)
android:gravity
指定当文本小于视图时如何通过视图的 x 和/或 y 轴对齐文本。
必须是以下常量值中的一个或多个(以"|"分隔)。
Constant |
Value |
Description |
bottom |
50 |
将对象推到其容器的底部,而不改变其大小。 |
center |
11 |
将对象放置在其容器的垂直和水平轴的中心,不改变其大小。 |
center_horizontal |
1 |
将对象放置在其容器的水平中心,不改变其大小。 |
center_vertical |
10 |
将对象放在其容器的垂直中心,不改变其大小。 |
clip_horizontal |
8 |
可以设置为将子项的左边缘和/或右边缘剪裁到其容器边界的附加选项。剪辑将基于水平重力:左重力将剪辑右边缘,右重力将剪辑左边缘,两者都不会剪辑两个边缘。 |
clip_vertical |
80 |
可以设置为将子项的顶部和/或底部边缘剪裁到其容器边界的附加选项。剪辑将基于垂直重力:顶部重力将剪辑底部边缘,底部重力将剪辑顶部边缘,两者都不会剪辑两个边缘。 |
end |
800005 |
将对象推到其容器的末端,不改变其大小。 |
fill |
77 |
如果需要,增加对象的水平和垂直大小,使其完全填满其容器。 |
fill_horizontal |
7 |
如果需要,增加对象的水平尺寸,使其完全填满其容器。 |
fill_vertical |
70 |
如果需要,增大对象的垂直尺寸,使其完全填满其容器。 |
left |
3 |
将对象推到其容器的左侧,不改变其大小。 |
right |
5 |
将对象推到其容器的右侧,不改变其大小。 |
start |
800003 |
将对象推到其容器的开头,不改变其大小。 |
top |
30 |
将对象推到其容器的顶部,而不改变其大小。 |
相关方法:setGravity(int)
android:height
使 TextView 正好是这个高度。您可以通过在布局参数中指定此数字来获得相同的效果。
相关方法:setHeight(int)
android:hint
当文本为空时显示的提示文本。可以是字符串值,使用 '\\;' 转义 Unicode 字符的字符,例如 '\\n' 或 '\\uxxxx';
相关方法:setHint(int)
android:hyphenationFrequency
自动断字的频率。
必须是以下常量值之一。
Constant |
Value |
Description |
full |
2 |
标准数量的连字符,对于运行文本和文本空间有限的屏幕很有用。 |
none |
0 |
没有连字符。 |
normal |
1 |
不太频繁的连字符,对于非正式用例很有用,例如聊天消息。 |
相关方法:setHyphenationFrequency(int)
android:imeActionId
提供EditorInfo.actionId 当输入法连接到文本视图时使用的值 。
相关方法:setImeActionLabel(CharSequence,int)
android:imeActionLabel
提供EditorInfo.actionLabel 当输入法连接到文本视图时使用的值 。
相关方法:setImeActionLabel(CharSequence,int)
android:imeOptions
您可以在与编辑器关联的 IME 中启用的其他功能,以改进与您的应用程序的集成。此处的常量对应于由 定义的常量 EditorInfo.imeOptions。
必须是以下常量值中的一个或多个(以"|"分隔)。
Constant |
Value |
Description |
actionDone |
6 |
操作键执行"完成"操作,关闭软输入法。对应于 。EditorInfo.IME_ACTION_DONE |
actionGo |
2 |
操作键执行"go"操作,将用户带到他们键入的文本的目标。例如,通常在输入 URL 时使用。对应于 。EditorInfo.IME_ACTION_GO |
actionNext |
5 |
操作键执行"下一个"操作,将用户带到将接受文本的下一个字段。对应于 。EditorInfo.IME_ACTION_NEXT |
actionNone |
1 |
此编辑器没有与之关联的操作。对应于 。EditorInfo.IME_ACTION_NONE |
actionPrevious |
7 |
操作键执行"上一个"操作,将用户带到将接受文本的上一个字段。对应于 。EditorInfo.IME_ACTION_PREVIOUS |
actionSearch |
3 |
操作键执行"搜索"操作,将用户带到搜索已键入文本的结果(在任何合适的上下文中)。对应于 。EditorInfo.IME_ACTION_SEARCH |
actionSend |
4 |
操作键执行"发送"操作,将文本传送到其目标。这通常在撰写消息时使用。对应于 。EditorInfo.IME_ACTION_SEND |
actionUnspecified |
0 |
没有与此编辑器相关联的特定操作,如果可以,让编辑器提出自己的操作。对应于 。EditorInfo.IME_NULL |
flagForceAscii |
80000000 |
用于请求输入法能够输入ASCII字符。此标志的目的是确保用户可以在文本视图中键入罗马字母字符,通常用于帐户ID或密码输入。通常情况下,IME可以输入ASCII,即使没有被告知(这样的IME已经在某种意义上尊重了这个标志),但也有可能在某些情况下无法输入ASCII,例如,IME中只启用了阿拉伯语、希腊语、希伯来语、俄语等非ASCII输入语言。应用程序需要意识到这个标志并不是一个保证,并且不是所有的ime都会尊重它。但是,强烈建议IME作者遵守此标志,特别是当他们的IME最终可能处于只启用了非ASCII输入语言的状态时。 对应于EditorInfo.IME_FLAG_FORCE_ASCII。 |
flagNavigateNext |
8000000 |
用于请求输入法能够输入ASCII字符。此标志的目的是确保用户可以在文本视图中键入罗马字母字符,通常用于帐户ID或密码输入。通常情况下,IME可以输入ASCII,即使没有被告知(这样的IME已经在某种意义上尊重了这个标志),但也有可能在某些情况下无法输入ASCII,例如,IME中只启用了阿拉伯语、希腊语、希伯来语、俄语等非ASCII输入语言。应用程序需要意识到这个标志并不是一个保证,并且不是所有的ime都会尊重它。但是,强烈建议IME作者遵守此标志,特别是当他们的IME最终可能处于只启用了非ASCII输入语言的状态时。对应于 EditorInfo.IME_FLAG_NAVIGATE_NEXT。 |
flagNavigatePrevious |
4000000 |
类似于flagNavigateNext,但指定了向后导航可以关注的一些有趣的内容。如果用户选择IME的工具进行向后导航,这将在应用程序中显示为InputConnection.performEditorAction(int)处的actionPrevious。对应于 EditorInfo.IME_FLAG_NAVIGATE_PREVIOUS。 |
flagNoAccessoryAction |
20000000 |
与自定义操作结合使用,这表示当输入法为全屏时,该操作不应作为辅助按钮使用。请注意,通过设置此标志,可以会出现用户根本无法使用该操作的情况。设置此项通常意味着您认为显示正在编辑的文本比您提供的操作更重要。对应于 EditorInfo.IME_FLAG_NO_ACCESSORY_ACTION。 |
flagNoEnterAction |
40000000 |
与自定义操作结合使用,这表示该操作不应作为"回车"键的替代品内联可用。通常这是因为该操作具有如此显着的影响或不可恢复性,因此应避免意外击中它,例如发送消息。请注意,TextView它将在多行文本视图上自动为您设置此标志。对应于 EditorInfo.IME_FLAG_NO_ENTER_ACTION。 |
flagNoExtractUi |
10000000 |
用于指定 IME 不需要显示其提取的文本 UI。对于可以是全屏的输入法,通常在横向模式下,这允许它们更小并让部分应用程序显示在后面。尽管用户对可用应用程序的访问可以会受到限制,但它可以使(主要是)全屏 IME 的体验不那么刺耳。请注意,当指定此标志时,可以无法将IME设置为能够显示文本,因此应仅在不需要的情况下使用它。对应于 EditorInfo.IME_FLAG_NO_EXTRACT |
flagNoFullscreen |
2000000 |
用于请求 IME 永远不要进入全屏模式。应用程序需要知道标志不是保证,并不是所有的 IME 都会尊重它。对应于 EditorInfo.IME_FLAG_NO_FULLSCREEN。 |
flagNoPersonalizedLearning |
1000000 |
用于请求IME不应根据用户在此文本编辑对象上键入的内容更新任何个性化数据,例如键入历史记录和个性化语言模型。典型用例包括: 当应用程序处于特殊模式时,用户的活动预计不会记录在应用程序的历史记录中。有些web浏览器和聊天应用程序可能有这种模式。 存储输入历史记录没有什么意义。在键入游戏时指定此标志可能有助于避免输入历史记录中填充用户在日常生活中键入的单词。另一个例子是,当应用程序已经知道预期的输入不是有效的单词(例如,在任何自然语言中都不是有效的单词的促销代码)。 应用程序需要注意,标志不是保证,有些IME可能不尊重它。 |
normal |
0 |
没有与此编辑器相关联的特殊语义。 |
相关方法:setImeOptions(int)