Most visited

Recently visited

Added in API level 1

TextView

public class TextView
extends View implements ViewTreeObserver.OnPreDrawListener

java.lang.Object
   ↳ android.view.View
     ↳ android.widget.TextView
Known Direct Subclasses
Known Indirect Subclasses


向用户显示文本,并可以选择允许他们编辑它。 TextView是一个完整的文本编辑器,但基本类被配置为不允许编辑; 请参阅EditText了解配置文本视图以进行编辑的子类。

要允许用户复制部分或全部TextView的值并将其粘贴到其他位置,请将XML属性android:textIsSelectable设置为“true”或调用setTextIsSelectable(true) textIsSelectable标志允许用户在TextView中做出选择手势,从而触发系统内置的复制/粘贴控件。

XML属性

TextView AttributesView Attributes

Summary

Nested classes

枚举 TextView.BufferType

 

interface TextView.OnEditorActionListener

在编辑器上执行操作时调用回调的接口定义。

class TextView.SavedState

由TextView存储的用于实现onSaveInstanceState()用户界面状态。

XML attributes

android:autoLink Controls whether links such as urls and email addresses are automatically found and converted to clickable links. 
android:autoText If set, specifies that this TextView has a textual input method and automatically corrects some common spelling errors. 
android:breakStrategy Break strategy (control over paragraph layout). 
android:bufferType Determines the minimum type that getText() will return. 
android:capitalize If set, specifies that this TextView has a textual input method and should automatically capitalize what the user types. 
android:cursorVisible Makes the cursor visible (the default) or invisible. 
android:digits If set, specifies that this TextView has a numeric input method and that these specific characters are the ones that it will accept. 
android:drawableBottom The drawable to be drawn below the text. 
android:drawableEnd The drawable to be drawn to the end of the text. 
android:drawableLeft The drawable to be drawn to the left of the text. 
android:drawablePadding The padding between the drawables and the text. 
android:drawableRight The drawable to be drawn to the right of the text. 
android:drawableStart The drawable to be drawn to the start of the text. 
android:drawableTint Tint to apply to the compound (left, top, etc.) drawables. 
android:drawableTintMode Blending mode used to apply the compound (left, top, etc.) drawables tint. 
android:drawableTop The drawable to be drawn above the text. 
android:editable If set, specifies that this TextView has an input method. 
android:editorExtras Reference to an <input-extras> XML resource containing additional data to supply to an input method, which is private to the implementation of the input method. 
android:elegantTextHeight Elegant text height, especially for less compacted complex script text. 
android:ellipsize If set, causes words that are longer than the view is wide to be ellipsized instead of broken in the middle. 
android:ems Makes the TextView be exactly this many ems wide. 
android:fontFamily Font family (named by string) for the text. 
android:fontFeatureSettings Font feature settings. 
android:freezesText If set, the text view will include its current complete text inside of its frozen icicle in addition to meta-data such as the current cursor position. 
android:gravity Specifies how to align the text by the view's x- and/or y-axis when the text is smaller than the view. 
android:height Makes the TextView be exactly this many pixels tall. 
android:hint Hint text to display when the text is empty. 
android:hyphenationFrequency Frequency of automatic hyphenation. 
android:imeActionId Supply a value for EditorInfo.actionId used when an input method is connected to the text view. 
android:imeActionLabel Supply a value for EditorInfo.actionLabel used when an input method is connected to the text view. 
android:imeOptions Additional features you can enable in an IME associated with an editor to improve the integration with your application. 
android:includeFontPadding Leave enough room for ascenders and descenders instead of using the font ascent and descent strictly. 
android:inputMethod If set, specifies that this TextView should use the specified input method (specified by fully-qualified class name). 
android:inputType The type of data being placed in a text field, used to help an input method decide how to let the user enter text. 
android:letterSpacing Text letter-spacing. 
android:lineSpacingExtra Extra spacing between lines of text. 
android:lineSpacingMultiplier Extra spacing between lines of text, as a multiplier. 
android:lines Makes the TextView be exactly this many lines tall. 
android:linksClickable If set to false, keeps the movement method from being set to the link movement method even if autoLink causes links to be found. 
android:marqueeRepeatLimit The number of times to repeat the marquee animation. 
android:maxEms Makes the TextView be at most this many ems wide. 
android:maxHeight Makes the TextView be at most this many pixels tall. 
android:maxLength Set an input filter to constrain the text length to the specified number. 
android:maxLines Makes the TextView be at most this many lines tall. 
android:maxWidth Makes the TextView be at most this many pixels wide. 
android:minEms Makes the TextView be at least this many ems wide. 
android:minHeight Makes the TextView be at least this many pixels tall. 
android:minLines Makes the TextView be at least this many lines tall. 
android:minWidth Makes the TextView be at least this many pixels wide. 
android:numeric If set, specifies that this TextView has a numeric input method. 
android:password Whether the characters of the field are displayed as password dots instead of themselves. 
android:phoneNumber If set, specifies that this TextView has a phone number input method. 
android:privateImeOptions An addition content type description to supply to the input method attached to the text view, which is private to the implementation of the input method. 
android:scrollHorizontally Whether the text is allowed to be wider than the view (and therefore can be scrolled horizontally). 
android:selectAllOnFocus If the text is selectable, select it all when the view takes focus. 
android:shadowColor Place a blurred shadow of text underneath the text, drawn with the specified color. 
android:shadowDx Horizontal offset of the text shadow. 
android:shadowDy Vertical offset of the text shadow. 
android:shadowRadius Blur radius of the text shadow. 
android:singleLine Constrains the text to a single horizontally scrolling line instead of letting it wrap onto multiple lines, and advances focus instead of inserting a newline when you press the enter key. 
android:text Text to display. 
android:textAllCaps Present the text in ALL CAPS. 
android:textAppearance Base text color, typeface, size, and style. 
android:textColor Text color. 
android:textColorHighlight Color of the text selection highlight. 
android:textColorHint Color of the hint text. 
android:textColorLink Text color for links. 
android:textIsSelectable Indicates that the content of a non-editable text can be selected. 
android:textScaleX Sets the horizontal scaling factor for the text. 
android:textSize Size of the text. 
android:textStyle Style (bold, italic, bolditalic) for the text. 
android:typeface Typeface (normal, sans, serif, monospace) for the text. 
android:width Makes the TextView be exactly this many pixels wide. 

Inherited XML attributes

From class android.view.View

Inherited constants

From class android.view.View

Inherited fields

From class android.view.View

Public constructors

TextView(Context context)
TextView(Context context, AttributeSet attrs)
TextView(Context context, AttributeSet attrs, int defStyleAttr)
TextView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

Public methods

void addTextChangedListener(TextWatcher watcher)

将TextWatcher添加到无论TextView的文本更改时调用方法的列表中。

final void append(CharSequence text)

便捷方法:将指定的文本附加到TextView的显示缓冲区,如果它尚不可编辑,则将其升级到BufferType.EDITABLE。

void append(CharSequence text, int start, int end)

便捷方法:将指定的文本切片附加到TextView的显示缓冲区,如果它尚不可编辑,则将其升级到BufferType.EDITABLE。

void beginBatchEdit()
boolean bringPointIntoView(int offset)

如果需要,将偏移量指定的点移动到视图中。

void cancelLongPress()

取消待处理的长按。

void clearComposingText()

使用 BaseInputConnection.removeComposingSpans()从该文本视图中删除任何IME撰写状态。

void computeScroll()

由父级调用,以请求孩子在必要时更新mScrollX和mScrollY的值。

void debug(int depth)

在日志输出中打印有关此视图的信息,标签为 VIEW_LOG_TAG

boolean didTouchFocusSelect()

仅在处理触摸手势时返回true,如果初始触碰事件导致焦点移至文本视图,并且结果改变其选择。

void drawableHotspotChanged(float x, float y)

只要视图热点更改并需要将其传播到视图管理的可绘制视图或子视图,就会调用此函数。

void endBatchEdit()
boolean extractText(ExtractedTextRequest request, ExtractedText outText)

如果此TextView包含可编辑的内容,请根据 请求中的信息将其一部分提取到 outText中

void findViewsWithText(ArrayList<View> outViews, CharSequence searched, int flags)

查找包含给定文本的视图。

CharSequence getAccessibilityClassName()

返回此对象的类名称以用于辅助功能。

final int getAutoLinkMask()

获取文本的自动链接掩码。

int getBaseline()

从小部件的顶部边界返回小部件文本基线的偏移量。

int getBreakStrategy()
int getCompoundDrawablePadding()

返回复合可绘制和文本之间的填充。

ColorStateList getCompoundDrawableTintList()
PorterDuff.Mode getCompoundDrawableTintMode()

如果指定,则返回用于将色调应用于复合绘图的混合模式。

Drawable[] getCompoundDrawables()

返回左边,顶边,右边和底边的可绘制对象。

Drawable[] getCompoundDrawablesRelative()

返回开始,顶部,底部和底部边框的drawables。

int getCompoundPaddingBottom()

返回视图的底部填充,以及底部Drawable(如果有)的空间。

int getCompoundPaddingEnd()

返回视图的结尾填充,加上可用的末端空格(如果有)。

int getCompoundPaddingLeft()

返回视图的左边距,如果有的话,加左边的Drawable空间。

int getCompoundPaddingRight()

返回视图的正确填充,以及右侧Drawable(如果有)的空间。

int getCompoundPaddingStart()

返回视图的开始填充,加上开始Drawable的空间(如果有的话)。

int getCompoundPaddingTop()

返回视图的顶部填充,以及顶部Drawable(如果有)的空间。

final int getCurrentHintTextColor()

返回选定的当前颜色以绘制提示文本。

final int getCurrentTextColor()

返回为普通文本选择的当前颜色。

ActionMode.Callback getCustomInsertionActionModeCallback()

检索 setCustomInsertionActionModeCallback(ActionMode.Callback)设置的值。

ActionMode.Callback getCustomSelectionActionModeCallback()

检索 setCustomSelectionActionModeCallback(ActionMode.Callback)设置的值。

Editable getEditableText()

返回TextView作为可编辑对象显示的文本。

TextUtils.TruncateAt getEllipsize()

返回哪里,如果任何地方,长度比视图宽的单词应该被省略。

CharSequence getError()

如果未设置错误,或者在用户输入后错误已被小部件清除,则返回设置为与 setError(CharSequence)null一起显示的错误消息。

int getExtendedPaddingBottom()

返回视图的扩展底部填充,包括底部Drawable(如果有的话)和任何额外空间以保持超过maxLines的文本显示。

int getExtendedPaddingTop()

返回视图的扩展顶部填充,包括顶部Drawable(如果有的话)以及任何额外空间以保持超过maxLines的文本显示。

InputFilter[] getFilters()

返回输入过滤器的当前列表。

void getFocusedRect(Rect r)

当视图具有焦点并且用户离开它时,从该方法填充的矩形开始搜索下一个视图。

String getFontFeatureSettings()

返回字体功能设置。

boolean getFreezesText()

返回此文本视图是否将其整个文本内容包含在冻结冰柱中。

int getGravity()

返回此TextView的水平和垂直对齐。

int getHighlightColor()
CharSequence getHint()

返回当TextView的文本为空时显示的提示。

final ColorStateList getHintTextColors()
int getHyphenationFrequency()
int getImeActionId()

获取IME动作ID,先前使用 setImeActionLabel(CharSequence, int)设置。

CharSequence getImeActionLabel()

获取先前使用 setImeActionLabel(CharSequence, int)设置的IME操作标签。

LocaleList getImeHintLocales()
int getImeOptions()

获取IME编辑器的类型。

boolean getIncludeFontPadding()

获取TextView是否包含额外的顶部和底部填充以为高于正常上升和下降的口音腾出空间。

Bundle getInputExtras(boolean create)

检索当前与文本视图关联的输入附加内容,可以查看和修改文本视图。

int getInputType()

获取可编辑内容的类型。

final KeyListener getKeyListener()
final Layout getLayout()
float getLetterSpacing()
int getLineBounds(int line, Rect bounds)

返回指定行的基线(0 ... getLineCount() - 1)如果bounds不为null,则返回指定行的顶部,左侧,右侧,底部范围。

int getLineCount()

返回文本的行数,如果尚未构建内部布局,则返回0。

int getLineHeight()
float getLineSpacingExtra()

获取行间距额外的空间

float getLineSpacingMultiplier()

获取行距乘数

final ColorStateList getLinkTextColors()
final boolean getLinksClickable()

返回是否运动方法将被自动设置为 LinkMovementMethod如果 setAutoLinkMask(int)已被设置为非零和检测环节 setText(char[], int, int)

int getMarqueeRepeatLimit()

获取选取框动画重复的次数。

int getMaxEms()
int getMaxHeight()
int getMaxLines()
int getMaxWidth()
int getMinEms()
int getMinHeight()
int getMinLines()
int getMinWidth()
final MovementMethod getMovementMethod()
int getOffsetForPosition(float x, float y)

获取最接近指定绝对位置的字符偏移量。

TextPaint getPaint()
int getPaintFlags()
String getPrivateImeOptions()

获取内容的私人类型。

int getSelectionEnd()

方便 getSelectionEnd(CharSequence)

int getSelectionStart()

方便 getSelectionStart(CharSequence)

int getShadowColor()
float getShadowDx()
float getShadowDy()
float getShadowRadius()

获取阴影图层的半径。

final boolean getShowSoftInputOnFocus()

返回当此TextView聚焦时是否使软输入方法可见。

CharSequence getText()

返回TextView显示的文本。

final ColorStateList getTextColors()

获取TextView的不同状态(正常,选定,聚焦)的文本颜色。

Locale getTextLocale()

获取此TextView中文本的默认主要 Locale

LocaleList getTextLocales()

获取此TextView中文本的默认值 LocaleList

float getTextScaleX()
float getTextSize()
int getTotalPaddingBottom()

返回视图的总底部填充,包括底部Drawable(如果有),保留超过maxLines的额外空间以及重力的垂直偏移(如果有)。

int getTotalPaddingEnd()

返回视图的总结束填充,包括结束Drawable(如果有的话)。

int getTotalPaddingLeft()

返回视图的左侧填充,包括左侧的Drawable(如果有)。

int getTotalPaddingRight()

返回视图的总权限填充,包括右侧的Drawable(如果有)。

int getTotalPaddingStart()

返回视图的总开始填充,包括开始Drawable(如果有的话)。

int getTotalPaddingTop()

返回视图的总顶部填充,包括顶部Drawable(如果有),保留超过maxLines的额外空间以及重力的垂直偏移(如果有)。

final TransformationMethod getTransformationMethod()
Typeface getTypeface()
URLSpan[] getUrls()

返回附加到文本的URLSpans列表(以 Linkify或其他方式)(如果有)。

boolean hasOverlappingRendering()

返回此视图是否包含重叠的内容。

boolean hasSelection()

如果在此文本视图中有选择,则返回true。

void invalidateDrawable(Drawable drawable)

使指定的Drawable无效。

boolean isCursorVisible()
boolean isInputMethodTarget()

返回此文本视图是否是当前输入方法目标。

boolean isSuggestionsEnabled()

返回在此TextView上是否启用建议。

boolean isTextSelectable()

返回 textIsSelectable标志的状态(请参阅 setTextIsSelectable() )。

void jumpDrawablesToCurrentState()

在与此视图关联的所有可绘制对象上调用 Drawable.jumpToCurrentState()

int length()

返回由此TextView管理的文本的长度(以字符为单位)

boolean moveCursorToVisibleOffset()

如果需要,移动光标,使其位于用户可见的偏移位置。

void onBeginBatchEdit()

由框架调用以响应通过调用链接 beginBatchEdit()开始一批编辑操作的请求。

boolean onCheckIsTextEditor()

检查被调用的视图是否是文本编辑器,在这种情况下,为其自动显示软输入窗口是有意义的。

void onCommitCompletion(CompletionInfo text)

由框架调用以响应当前输入方法的文本完成,由它提供,调用 InputConnection.commitCompletion()

void onCommitCorrection(CorrectionInfo info)

由框架调用以响应文本自动更正(例如使用一个字典修复打字错误),由当前输入方法调用,由它提供,调用 commitCorrection(CorrectionInfo) InputConnection.commitCorrection()}。

InputConnection onCreateInputConnection(EditorInfo outAttrs)

为InputMethod创建一个新的InputConnection以与视图交互。

boolean onDragEvent(DragEvent event)

在调用 startDragAndDrop()处理由系统发送的拖动事件。

void onEditorAction(int actionCode)

当附加的输入方法调用 InputConnection.performEditorAction()用于此文本视图时调用。

void onEndBatchEdit()

由框架调用以响应通过调用链接 endBatchEdit()来结束一批编辑操作的请求。

boolean onGenericMotionEvent(MotionEvent event)

实现此方法来处理通用运动事件。

boolean onKeyDown(int keyCode, KeyEvent event)

KeyEvent.Callback.onKeyDown()默认实现:在 KEYCODE_DPAD_CENTERKEYCODE_ENTER被释放时执行按下视图,如果视图已启用并且可点击。

boolean onKeyMultiple(int keyCode, int repeatCount, KeyEvent event)

默认实现 KeyEvent.Callback.onKeyMultiple() :始终返回false(不处理事件)。

boolean onKeyPreIme(int keyCode, KeyEvent event)

在关键事件由与视图层次关联的任何输入方法处理之前处理。

boolean onKeyShortcut(int keyCode, KeyEvent event)

在未处理按键快捷方式事件时调用聚焦视图。

boolean onKeyUp(int keyCode, KeyEvent event)

的默认实现 KeyEvent.Callback.onKeyUp() :当视图进行点击 KEYCODE_DPAD_CENTERKEYCODE_ENTER或者 KEYCODE_SPACE被释放。

boolean onPreDraw()

将在将要绘制视图树时调用回调方法。

boolean onPrivateIMECommand(String action, Bundle data)

由框架调用以响应来自当前方法的私有命令,由它提供,调用 InputConnection.performPrivateCommand()

void onProvideStructure(ViewStructure structure)

作为 Activity.onProvideAssistData一部分从视图中检索辅助结构时调用。

PointerIcon onResolvePointerIcon(MotionEvent event, int pointerIndex)

返回运动事件的指针图标;如果未指定图标,则返回null。

void onRestoreInstanceState(Parcelable state)

吊钩允许重新应用以前由 onSaveInstanceState()生成的内部状态的表示。

void onRtlPropertiesChanged(int layoutDirection)

当任何RTL属性(布局方向或文本方向或文本对齐)已被更改时调用。

Parcelable onSaveInstanceState()

钩子允许视图生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。

void onScreenStateChanged(int screenState)

只要此视图的屏幕状态附加到更改,就会调用此方法。

boolean onTextContextMenuItem(int id)

当选择文本视图的上下文菜单选项时调用。

boolean onTouchEvent(MotionEvent event)

实现此方法来处理触摸屏幕动作事件。

boolean onTrackballEvent(MotionEvent event)

实现这个方法来处理轨迹球运动事件。

void onWindowFocusChanged(boolean hasWindowFocus)

当包含此视图的窗口获得或失去焦点时调用。

boolean performLongClick()

调用此视图的OnLongClickListener(如果已定义)。

void removeTextChangedListener(TextWatcher watcher)

从TextView的文本更改时调用其方法的列表中删除指定的TextWatcher。

void setAllCaps(boolean allCaps)

设置此字段的属性以将输入转换为ALL CAPS显示。

final void setAutoLinkMask(int mask)

设置文本的自动链接掩码。

void setBreakStrategy(int breakStrategy)

设置将段落分段为行的中断策略。

void setCompoundDrawablePadding(int pad)

设置复合绘图和文本之间的填充大小。

void setCompoundDrawableTintList(ColorStateList tint)

为复合绘图应用色调。

void setCompoundDrawableTintMode(PorterDuff.Mode tintMode)

指定用于将 setCompoundDrawableTintList(ColorStateList)指定的色调应用于复合绘图的混合模式。

void setCompoundDrawables(Drawable left, Drawable top, Drawable right, Drawable bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。

void setCompoundDrawablesRelative(Drawable start, Drawable top, Drawable end, Drawable bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。

void setCompoundDrawablesRelativeWithIntrinsicBounds(Drawable start, Drawable top, Drawable end, Drawable bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。

void setCompoundDrawablesRelativeWithIntrinsicBounds(int start, int top, int end, int bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。

void setCompoundDrawablesWithIntrinsicBounds(Drawable left, Drawable top, Drawable right, Drawable bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。

void setCompoundDrawablesWithIntrinsicBounds(int left, int top, int right, int bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。

void setCursorVisible(boolean visible)

设置光标是否可见。

void setCustomInsertionActionModeCallback(ActionMode.Callback actionModeCallback)

如果提供,则在此视图中启动文本插入时,将使用此ActionMode.Callback创建ActionMode。

void setCustomSelectionActionModeCallback(ActionMode.Callback actionModeCallback)

如果提供,则在此视图中启动文本选择时,将使用此ActionMode.Callback来创建ActionMode。

final void setEditableFactory(Editable.Factory factory)

设置用于创建新可编辑的工厂。

void setElegantTextHeight(boolean elegant)

设置TextView的高雅度量标志。

void setEllipsize(TextUtils.TruncateAt where)

使文本中比视图宽度长的文字被省略化,而不是在中间断开。

void setEms(int ems)

使TextView完全有这么多ems

void setEnabled(boolean enabled)

设置此视图的启用状态。

void setError(CharSequence error)

将TextView的右侧复合可绘制设置为“错误”图标,并设置当TextView具有焦点时将在弹出窗口中显示的错误消息。

void setError(CharSequence error, Drawable icon)

将TextView的右侧复合drawable设置为指定的图标,并设置当TextView具有焦点时将在弹出窗口中显示的错误消息。

void setExtractedText(ExtractedText text)

应用于此文本查看给定的提取文本,如以前由 extractText(ExtractedTextRequest, ExtractedText)返回的 extractText(ExtractedTextRequest, ExtractedText)

void setFilters(InputFilter[] filters)

设置缓冲区为可编辑时将使用的输入过滤器列表。

void setFontFeatureSettings(String fontFeatureSettings)

设置字体功能设置。

void setFreezesText(boolean freezesText)

控制此文本视图是否冻结冰柱时保存其全部文本内容,以及动态状态(如光标位置)。

void setGravity(int gravity)

设置文本的水平对齐方式和垂直引力,当TextView中有额外的空间时,将使用超出文本本身所需的空间。

void setHeight(int pixels)

使TextView正好有很多像素。

void setHighlightColor(int color)

设置用于显示选择高亮显示的颜色。

final void setHint(CharSequence hint)

设置当TextView的文本为空时要显示的文本。

final void setHint(int resid)

当TextView的文本为空时,从资源设置要显示的文本。

final void setHintTextColor(ColorStateList colors)

设置提示文本的颜色。

final void setHintTextColor(int color)

为此TextView的所有状态(禁用,聚焦,选定...)设置提示文本的颜色。

void setHorizontallyScrolling(boolean whether)

设置是否允许文本比View更宽。

void setHyphenationFrequency(int hyphenationFrequency)

设置连字频率。

void setImeActionLabel(CharSequence label, int actionId)

更改与文本视图相关联的自定义IME操作,该文本视图具有焦点时将通过 actionLabelactionId向IME报告。

void setImeHintLocales(LocaleList hintLocales)

更改与文本视图关联的“提示”语言环境,该文本视图具有焦点时将通过 hintLocales报告给输入法。

void setImeOptions(int imeOptions)

更改与文本视图相关联的编辑器类型整数,该文本视图具有焦点时将用 imeOptions报告给IME。

void setIncludeFontPadding(boolean includepad)

设置TextView是否包含额外的顶部和底部填充以为高于正常上升和下降的重音腾出空间。

void setInputExtras(int xmlResId)

设置文本的额外输入数据,这是创建输入连接时将填充的 TextBoxAttribute.extras包。

void setInputType(int type)

使用为 inputType定义的常量设置内容的类型。

void setKeyListener(KeyListener input)

设置要用于此TextView的键监听器。

void setLetterSpacing(float letterSpacing)

设置文本字母间距。

void setLineSpacing(float add, float mult)

为此TextView设置行间距。

void setLines(int lines)

使TextView正好有这么多行。

final void setLinkTextColor(ColorStateList colors)

设置文本中链接的颜色。

final void setLinkTextColor(int color)

设置文本中链接的颜色。

final void setLinksClickable(boolean whether)

设置是否运动方法将被自动设置为 LinkMovementMethod如果 setAutoLinkMask(int)已被设置为非零和检测环节 setText(char[], int, int)

void setMarqueeRepeatLimit(int marqueeLimit)

设置重复选取框动画的次数。

void setMaxEms(int maxems)

使TextView最多有这么多的ems

void setMaxHeight(int maxHeight)

使TextView至多有很多像素高。

void setMaxLines(int maxlines)

使TextView至多有很多行高。

void setMaxWidth(int maxpixels)

使TextView最多有很多个像素

void setMinEms(int minems)

使TextView至少有很多这样的ems

void setMinHeight(int minHeight)

使TextView至少有很多像素高。

void setMinLines(int minlines)

使TextView至少有这么多行高。

void setMinWidth(int minpixels)

使TextView的宽度至少有很多像素

final void setMovementMethod(MovementMethod movement)

设置要用于此TextView的移动方法(箭头键处理程序)。

void setOnEditorActionListener(TextView.OnEditorActionListener l)

设置一个特殊的侦听器,以便在文本视图上执行操作时调用。

void setPadding(int left, int top, int right, int bottom)

设置填充。

void setPaddingRelative(int start, int top, int end, int bottom)

设置相对填充。

void setPaintFlags(int flags)

在正在使用的Paint上设置标志以显示文本,如果文本与旧标志不同,则重新排列文本。

void setPrivateImeOptions(String type)

设置文本的私人内容类型,即在创建输入连接时将填充的 EditorInfo.privateImeOptions字段。

void setRawInputType(int type)

直接更改文本视图的内容类型整数,而不修改任何其他状态。

void setScroller(Scroller s)
void setSelectAllOnFocus(boolean selectAllOnFocus)

设置TextView,以便在焦点时选中所有文本。

void setSelected(boolean selected)

更改此视图的选择状态。

void setShadowLayer(float radius, float dx, float dy, int color)

给文本指定的模糊半径和颜色的阴影,指定距离其绘制位置的距离。

final void setShowSoftInputOnFocus(boolean show)

设置在此TextView获得焦点时是否使软输入方法可见。

void setSingleLine(boolean singleLine)

如果为true,则将该字段的属性(行数,水平滚动,转换方法)设置为单行输入; 如果为false,则将其恢复为默认条件。

void setSingleLine()

将此字段的属性(行,水平滚动,转换方法)设置为单行输入。

final void setSpannableFactory(Spannable.Factory factory)

设置用于创建新Spannable的工厂。

final void setText(int resid)
final void setText(CharSequence text)

设置TextView的字符串值。

void setText(CharSequence text, TextView.BufferType type)

设置此TextView要显示的文本(请参阅 setText(CharSequence) ),并设置它是否存储在可修改样式/可扩展缓冲区中以及是否可编辑。

final void setText(int resid, TextView.BufferType type)
final void setText(char[] text, int start, int len)

将TextView设置为显示指定char数组的指定切片。

void setTextAppearance(Context context, int resId)

此方法在API级别23中已弃用。请改用setTextAppearance(int)

void setTextAppearance(int resId)

从指定的样式资源中设置文本外观。

void setTextColor(int color)

将所有状态(正常,选定,聚焦)的文本颜色设置为该颜色。

void setTextColor(ColorStateList colors)

设置文字颜色。

void setTextIsSelectable(boolean selectable)

设置此视图的内容是否可由用户选择。

final void setTextKeepState(CharSequence text)

setText(CharSequence)一样,除了光标位置(如果有的话)保留在新文本中。

final void setTextKeepState(CharSequence text, TextView.BufferType type)

setText(CharSequence, android.widget.TextView.BufferType)一样,除了光标位置(如果有)保留在新文本中。

void setTextLocale(Locale locale)

将此TextView中文本的默认值 LocaleList设置为仅包含给定值的一个成员列表。

void setTextLocales(LocaleList locales)

将此TextView中文本的默认值 LocaleList设置为给定值。

void setTextScaleX(float size)

设置文本水平伸展的范围。

void setTextSize(int unit, float size)

将默认文字大小设置为给定的单位和值。

void setTextSize(float size)

将默认文字大小设置为给定值,解释为“缩放像素”单位。

final void setTransformationMethod(TransformationMethod method)

设置应用于此TextView显示的文本的转换。

void setTypeface(Typeface tf)

设置文字应显示的字体和样式。

void setTypeface(Typeface tf, int style)

设置应该显示文本的字体和样式,如果您提供的字体没有指定样式中的所有位,则打开“Paint”中的假粗体和斜体位。

void setWidth(int pixels)

使TextView正好有很多像素宽。

boolean showContextMenu()

显示该视图的上下文菜单。

boolean showContextMenu(float x, float y)

显示锚定到指定视图相对坐标的此视图的上下文菜单。

Protected methods

int computeHorizontalScrollRange()

计算水平滚动条代表的水平范围。

int computeVerticalScrollExtent()

计算垂直滚动条拇指在垂直范围内的垂直范围。

int computeVerticalScrollRange()

计算垂直滚动条代表的垂直范围。

void drawableStateChanged()

只要视图的状态发生变化,就会调用此函数,使得它影响所显示的可绘制状态。

int getBottomPaddingOffset()

扩展底部衰落区域的数量。

boolean getDefaultEditable()

子类覆盖这个以指定它们默认具有KeyListener,即使在XML选项中没有专门调用它。

MovementMethod getDefaultMovementMethod()

子类覆盖此以指定默认移动方法。

float getLeftFadingEdgeStrength()

返回左边渐变边的强度或强度。

int getLeftPaddingOffset()

扩展左衰落区域的量。

float getRightFadingEdgeStrength()

返回右边褪色边缘的强度或强度。

int getRightPaddingOffset()

扩展正确衰落区域的数量。

int getTopPaddingOffset()

扩大最大衰落区域的数量。

boolean isPaddingOffsetRequired()

如果视图在其填充内绘制内容并启用淡化边缘,则需要支持填充偏移。

void onAttachedToWindow()

这在视图附加到窗口时被调用。

void onConfigurationChanged(Configuration newConfig)

当应用程序使用的资源的当前配置发生更改时调用。

void onCreateContextMenu(ContextMenu menu)

如果视图本身要将项目添加到上下文菜单,则视图应该执行此操作。

int[] onCreateDrawableState(int extraSpace)

为此视图生成新的 Drawable状态。

void onDraw(Canvas canvas)

实施这个来做你的绘画。

void onFocusChanged(boolean focused, int direction, Rect previouslyFocusedRect)

当视图的焦点状态改变时,由视图系统调用。

void onLayout(boolean changed, int left, int top, int right, int bottom)

当这个视图为每个孩子分配一个大小和位置时,从布局调用。

void onMeasure(int widthMeasureSpec, int heightMeasureSpec)

测量视图及其内容以确定测量宽度和测量高度。

void onScrollChanged(int horiz, int vert, int oldHoriz, int oldVert)

这是为了响应此视图中的内部滚动而调用的(即视图滚动了其自己的内容)。

void onSelectionChanged(int selStart, int selEnd)

当选择发生变化时调用此方法,以防子类想知道。

void onTextChanged(CharSequence text, int start, int lengthBefore, int lengthAfter)

当文本被改变时,这个方法被调用,以防任何子类想知道。

void onVisibilityChanged(View changedView, int visibility)

当视图的可见性或视图的祖先已更改时调用。

boolean setFrame(int l, int t, int r, int b)

为此视图分配大小和位置。

boolean verifyDrawable(Drawable who)

如果你的视图子类正在显示它自己的Drawable对象,它应该覆盖这个函数,并且对于它显示的任何Drawable返回true。

Inherited methods

From class android.view.View
From class java.lang.Object
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource
From interface android.view.ViewTreeObserver.OnPreDrawListener

XML attributes

android:autoLink

控制是否自动找到诸如网址和电子邮件地址之类的链接并将其转换为可点击链接。 默认值是“none”,禁用此功能。

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
none 0x00 Match no patterns (default).
web 0x01 Match Web URLs.
email 0x02 Match email addresses.
phone 0x04 Match phone numbers.
map 0x08 Match map addresses.
all 0x0f Match all patterns (equivalent to web|email|phone|map).

这对应于全局属性资源符号 autoLink

相关方法:

android:autoText

如果设置,则指定此TextView具有文本输入方法并自动更正一些常见的拼写错误。 默认值是“false”。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 autoText

相关方法:

android:breakStrategy

休息策略(控制段落布局)。

必须是下列常数值之一。

Constant Value 描述
simple 0 Line breaking uses simple strategy.
high_quality 1 Line breaking uses high-quality strategy, including hyphenation.
balanced 2 Line breaking strategy balances line lengths.

这对应于全局属性资源符号 breakStrategy

相关方法:

android:bufferType

确定getText()将返回的最小类型。 默认值是“正常”。 请注意,EditText和LogTextBox总是返回Editable,即使您在此处指定的功能较弱。

必须是下列常数值之一。

Constant Value 描述
normal 0 Can return any CharSequence, possibly a Spanned one if the source text was Spanned.
spannable 1 Can only return Spannable.
editable 2 Can only return Spannable and Editable.

这对应于全局属性资源符号 bufferType

相关方法:

android:capitalize

如果设置,则指定此TextView具有文本输入方法,并应自动大写用户输入的内容。 默认值是“none”。

必须是下列常数值之一。

Constant Value 描述
none 0 Don't automatically capitalize anything.
sentences 1 Capitalize the first word of each sentence.
words 2 Capitalize the first letter of every word.
characters 3 Capitalize every character.

这对应于全局属性资源符号 capitalize

相关方法:

android:cursorVisible

使光标可见(默认)或不可见。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 cursorVisible

相关方法:

android:digits

如果设置,则指定此TextView具有数字输入方法,并且这些特定字符是它将接受的字符。 如果设置了,数字暗示为真。 默认值是false。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 digits

相关方法:

android:drawableBottom

绘制在文本下面绘制。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 drawableBottom

相关方法:

android:drawableEnd

可绘制到文本的末尾。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 drawableEnd

相关方法:

android:drawableLeft

可绘制在文本的左侧。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

颜色值可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”的形式。

这对应于全局属性资源符号 drawableLeft

相关方法:

android:drawablePadding

可绘制和文本之间的填充。

必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 drawablePadding

相关方法:

android:drawableRight

可绘制的文本右侧。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 drawableRight

相关方法:

android:drawableStart

可绘制的文本的开始。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

颜色值可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”的形式。

这对应于全局属性资源符号 drawableStart

相关方法:

android:drawableTint

色调适用于化合物(左,顶等)可绘制。

必须是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 drawableTint

相关方法:

android:drawableTintMode

用于应用化合物的混合模式(左,顶等)可绘制色调。

必须是下列常数值之一。

Constant Value 描述
src_over 3 The tint is drawn on top of the drawable. [Sa + (1 - Sa)*Da, Rc = Sc + (1 - Sa)*Dc]
src_in 5 The tint is masked by the alpha channel of the drawable. The drawable’s color channels are thrown out. [Sa * Da, Sc * Da]
src_atop 9 The tint is drawn above the drawable, but with the drawable’s alpha channel masking the result. [Da, Sc * Da + (1 - Sa) * Dc]
multiply 14 Multiplies the color and alpha channels of the drawable with those of the tint. [Sa * Da, Sc * Dc]
screen 15 [Sa + Da - Sa * Da, Sc + Dc - Sc * Dc]
add 16 Combines the tint and drawable color and alpha channels, clamping the result to valid color values. Saturate(S + D)

这对应于全局属性资源符号 drawableTintMode

相关方法:

android:drawableTop

绘制在文本上方。

可能是对其他资源的引用,形式为“ @[+][package:]type:name ”,也可能是对“ ?[package:][type:]name ”形式的主题属性的 ?[package:][type:]name

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 drawableTop

相关方法:

android:editable

如果设置,则指定此TextView具有输入方法。 除非另有说明,否则它将是一个文本。 对于TextView,默认情况下这是false。 对于EditText,默认情况下是true。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 editable

android:editorExtras

参考<input-extras> XML资源,其中包含用于提供给输入方法的附加数据,该方法对输入方法的实现是私有的。 输入法连接时, EditorInfo.extras填写EditorInfo.extras字段。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 editorExtras

相关方法:

android:elegantTextHeight

优雅的文字高度,尤其适合压缩程度较低的复杂脚本文字。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 elegantTextHeight

相关方法:

android:ellipsize

如果设置,则会导致比视图更长的单词被宽化为椭圆化,而不是在中间断开。 你通常也会想要设置scrollHorizontally或singleLine,这样文本作为一个整体也被约束为一行,而不是被允许分割成多行。

必须是下列常数值之一。

Constant Value 描述
none 0
start 1
middle 2
end 3
marquee 4

这对应于全局属性资源符号 ellipsize

相关方法:

android:ems

使TextView正好是这么多的ems。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 ems

相关方法:

android:fontFamily

字体家族(以字符串命名)为文本。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 fontFamily

相关方法:

android:fontFeatureSettings

字体功能设置。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 fontFeatureSettings

相关方法:

android:freezesText

如果设置,除了元数据(如当前光标位置)之外,文本视图还会将其当前完整文本包含在冻结冰柱内。 默认情况下,这是禁用的; 当文本视图的内容未存储在诸如内容提供者的持久位置时,它可能很有用。 对于EditText它始终处于启用状态,无论该属性的值如何。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 freezesText

相关方法:

android:gravity

指定当文本小于视图时,如何通过视图的x轴和/或y轴对齐文本。

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
top 0x30 Push object to the top of its container, not changing its size.
bottom 0x50 Push object to the bottom of its container, not changing its size.
left 0x03 Push object to the left of its container, not changing its size.
right 0x05 Push object to the right of its container, not changing its size.
center_vertical 0x10 Place object in the vertical center of its container, not changing its size.
fill_vertical 0x70 Grow the vertical size of the object if needed so it completely fills its container.
center_horizontal 0x01 Place object in the horizontal center of its container, not changing its size.
fill_horizontal 0x07 Grow the horizontal size of the object if needed so it completely fills its container.
center 0x11 Place the object in the center of its container in both the vertical and horizontal axis, not changing its size.
fill 0x77 Grow the horizontal and vertical size of the object if needed so it completely fills its container.
clip_vertical 0x80 Additional option that can be set to have the top and/or bottom edges of the child clipped to its container's bounds. The clip will be based on the vertical gravity: a top gravity will clip the bottom edge, a bottom gravity will clip the top edge, and neither will clip both edges.
clip_horizontal 0x08 Additional option that can be set to have the left and/or right edges of the child clipped to its container's bounds. The clip will be based on the horizontal gravity: a left gravity will clip the right edge, a right gravity will clip the left edge, and neither will clip both edges.
start 0x00800003 Push object to the beginning of its container, not changing its size.
end 0x00800005 Push object to the end of its container, not changing its size.

这对应于全局属性资源符号 gravity

相关方法:

android:height

使TextView的高度恰到好处。 您可以通过在布局参数中指定此编号来获得相同的效果。

必须是维度值,这是一个浮点数字,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可以是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 height

相关方法:

android:hint

提示文本在文本为空时显示。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 hint

相关方法:

android:hyphenationFrequency

自动连字符的频率。

必须是下列常数值之一。

Constant Value 描述
none 0 No hyphenation.
normal 1 Less frequent hyphenation, useful for informal use cases, such as chat messages.
full 2 Standard amount of hyphenation, useful for running text and for screens with limited space for text.

这对应于全局属性资源符号 hyphenationFrequency

相关方法:

android:imeActionId

为输入法连接到文本视图时提供 EditorInfo.actionId的值。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 imeActionId

相关方法:

android:imeActionLabel

为输入法连接到文本视图时提供的值为 EditorInfo.actionLabel

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 imeActionLabel

相关方法:

android:imeOptions

您可以在与编辑器关联的IME中启用其他功能,以改善与应用程序的集成。 这里的常量对应于由imeOptions定义的imeOptions

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
normal 0x00000000 There are no special semantics associated with this editor.
actionUnspecified 0x00000000 There is no specific action associated with this editor, let the editor come up with its own if it can. Corresponds to IME_NULL.
actionNone 0x00000001 This editor has no action associated with it. Corresponds to IME_ACTION_NONE.
actionGo 0x00000002 The action key performs a "go" operation to take the user to the target of the text they typed. Typically used, for example, when entering a URL. Corresponds to IME_ACTION_GO.
actionSearch 0x00000003 The action key performs a "search" operation, taking the user to the results of searching for the text the have typed (in whatever context is appropriate). Corresponds to IME_ACTION_SEARCH.
actionSend 0x00000004 The action key performs a "send" operation, delivering the text to its target. This is typically used when composing a message. Corresponds to IME_ACTION_SEND.
actionNext 0x00000005 The action key performs a "next" operation, taking the user to the next field that will accept text. Corresponds to IME_ACTION_NEXT.
actionDone 0x00000006 The action key performs a "done" operation, closing the soft input method. Corresponds to IME_ACTION_DONE.
actionPrevious 0x00000007 The action key performs a "previous" operation, taking the user to the previous field that will accept text. Corresponds to IME_ACTION_PREVIOUS.
flagNoFullscreen 0x2000000 Used to request that the IME never go into fullscreen mode. Applications need to be aware that the flag is not a guarantee, and not all IMEs will respect it.

对应于 IME_FLAG_NO_FULLSCREEN

flagNavigatePrevious 0x4000000 Like flagNavigateNext, but specifies there is something interesting that a backward navigation can focus on. If the user selects the IME's facility to backward navigate, this will show up in the application as an actionPrevious at InputConnection.performEditorAction(int).

对应于 IME_FLAG_NO_FULLSCREEN

flagNavigateNext 0x8000000 Used to specify that there is something interesting that a forward navigation can focus on. This is like using actionNext, except allows the IME to be multiline (with an enter key) as well as provide forward navigation. Note that some IMEs may not be able to do this, especially when running on a small screen where there is little space. In that case it does not need to present a UI for this option. Like actionNext, if the user selects the IME's facility to forward navigate, this will show up in the application at InputConnection.performEditorAction(int).

对应于 IME_FLAG_NAVIGATE_NEXT

flagNoExtractUi 0x10000000 Used to specify that the IME does not need to show its extracted text UI. For input methods that may be fullscreen, often when in landscape mode, this allows them to be smaller and let part of the application be shown behind. Though there will likely be limited access to the application available from the user, it can make the experience of a (mostly) fullscreen IME less jarring. Note that when this flag is specified the IME may not be set up to be able to display text, so it should only be used in situations where this is not needed.

对应于 IME_FLAG_NO_EXTRACT_UI

flagNoAccessoryAction 0x20000000 Used in conjunction with a custom action, this indicates that the action should not be available as an accessory button when the input method is full-screen. Note that by setting this flag, there can be cases where the action is simply never available to the user. Setting this generally means that you think showing text being edited is more important than the action you have supplied.

对应于 IME_FLAG_NO_ACCESSORY_ACTION

flagNoEnterAction 0x40000000 Used in conjunction with a custom action, this indicates that the action should not be available in-line as a replacement for the "enter" key. Typically this is because the action has such a significant impact or is not recoverable enough that accidentally hitting it should be avoided, such as sending a message. Note that TextView will automatically set this flag for you on multi-line text views.

对应于 IME_FLAG_NO_ENTER_ACTION

flagForceAscii 0x80000000 Used to request that the IME should be capable of inputting ASCII characters. The intention of this flag is to ensure that the user can type Roman alphabet characters in a TextView used for, typically, account ID or password input. It is expected that IMEs normally are able to input ASCII even without being told so (such IMEs already respect this flag in a sense), but there could be some cases they aren't when, for instance, only non-ASCII input languagaes like Arabic, Greek, Hebrew, Russian are enabled in the IME. Applications need to be aware that the flag is not a guarantee, and not all IMEs will respect it. However, it is strongly recommended for IME authors to respect this flag especially when their IME could end up with a state that has only non-ASCII input languages enabled.

对应于 IME_FLAG_FORCE_ASCII

这对应于全局属性资源符号 imeOptions

相关方法:

android:includeFontPadding

给上行和下行留出足够的空间,而不是严格使用字体上升和下降。 (通常是真的)。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 includeFontPadding

相关方法:

android:inputMethod

如果设置,则指定此TextView应使用指定的输入方法(由完全限定的类名指定)。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 inputMethod

相关方法:

android:inputType

放置在文本字段中的数据类型,用于帮助输入法决定如何让用户输入文本。 这里的常量对应于由InputType定义的InputType 一般来说,您可以选择一个值,但有些可以按照指示组合在一起。 将此属性设置为除非之外的任何内容也意味着文本是可编辑的。

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
none 0x00000000 There is no content type. The text is not editable.
text 0x00000001 Just plain old text. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_NORMAL.
textCapCharacters 0x00001001 Can be combined with text and its variations to request capitalization of all characters. Corresponds to TYPE_TEXT_FLAG_CAP_CHARACTERS.
textCapWords 0x00002001 Can be combined with text and its variations to request capitalization of the first character of every word. Corresponds to TYPE_TEXT_FLAG_CAP_WORDS.
textCapSentences 0x00004001 Can be combined with text and its variations to request capitalization of the first character of every sentence. Corresponds to TYPE_TEXT_FLAG_CAP_SENTENCES.
textAutoCorrect 0x00008001 Can be combined with text and its variations to request auto-correction of text being input. Corresponds to TYPE_TEXT_FLAG_AUTO_CORRECT.
textAutoComplete 0x00010001 Can be combined with text and its variations to specify that this field will be doing its own auto-completion and talking with the input method appropriately. Corresponds to TYPE_TEXT_FLAG_AUTO_COMPLETE.
textMultiLine 0x00020001 Can be combined with text and its variations to allow multiple lines of text in the field. If this flag is not set, the text field will be constrained to a single line. Corresponds to TYPE_TEXT_FLAG_MULTI_LINE.
textImeMultiLine 0x00040001 Can be combined with text and its variations to indicate that though the regular text view should not be multiple lines, the IME should provide multiple lines if it can. Corresponds to TYPE_TEXT_FLAG_IME_MULTI_LINE.
textNoSuggestions 0x00080001 Can be combined with text and its variations to indicate that the IME should not show any dictionary-based word suggestions. Corresponds to TYPE_TEXT_FLAG_NO_SUGGESTIONS.
textUri 0x00000011 Text that will be used as a URI. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_URI.
textEmailAddress 0x00000021 Text that will be used as an e-mail address. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_EMAIL_ADDRESS.
textEmailSubject 0x00000031 Text that is being supplied as the subject of an e-mail. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_EMAIL_SUBJECT.
textShortMessage 0x00000041 Text that is the content of a short message. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_SHORT_MESSAGE.
textLongMessage 0x00000051 Text that is the content of a long message. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_LONG_MESSAGE.
textPersonName 0x00000061 Text that is the name of a person. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_PERSON_NAME.
textPostalAddress 0x00000071 Text that is being supplied as a postal mailing address. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_POSTAL_ADDRESS.
textPassword 0x00000081 Text that is a password. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_PASSWORD.
textVisiblePassword 0x00000091 Text that is a password that should be visible. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_VISIBLE_PASSWORD.
textWebEditText 0x000000a1 Text that is being supplied as text in a web form. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_WEB_EDIT_TEXT.
textFilter 0x000000b1 Text that is filtering some other data. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_FILTER.
textPhonetic 0x000000c1 Text that is for phonetic pronunciation, such as a phonetic name field in a contact entry. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_PHONETIC.
textWebEmailAddress 0x000000d1 Text that will be used as an e-mail address on a web form. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_WEB_EMAIL_ADDRESS.
textWebPassword 0x000000e1 Text that will be used as a password on a web form. Corresponds to TYPE_CLASS_TEXT | TYPE_TEXT_VARIATION_WEB_PASSWORD.
number 0x00000002 A numeric only field. Corresponds to TYPE_CLASS_NUMBER | TYPE_NUMBER_VARIATION_NORMAL.
numberSigned 0x00001002 Can be combined with number and its other options to allow a signed number. Corresponds to TYPE_CLASS_NUMBER | TYPE_NUMBER_FLAG_SIGNED.
numberDecimal 0x00002002 Can be combined with number and its other options to allow a decimal (fractional) number. Corresponds to TYPE_CLASS_NUMBER | TYPE_NUMBER_FLAG_DECIMAL.
numberPassword 0x00000012 A numeric password field. Corresponds to TYPE_CLASS_NUMBER | TYPE_NUMBER_VARIATION_PASSWORD.
phone 0x00000003 For entering a phone number. Corresponds to TYPE_CLASS_PHONE.
datetime 0x00000004 For entering a date and time. Corresponds to TYPE_CLASS_DATETIME | TYPE_DATETIME_VARIATION_NORMAL.
date 0x00000014 For entering a date. Corresponds to TYPE_CLASS_DATETIME | TYPE_DATETIME_VARIATION_DATE.
time 0x00000024 For entering a time. Corresponds to TYPE_CLASS_DATETIME | TYPE_DATETIME_VARIATION_TIME.

这对应于全局属性资源符号 inputType

相关方法:

android:letterSpacing

文本字母间距。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 letterSpacing

相关方法:

android:lineSpacingExtra

文本行之间的额外间距。

必须是尺寸值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 lineSpacingExtra

相关方法:

android:lineSpacingMultiplier

作为乘数的文本行之间的额外间距。

必须是浮点值,例如“ 1.2 ”。

这也可以是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 lineSpacingMultiplier

相关方法:

android:lines

使TextView正好有这么多的高度。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 lines

相关方法:

android:linksClickable

如果设置为false,即使自动链接导致找到链接,也不会将移动方法设置为链接移动方法。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 linksClickable

相关方法:

android:marqueeRepeatLimit

重复选取框动画的次数。 仅在TextView启用了选取框的情况下应用。

可能是一个整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

可能是以下常数值之一。

Constant Value 描述
marquee_forever -1 Indicates that marquee should repeat indefinitely.

这对应于全局属性资源符号 marqueeRepeatLimit

相关方法:

android:maxEms

使TextView最多只有这么多ems。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxEms

相关方法:

android:maxHeight

使TextView最多只有很多像素。

必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxHeight

相关方法:

android:maxLength

设置输入过滤器以将文本长度限制为指定的数字。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxLength

相关方法:

android:maxLines

使TextView最多只有这么多行。 在可编辑文本上使用时,必须将inputType属性的值与textMultiLine标志组合以应用maxLines属性。

必须是整数值,例如“ 100 ”。

这也可以是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxLines

相关方法:

android:maxWidth

使TextView最多只有很多像素。

必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxWidth

相关方法:

android:minEms

使TextView至少有这么多ems广泛。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 minEms

相关方法:

android:minHeight

使TextView至少有很多像素高。

必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 minHeight

相关方法:

android:minLines

使TextView至少有这么多行高。 在可编辑文本上使用时,必须将inputType属性的值与要应用minLines属性的textMultiLine标志组合使用。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 minLines

相关方法:

android:minWidth

使TextView的宽度至少有很多像素。

必须是一个维度值,它是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 minWidth

相关方法:

android:numeric

如果设置,则指定此TextView具有数字输入方法。 默认值是false。

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
integer 0x01 Input is numeric.
signed 0x03 Input is numeric, with sign allowed.
decimal 0x05 Input is numeric, with decimals allowed.

这对应于全局属性资源符号 numeric

相关方法:

android:password

字段的字符是否显示为密码点而不是它们自己。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 password

相关方法:

android:phoneNumber

如果设置,则指定此TextView具有电话号码输入方法。 默认值是false。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 phoneNumber

相关方法:

android:privateImeOptions

添加内容类型描述以提供给附加到文本视图的输入方法,这对输入方法的实现是私有的。 输入法连接时, EditorInfo.privateImeOptions填写EditorInfo.privateImeOptions字段。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 privateImeOptions

相关方法:

android:scrollHorizontally

文本是否允许比视图更宽(因此可以水平滚动)。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 scrollHorizontally

相关方法:

android:selectAllOnFocus

如果文本可选,请在视图获得焦点时全选。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 selectAllOnFocus

相关方法:

android:shadowColor

在文本下方放置一个模糊的文本阴影,用指定的颜色绘制。 生成的文本阴影不会与视图上负责实时阴影的elevationtranslationZ

必须是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 shadowColor

相关方法:

android:shadowDx

文字阴影的水平偏移量。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 shadowDx

相关方法:

android:shadowDy

文字阴影的垂直偏移量。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 shadowDy

相关方法:

android:shadowRadius

模糊文字阴影的半径。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 shadowRadius

相关方法:

android:singleLine

将文本约束为一条水平滚动线,而不是让它包装到多条线上,并在按下回车键时提前聚焦而不是插入换行符。 对于不可编辑的文本,默认值为false(多行封装文本模式),但如果为inputType指定了任何值,则默认值为true(单行输入字段模式)。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 singleLine

相关方法:

android:text

要显示的文本。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 text

相关方法:

android:textAllCaps

以全部大写显示文字。 这可能会使用小型表格。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textAllCaps

相关方法:

android:textAppearance

基本文字颜色,字体,大小和样式。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 textAppearance

相关方法:

android:textColor

文字颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 textColor

相关方法:

android:textColorHighlight

文本选择突出显示的颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 textColorHighlight

相关方法:

android:textColorHint

提示文本的颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 textColorHint

相关方法:

android:textColorLink

链接的文字颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 textColorLink

相关方法:

android:textIsSelectable

表示可以选择不可编辑文本的内容。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textIsSelectable

相关方法:

android:textScaleX

设置文字的水平比例因子。

必须是浮点值,例如“ 1.2 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textScaleX

相关方法:

android:textSize

文字的大小。 对于缩放像素,文本的推荐尺寸类型是“sp”(例如:15sp)。

必须是一个维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 textSize

相关方法:

android:textStyle

文字的样式(粗体,斜体,粗体)。

必须是以下常量值中的一个或多个(用'|'分隔)。

Constant Value 描述
normal 0
bold 1
italic 2

这对应于全局属性资源符号 textStyle

相关方法:

android:typeface

文字的字体(正常,无符号,衬线,等宽)。

必须是下列常数值之一。

Constant Value 描述
normal 0
sans 1
serif 2
monospace 3

这对应于全局属性资源符号 typeface

相关方法:

android:width

使TextView正好有很多像素宽。 您可以通过在布局参数中指定此编号来获得相同的效果。

必须是维度值,这是一个浮点数,后面跟着一个单位,例如“ 14.5sp ”。 可用单位为:px(像素),dp(密度独立像素),sp(基于首选字体大小的缩放像素),单位为英寸,毫米(毫米)。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 width

相关方法:

Public constructors

TextView

Added in API level 1
TextView (Context context)

Parameters
context Context

TextView

Added in API level 1
TextView (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

TextView

Added in API level 1
TextView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

TextView

Added in API level 21
TextView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

Public methods

addTextChangedListener

Added in API level 1
void addTextChangedListener (TextWatcher watcher)

将TextWatcher添加到无论TextView的文本更改时调用方法的列表中。

在1.0中, afterTextChanged(Editable)方法在setText(char[], int, int)调用后错误地未被调用。 现在,如果存在任何文本, setText(char[], int, int)更改的侦听器强制缓冲区类型为可编辑(如果它不会),并调用此方法。

Parameters
watcher TextWatcher

append

Added in API level 1
void append (CharSequence text)

便捷方法:将指定的文本附加到TextView的显示缓冲区,如果它尚不可编辑,则将其升级到BufferType.EDITABLE。

Parameters
text CharSequence

append

Added in API level 1
void append (CharSequence text, 
                int start, 
                int end)

便捷方法:将指定的文本切片附加到TextView的显示缓冲区,如果它尚不可编辑,则将其升级到BufferType.EDITABLE。

Parameters
text CharSequence
start int
end int

beginBatchEdit

Added in API level 3
void beginBatchEdit ()

bringPointIntoView

Added in API level 3
boolean bringPointIntoView (int offset)

如果需要,将偏移量指定的点移动到视图中。 这必须在布局后调用。 如果有更改,则返回true。

Parameters
offset int
Returns
boolean

cancelLongPress

Added in API level 1
void cancelLongPress ()

取消待处理的长按。 如果用户在同一个地方按下并保持上下文菜单,那么您的子类可以使用它,但如果按下然后移动到足以引起滚动,则不希望它出现。

clearComposingText

Added in API level 3
void clearComposingText ()

使用 BaseInputConnection.removeComposingSpans()可从此文本视图中删除任何IME撰写状态。

computeScroll

Added in API level 1
void computeScroll ()

由父级调用,以请求孩子在必要时更新mScrollX和mScrollY的值。 这通常会在孩子使用Scroller对象动画滚动时Scroller

debug

Added in API level 1
void debug (int depth)

在日志输出中打印有关此视图的信息,标记为VIEW_LOG_TAG 输出中的每一行前都有一个由depth定义的depth

Parameters
depth int: the indentation level

didTouchFocusSelect

Added in API level 3
boolean didTouchFocusSelect ()

仅在处理触摸手势时返回true,如果初始触碰事件导致焦点移至文本视图,并且结果改变其选择。 仅在处理感兴趣的触摸手势时才有效,在可编辑的文本视图中。

Returns
boolean

drawableHotspotChanged

Added in API level 21
void drawableHotspotChanged (float x, 
                float y)

只要视图热点更改并需要将其传播到视图管理的可绘制视图或子视图,就会调用此函数。

调度到子视图由 dispatchDrawableHotspotChanged(float, float)处理。

重写此功能时,一定要调用超类。

Parameters
x float: hotspot x coordinate
y float: hotspot y coordinate

endBatchEdit

Added in API level 3
void endBatchEdit ()

extractText

Added in API level 3
boolean extractText (ExtractedTextRequest request, 
                ExtractedText outText)

如果此TextView包含可编辑的内容,请根据 请求中的信息将其一部分提取到 outText中

Parameters
request ExtractedTextRequest
outText ExtractedText
Returns
boolean Returns true if the text was successfully extracted, else false.

findViewsWithText

Added in API level 14
void findViewsWithText (ArrayList<View> outViews, 
                CharSequence searched, 
                int flags)

查找包含给定文本的视图。 遏制是不区分大小写的。 搜索由视图呈现的文本或描述视图的内容描述执行,以实现辅助功能,视图不呈现或两者兼而有之。 客户可以通过传递FIND_VIEWS_WITH_TEXTFIND_VIEWS_WITH_CONTENT_DESCRIPTION标志来指定如何执行搜索。

Parameters
outViews ArrayList: The output list of matching Views.
searched CharSequence: The text to match against.
flags int

getAccessibilityClassName

Added in API level 23
CharSequence getAccessibilityClassName ()

返回此对象的类名称以用于辅助功能。 如果子类正在实现的东西应该被视为一个全新的视图类,当它被可访问性使用时,子类只应该覆盖这个子类,与它所源自的类无关。 这用于填写AccessibilityNodeInfo.setClassName

Returns
CharSequence

getAutoLinkMask

Added in API level 1
int getAutoLinkMask ()

获取文本的自动链接掩码。 请参阅Linkify.ALL和同行以了解可能的值。

相关XML属性:

Returns
int

getBaseline

Added in API level 1
int getBaseline ()

从小部件的顶部边界返回小部件文本基线的偏移量。 如果此小部件不支持基线对齐,则此方法返回-1。

Returns
int the offset of the baseline within the widget's bounds or -1 if baseline alignment is not supported

getBreakStrategy

Added in API level 23
int getBreakStrategy ()

相关XML属性:

Returns
int the currently set break strategy.

也可以看看:

getCompoundDrawablePadding

Added in API level 1
int getCompoundDrawablePadding ()

返回复合可绘制和文本之间的填充。

相关XML属性:

Returns
int

getCompoundDrawableTintList

Added in API level 23
ColorStateList getCompoundDrawableTintList ()

相关XML属性:

Returns
ColorStateList the tint applied to the compound drawables

也可以看看:

getCompoundDrawableTintMode

Added in API level 23
PorterDuff.Mode getCompoundDrawableTintMode ()

如果指定,则返回用于将色调应用于复合绘图的混合模式。

相关XML属性:

Returns
PorterDuff.Mode the blending mode used to apply the tint to the compound drawables

也可以看看:

getCompoundDrawables

Added in API level 1
Drawable[] getCompoundDrawables ()

返回左边,顶边,右边和底边的可绘制对象。

相关XML属性:

Returns
Drawable[]

getCompoundDrawablesRelative

Added in API level 17
Drawable[] getCompoundDrawablesRelative ()

返回开始,顶部,底部和底部边框的drawables。

相关XML属性:

Returns
Drawable[]

getCompoundPaddingBottom

Added in API level 1
int getCompoundPaddingBottom ()

返回视图的底部填充,以及底部Drawable(如果有)的空间。

Returns
int

getCompoundPaddingEnd

Added in API level 17
int getCompoundPaddingEnd ()

返回视图的结尾填充,加上可用的末端空格(如果有)。

Returns
int

getCompoundPaddingLeft

Added in API level 1
int getCompoundPaddingLeft ()

返回视图的左边距,如果有的话,加左边的Drawable空间。

Returns
int

getCompoundPaddingRight

Added in API level 1
int getCompoundPaddingRight ()

返回视图的正确填充,以及右侧Drawable(如果有)的空间。

Returns
int

getCompoundPaddingStart

Added in API level 17
int getCompoundPaddingStart ()

返回视图的开始填充,加上开始Drawable的空间(如果有的话)。

Returns
int

getCompoundPaddingTop

Added in API level 1
int getCompoundPaddingTop ()

返回视图的顶部填充,以及顶部Drawable(如果有)的空间。

Returns
int

getCurrentHintTextColor

Added in API level 1
int getCurrentHintTextColor ()

返回选定的当前颜色以绘制提示文本。

Returns
int Returns the current hint text color.

getCurrentTextColor

Added in API level 1
int getCurrentTextColor ()

返回为普通文本选择的当前颜色。

Returns
int Returns the current text color.

getCustomInsertionActionModeCallback

Added in API level 23
ActionMode.Callback getCustomInsertionActionModeCallback ()

检索setCustomInsertionActionModeCallback(ActionMode.Callback)设置的值。 缺省值为空。

Returns
ActionMode.Callback The current custom insertion callback.

getCustomSelectionActionModeCallback

Added in API level 11
ActionMode.Callback getCustomSelectionActionModeCallback ()

检索setCustomSelectionActionModeCallback(ActionMode.Callback)设置的值。 缺省值为空。

Returns
ActionMode.Callback The current custom selection callback.

getEditableText

Added in API level 3
Editable getEditableText ()

返回TextView作为可编辑对象显示的文本。 如果文本不可编辑,则返回null。

Returns
Editable

也可以看看:

getEllipsize

Added in API level 1
TextUtils.TruncateAt getEllipsize ()

返回哪里,如果任何地方,长度比视图宽的单词应该被省略。

Returns
TextUtils.TruncateAt

getError

Added in API level 1
CharSequence getError ()

如果没有设置错误,或者在用户输入后错误被小部件清除,则返回设置为与 setError(CharSequence)null一起显示的错误消息。

Returns
CharSequence

getExtendedPaddingBottom

Added in API level 1
int getExtendedPaddingBottom ()

返回视图的扩展底部填充,包括底部Drawable(如果有的话)和任何额外空间以保持超过maxLines的文本显示。 测量完成后才能调用。

Returns
int

getExtendedPaddingTop

Added in API level 1
int getExtendedPaddingTop ()

返回视图的扩展顶部填充,包括顶部Drawable(如果有的话)以及任何额外空间以保持超过maxLines的文本显示。 测量完成后才能调用。

Returns
int

getFilters

Added in API level 1
InputFilter[] getFilters ()

返回输入过滤器的当前列表。

相关XML属性:

Returns
InputFilter[]

getFocusedRect

Added in API level 1
void getFocusedRect (Rect r)

当视图具有焦点并且用户离开它时,从该方法填充的矩形开始搜索下一个视图。 默认情况下,矩形是视图的getDrawingRect(android.graphics.Rect) )。 但是,如果您的视图保留了内部选择的一些想法,例如游标或选定的行或列,则应该重写此方法并填入更具体的矩形。

Parameters
r Rect: The rectangle to fill in, in this view's coordinates.

getFontFeatureSettings

Added in API level 21
String getFontFeatureSettings ()

返回字体功能设置。 格式与CSS font-feature-settings属性相同: http://dev.w3.org/csswg/css-fonts/#propdef-font-feature-settings

Returns
String the currently set font feature settings. Default is null.

也可以看看:

getFreezesText

Added in API level 1
boolean getFreezesText ()

返回此文本视图是否将其整个文本内容包含在冻结冰柱中。 对于EditText它总是返回true。

Returns
boolean Returns true if text is included, false if it isn't.

也可以看看:

getGravity

Added in API level 1
int getGravity ()

返回此TextView的水平和垂直对齐。

相关XML属性:

Returns
int

也可以看看:

getHighlightColor

Added in API level 16
int getHighlightColor ()

相关XML属性:

Returns
int the color used to display the selection highlight

也可以看看:

getHint

Added in API level 1
CharSequence getHint ()

返回当TextView的文本为空时显示的提示。

相关XML属性:

Returns
CharSequence

getHintTextColors

Added in API level 1
ColorStateList getHintTextColors ()

相关XML属性:

Returns
ColorStateList the color of the hint text, for the different states of this TextView.

也可以看看:

getHyphenationFrequency

Added in API level 23
int getHyphenationFrequency ()

相关XML属性:

Returns
int the currently set hyphenation frequency.

也可以看看:

getImeActionId

Added in API level 3
int getImeActionId ()

获取IME动作ID,先前设置为 setImeActionLabel(CharSequence, int)

Returns
int

也可以看看:

getImeActionLabel

Added in API level 3
CharSequence getImeActionLabel ()

获取IME操作标签,上一个设置为 setImeActionLabel(CharSequence, int)

Returns
CharSequence

也可以看看:

getImeHintLocales

Added in API level 24
LocaleList getImeHintLocales ()

Returns
LocaleList The current languages list "hint". null when no "hint" is available.

也可以看看:

getImeOptions

Added in API level 3
int getImeOptions ()

获取IME编辑器的类型。

Returns
int

也可以看看:

getIncludeFontPadding

Added in API level 16
boolean getIncludeFontPadding ()

获取TextView是否包含额外的顶部和底部填充以为高于正常上升和下降的口音腾出空间。

相关XML属性:

Returns
boolean

也可以看看:

getInputExtras

Added in API level 3
Bundle getInputExtras (boolean create)

检索当前与文本视图关联的输入附加内容,可以查看和修改文本视图。

相关XML属性:

Parameters
create boolean: If true, the extras will be created if they don't already exist. Otherwise, null will be returned if none have been created.
Returns
Bundle

也可以看看:

getInputType

Added in API level 3
int getInputType ()

获取可编辑内容的类型。

Returns
int

也可以看看:

getKeyListener

Added in API level 1
KeyListener getKeyListener ()

相关XML属性:

Returns
KeyListener the current key listener for this TextView. This will frequently be null for non-EditText TextViews.

getLayout

Added in API level 1
Layout getLayout ()

Returns
Layout the Layout that is currently being used to display the text. This can be null if the text or width has recently changes.

getLetterSpacing

Added in API level 21
float getLetterSpacing ()

Returns
float the extent by which text is currently being letter-spaced. This will normally be 0.

也可以看看:

getLineBounds

Added in API level 1
int getLineBounds (int line, 
                Rect bounds)

返回指定行的基线(0 ... getLineCount() - 1)如果bounds不为null,则返回指定行的顶部,左侧,右侧,底部范围。 如果尚未构建内部布局,则返回0并将边界设置为(0,0,0,0)

Parameters
line int: which line to examine (0..getLineCount() - 1)
bounds Rect: Optional. If not null, it returns the extent of the line
Returns
int the Y-coordinate of the baseline

getLineCount

Added in API level 1
int getLineCount ()

返回文本的行数,如果尚未构建内部布局,则返回0。

Returns
int

getLineHeight

Added in API level 1
int getLineHeight ()

Returns
int the height of one standard line in pixels. Note that markup within the text can cause individual lines to be taller or shorter than this height, and the layout may contain additional first- or last-line padding.

getLineSpacingExtra

Added in API level 16
float getLineSpacingExtra ()

获取行间距额外的空间

相关XML属性:

Returns
float the extra space that is added to the height of each lines of this TextView.

也可以看看:

getLineSpacingMultiplier

Added in API level 16
float getLineSpacingMultiplier ()

获取行距乘数

相关XML属性:

Returns
float the value by which each line's height is multiplied to get its actual height.

也可以看看:

getLinkTextColors

Added in API level 1
ColorStateList getLinkTextColors ()

相关XML属性:

Returns
ColorStateList the list of colors used to paint the links in the text, for the different states of this TextView

也可以看看:

getLinksClickable

Added in API level 1
boolean getLinksClickable ()

返回是否运动方法将被自动设置为LinkMovementMethod如果setAutoLinkMask(int)已被设置为非零和检测环节setText(char[], int, int) 默认值是true。

相关XML属性:

Returns
boolean

getMarqueeRepeatLimit

Added in API level 16
int getMarqueeRepeatLimit ()

获取选取框动画重复的次数。 只有在TextView启用了选取框的情况下才有意义。

相关XML属性:

Returns
int the number of times the marquee animation is repeated. -1 if the animation repeats indefinitely

也可以看看:

getMaxEms

Added in API level 16
int getMaxEms ()

相关XML属性:

Returns
int the maximum width of the TextView, expressed in ems or -1 if the maximum width was set in pixels instead (using setMaxWidth(int) or setWidth(int)).

也可以看看:

getMaxHeight

Added in API level 16
int getMaxHeight ()

相关XML属性:

Returns
int the maximum height of this TextView expressed in pixels, or -1 if the maximum height was set in number of lines instead using or #setLines(int).

也可以看看:

getMaxLines

Added in API level 16
int getMaxLines ()

相关XML属性:

Returns
int the maximum number of lines displayed in this TextView, or -1 if the maximum height was set in pixels instead using or #setHeight(int).

也可以看看:

getMaxWidth

Added in API level 16
int getMaxWidth ()

相关XML属性:

Returns
int the maximum width of the TextView, in pixels or -1 if the maximum width was set in ems instead (using setMaxEms(int) or setEms(int)).

也可以看看:

getMinEms

Added in API level 16
int getMinEms ()

相关XML属性:

Returns
int the minimum width of the TextView, expressed in ems or -1 if the minimum width was set in pixels instead (using setMinWidth(int) or setWidth(int)).

也可以看看:

getMinHeight

Added in API level 16
int getMinHeight ()

相关XML属性:

Returns
int the minimum height of this TextView expressed in pixels, or -1 if the minimum height was set in number of lines instead using or #setLines(int).

也可以看看:

getMinLines

Added in API level 16
int getMinLines ()

相关XML属性:

Returns
int the minimum number of lines displayed in this TextView, or -1 if the minimum height was set in pixels instead using or #setHeight(int).

也可以看看:

getMinWidth

Added in API level 16
int getMinWidth ()

相关XML属性:

Returns
int the minimum width of the TextView, in pixels or -1 if the minimum width was set in ems instead (using setMinEms(int) or setEms(int)).

也可以看看:

getMovementMethod

Added in API level 1
MovementMethod getMovementMethod ()

Returns
MovementMethod the movement method being used for this TextView. This will frequently be null for non-EditText TextViews.

getOffsetForPosition

Added in API level 14
int getOffsetForPosition (float x, 
                float y)

获取最接近指定绝对位置的字符偏移量。 一个典型的用例是将getX()getY()的结果传递给此方法。

Parameters
x float: The horizontal absolute position of a point on screen
y float: The vertical absolute position of a point on screen
Returns
int the character offset for the character whose position is closest to the specified position. Returns -1 if there is no layout.

getPaint

Added in API level 1
TextPaint getPaint ()

Returns
TextPaint the base paint used for the text. Please use this only to consult the Paint's properties and not to change them.

getPaintFlags

Added in API level 1
int getPaintFlags ()

Returns
int the flags on the Paint being used to display the text.

也可以看看:

getPrivateImeOptions

Added in API level 3
String getPrivateImeOptions ()

获取内容的私人类型。

Returns
String

也可以看看:

getSelectionEnd

Added in API level 1
int getSelectionEnd ()

方便 getSelectionEnd(CharSequence)

Returns
int

getSelectionStart

Added in API level 1
int getSelectionStart ()

方便 getSelectionStart(CharSequence)

Returns
int

getShadowColor

Added in API level 16
int getShadowColor ()

相关XML属性:

Returns
int the color of the shadow layer

也可以看看:

getShadowDx

Added in API level 16
float getShadowDx ()

相关XML属性:

Returns
float the horizontal offset of the shadow layer

也可以看看:

getShadowDy

Added in API level 16
float getShadowDy ()

相关XML属性:

Returns
float the vertical offset of the shadow layer

也可以看看:

getShadowRadius

Added in API level 16
float getShadowRadius ()

获取阴影图层的半径。

相关XML属性:

Returns
float the radius of the shadow layer. If 0, the shadow layer is not visible

也可以看看:

getShowSoftInputOnFocus

Added in API level 21
boolean getShowSoftInputOnFocus ()

返回当此TextView聚焦时是否使软输入方法可见。 默认值是true。

Returns
boolean

getText

Added in API level 1
CharSequence getText ()

返回TextView显示的文本。 如果使用参数BufferType.SPANNABLE或BufferType.EDITABLE调用setText(),则可以分别将此方法的返回值转换为Spannable或Editable。 注意:不应修改返回值的内容。 如果你想要一个可修改的,你应该先制作自己的拷贝。

相关XML属性:

Returns
CharSequence

getTextColors

Added in API level 1
ColorStateList getTextColors ()

获取TextView的不同状态(正常,选定,聚焦)的文本颜色。

相关XML属性:

Returns
ColorStateList

也可以看看:

getTextLocale

Added in API level 17
Locale getTextLocale ()

获取此TextView中文本的默认主要Locale 这将始终是getTextLocales()的第一个成员。

Returns
Locale the default primary Locale of the text in this TextView.

getTextLocales

Added in API level 24
LocaleList getTextLocales ()

获取此TextView中文本的默认值 LocaleList

Returns
LocaleList the default LocaleList of the text in this TextView.

getTextScaleX

Added in API level 1
float getTextScaleX ()

Returns
float the extent by which text is currently being stretched horizontally. This will usually be 1.

getTextSize

Added in API level 1
float getTextSize ()

Returns
float the size (in pixels) of the default text size in this TextView.

getTotalPaddingBottom

Added in API level 1
int getTotalPaddingBottom ()

返回视图的总底部填充,包括底部Drawable(如果有),保留超过maxLines的额外空间以及重力的垂直偏移(如果有)。

Returns
int

getTotalPaddingEnd

Added in API level 17
int getTotalPaddingEnd ()

返回视图的总结束填充,包括结束Drawable(如果有的话)。

Returns
int

getTotalPaddingLeft

Added in API level 1
int getTotalPaddingLeft ()

返回视图的左侧填充,包括左侧的Drawable(如果有)。

Returns
int

getTotalPaddingRight

Added in API level 1
int getTotalPaddingRight ()

返回视图的总权限填充,包括右侧的Drawable(如果有)。

Returns
int

getTotalPaddingStart

Added in API level 17
int getTotalPaddingStart ()

返回视图的总开始填充,包括开始Drawable(如果有的话)。

Returns
int

getTotalPaddingTop

Added in API level 1
int getTotalPaddingTop ()

返回视图的总顶部填充,包括顶部Drawable(如果有),保留超过maxLines的额外空间以及重力的垂直偏移(如果有)。

Returns
int

getTransformationMethod

Added in API level 1
TransformationMethod getTransformationMethod ()

相关XML属性:

Returns
TransformationMethod the current transformation method for this TextView. This will frequently be null except for single-line and password fields.

getTypeface

Added in API level 1
Typeface getTypeface ()

相关XML属性:

Returns
Typeface the current typeface and style in which the text is being displayed.

也可以看看:

getUrls

Added in API level 1
URLSpan[] getUrls ()

返回附加到文本的URLSpans列表(由Linkify或其他)(如果有的话)。 您可以拨打getURL()来查找他们链接的位置,或使用getSpanStart(Object)getSpanEnd(Object)查找他们所连接文本的区域。

Returns
URLSpan[]

hasOverlappingRendering

Added in API level 16
boolean hasOverlappingRendering ()

返回此视图是否包含重叠的内容。

打算被特定视图类型覆盖的此函数是在视图上设置alpha时的优化。 如果渲染在alpha <1的视图中重叠,则该视图将被拖到屏幕外的缓冲区,然后合成到位,这可能很昂贵。 如果视图没有重叠的渲染,视图可以直接用适当的alpha值绘制每个基元。 重叠渲染的一个例子是带有背景图像的TextView,例如Button。 非重叠渲染的一个例子是没有背景的TextView或只有前景图像的ImageView。 默认实现返回true; 如果子类有可以优化的情况,子类应该重写。

当前实现在saveLayer和saveLayerAlpha方法 Canvas必要,一个视图,如果它使用的方法在内部,而没有经过返回true CLIP_TO_LAYER_SAVE_FLAG

注意:如果在此视图上调用 forceHasOverlappingRendering(boolean)则会忽略此方法的返回值。

Returns
boolean true if the content in this view might overlap, false otherwise.

hasSelection

Added in API level 1
boolean hasSelection ()

如果在此文本视图中有选择,则返回true。

Returns
boolean

invalidateDrawable

Added in API level 1
void invalidateDrawable (Drawable drawable)

使指定的Drawable无效。

Parameters
drawable Drawable: the drawable to invalidate

isCursorVisible

Added in API level 16
boolean isCursorVisible ()

相关XML属性:

Returns
boolean whether or not the cursor is visible (assuming this TextView is editable)

也可以看看:

isInputMethodTarget

Added in API level 3
boolean isInputMethodTarget ()

返回此文本视图是否是当前输入方法目标。 默认的实现只是用InputMethodManager进行检查。

Returns
boolean

isSuggestionsEnabled

Added in API level 14
boolean isSuggestionsEnabled ()

返回在此TextView上是否启用建议。 这些建议由用户键入时由IME或拼写检查程序生成。 这通过将SuggestionSpan添加到文本来完成。 当启用建议(默认)时,当用户在文本的这些部分请求提示时,将显示该建议列表。 该值取决于此TextView的inputType。 输入类型的类必须是TYPE_CLASS_TEXT 此外,该类型的变动都必须之一TYPE_TEXT_VARIATION_NORMALTYPE_TEXT_VARIATION_EMAIL_SUBJECTTYPE_TEXT_VARIATION_LONG_MESSAGETYPE_TEXT_VARIATION_SHORT_MESSAGETYPE_TEXT_VARIATION_WEB_EDIT_TEXT 最后, 不得设置TYPE_TEXT_FLAG_NO_SUGGESTIONS标志。

Returns
boolean true if the suggestions popup window is enabled, based on the inputType.

isTextSelectable

Added in API level 11
boolean isTextSelectable ()

返回textIsSelectable标志的状态(请参阅setTextIsSelectable() )。 虽然必须设置此标志以允许用户选择和复制不可编辑的TextView中的文本,但始终可以选择EditText的内容,而与此标志的值无关。

相关XML属性:

Returns
boolean True if the text displayed in this TextView can be selected by the user.

jumpDrawablesToCurrentState

Added in API level 11
void jumpDrawablesToCurrentState ()

在与此视图关联的所有可绘制对象上调用 Drawable.jumpToCurrentState()

如果有一个StateListAnimator附加到这个视图,也调用 jumpToCurrentState()

length

Added in API level 1
int length ()

返回由此TextView管理的文本的长度(以字符为单位)

Returns
int

moveCursorToVisibleOffset

Added in API level 3
boolean moveCursorToVisibleOffset ()

如果需要,移动光标,使其位于用户可见的偏移位置。 如果它代表多个字符(选择范围),则不会移动光标。 这只有在TextView包含可扩展文本时才有效; 否则它将无能为力。

Returns
boolean True if the cursor was actually moved, false otherwise.

onBeginBatchEdit

Added in API level 3
void onBeginBatchEdit ()

由框架调用以响应通过调用链接 beginBatchEdit()开始一批编辑操作的请求。

onCheckIsTextEditor

Added in API level 3
boolean onCheckIsTextEditor ()

检查被调用的视图是否是文本编辑器,在这种情况下,为其自动显示软输入窗口是有意义的。 如果在该方法上的调用将返回非null的InputConnection时它们实现onCreateInputConnection(EditorInfo)将返回true,并且它们实际上是第一级编辑器,用户在进入包含您的窗口的窗口时通常会开始输入视图。

默认实现总是返回false。 并不意味着其onCreateInputConnection(EditorInfo)不会被调用或用户不能以其他方式执行对你的看法的编辑; 这只是对系统的暗示,这不是这个观点的主要目的。

Returns
boolean Returns true if this view is a text editor, else false.

onCommitCompletion

Added in API level 3
void onCommitCompletion (CompletionInfo text)

由框架调用以响应当前输入方法的文本完成,由它提供,调用InputConnection.commitCompletion() 默认实现什么也不做; 支持自动完成的文本视图应该重写此操作以执行其所需的行为。

Parameters
text CompletionInfo: The auto complete text the user has selected.

onCommitCorrection

Added in API level 11
void onCommitCorrection (CorrectionInfo info)

由框架调用以响应文本自动更正(例如,使用一个字典修复打字错误),由当前输入方法调用,由它提供,调用commitCorrection(CorrectionInfo) InputConnection.commitCorrection()}。 默认实现闪烁纠正词的背景以向用户提供反馈。

Parameters
info CorrectionInfo: The auto correct info about the text that was corrected.

onCreateInputConnection

Added in API level 3
InputConnection onCreateInputConnection (EditorInfo outAttrs)

为InputMethod创建一个新的InputConnection以与视图交互。 默认实现返回null,因为它不支持输入方法。 你可以重写这个来实现这种支持。 这只是需要重点和文字输入的视图才需要。

在实现这个时,你可能也想实现 onCheckIsTextEditor()来表示你将返回一个非null的InputConnection。

另外,请妥善地正确填写EditorInfo对象,以便连接的IME可以依赖其值。 例如,必须使用正确的光标位置填写initialSelStartinitialSelEnd成员,以使IME正确地与您的应用程序配合使用。

Parameters
outAttrs EditorInfo: Fill in with attribute information about the connection.
Returns
InputConnection

onDragEvent

Added in API level 11
boolean onDragEvent (DragEvent event)

在调用 startDragAndDrop()处理由系统发送的拖动事件。

当系统调用这个方法时,它传递一个DragEvent对象。 getAction()的调用将返回DragEvent中定义的操作类型常量之一。 该方法使用这些来确定拖放操作中发生了什么。

Parameters
event DragEvent: The DragEvent sent by the system. The getAction() method returns an action type constant defined in DragEvent, indicating the type of drag event represented by this object.
Returns
boolean true if the method was successful, otherwise false.

该方法应该返回 true响应的动作类型 ACTION_DRAG_STARTED接收拖动事件当前操作。

该方法还应该返回 true响应的动作类型 ACTION_DROP ,如果它消耗的下降,或者 false ,如果它没有。

onEditorAction

Added in API level 3
void onEditorAction (int actionCode)

当附加的输入方法调用InputConnection.performEditorAction()用于此文本视图时调用。 默认实现将调用Action监听供给setOnEditorActionListener(TextView.OnEditorActionListener) ,或执行标准操作EditorInfo.IME_ACTION_NEXTEditorInfo.IME_ACTION_PREVIOUS ,或EditorInfo.IME_ACTION_DONE

为了向后兼容,如果没有设置IME选项并且文本视图通常不会将注意力集中在输入上,则此处接收到的NEXT和DONE操作将变成输入键向下/向上对,以通过正常密钥处理。

Parameters
actionCode int: The code of the action being performed.

也可以看看:

onEndBatchEdit

Added in API level 3
void onEndBatchEdit ()

由框架调用以响应通过调用链接 endBatchEdit()来结束一批编辑操作的请求。

onGenericMotionEvent

Added in API level 12
boolean onGenericMotionEvent (MotionEvent event)

实现此方法来处理通用运动事件。

通用运动事件描述操纵杆运动,鼠标悬停,触控板触摸,滚轮运动和其他输入事件。 运动事件的source指定了接收的输入类别。 此方法的实现必须在处理事件之前检查源中的位。 以下代码示例显示了这是如何完成的。

源类SOURCE_CLASS_POINTER通用运动事件传递到指针下的视图。 所有其他通用运动事件都会传送到重点视图。

 public boolean onGenericMotionEvent(MotionEvent event) {
     if (event.isFromSource(InputDevice.SOURCE_CLASS_JOYSTICK)) {
         if (event.getAction() == MotionEvent.ACTION_MOVE) {
             // process the joystick movement...
             return true;
         }
     }
     if (event.isFromSource(InputDevice.SOURCE_CLASS_POINTER)) {
         switch (event.getAction()) {
             case MotionEvent.ACTION_HOVER_MOVE:
                 // process the mouse hover movement...
                 return true;
             case MotionEvent.ACTION_SCROLL:
                 // process the scroll wheel movement...
                 return true;
         }
     }
     return super.onGenericMotionEvent(event);
 }

Parameters
event MotionEvent: The generic motion event being processed.
Returns
boolean True if the event was handled, false otherwise.

onKeyDown

Added in API level 1
boolean onKeyDown (int keyCode, 
                KeyEvent event)

KeyEvent.Callback.onKeyDown()默认实现:在 KEYCODE_DPAD_CENTERKEYCODE_ENTER被释放时执行按下视图,如果视图已启用并且可点击。

软件键盘中的按键通常不会触发这个监听器,尽管在某些情况下有些人会选择这样做。 不要依靠这个来捕捉软件按键。

Parameters
keyCode int: a key code that represents the button pressed, from KeyEvent
event KeyEvent: the KeyEvent object that defines the button action
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyMultiple

Added in API level 1
boolean onKeyMultiple (int keyCode, 
                int repeatCount, 
                KeyEvent event)

默认实现 KeyEvent.Callback.onKeyMultiple() :始终返回false(不处理事件)。

软件键盘中的按键通常不会触发这个监听器,尽管在某些情况下有些人会选择这样做。 不要依靠这个来捕捉软件按键。

Parameters
keyCode int: A key code that represents the button pressed, from KeyEvent.
repeatCount int: The number of times the action was made.
event KeyEvent: The KeyEvent object that defines the button action.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyPreIme

Added in API level 3
boolean onKeyPreIme (int keyCode, 
                KeyEvent event)

在关键事件由与视图层次关联的任何输入方法处理之前处理。 这可以用于在IME消耗它们之前在特殊情况下截获关键事件; 一个典型的例子是处理BACK键来更新应用程序的UI,而不是让IME看到它并关闭它自己。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyShortcut

Added in API level 1
boolean onKeyShortcut (int keyCode, 
                KeyEvent event)

在未处理按键快捷方式事件时调用聚焦视图。 重写此方法以实现View的本地键快捷方式。 快捷键也可以通过设置菜单项的shortcut属性来实现。

Parameters
keyCode int: The value in event.getKeyCode().
event KeyEvent: Description of the key event.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onKeyUp

Added in API level 1
boolean onKeyUp (int keyCode, 
                KeyEvent event)

的默认实现 KeyEvent.Callback.onKeyUp() :当视图进行点击 KEYCODE_DPAD_CENTERKEYCODE_ENTER或者 KEYCODE_SPACE被释放。

软件键盘中的按键通常不会触发这个监听器,尽管在某些情况下有些人会选择这样做。 不要依靠这个来捕捉软件按键。

Parameters
keyCode int: A key code that represents the button pressed, from KeyEvent.
event KeyEvent: The KeyEvent object that defines the button action.
Returns
boolean If you handled the event, return true. If you want to allow the event to be handled by the next receiver, return false.

onPreDraw

Added in API level 1
boolean onPreDraw ()

将在将要绘制视图树时调用回调方法。 此时,树中的所有视图都被测量并给出一帧。 客户可以使用它来调整它们的滚动范围,甚至可以在绘图之前请求新的布局。

Returns
boolean Return true to proceed with the current drawing pass, or false to cancel.

onPrivateIMECommand

Added in API level 3
boolean onPrivateIMECommand (String action, 
                Bundle data)

由框架调用以响应来自当前方法的私有命令,由它提供,调用 InputConnection.performPrivateCommand()

Parameters
action String: The action name of the command.
data Bundle: Any additional data for the command. This may be null.
Returns
boolean Return true if you handled the command, else false.

onProvideStructure

Added in API level 23
void onProvideStructure (ViewStructure structure)

作为 Activity.onProvideAssistData一部分从视图中检索辅助结构时调用。

Parameters
structure ViewStructure: Fill in with structured view data. The default implementation fills in all data that can be inferred from the view itself.

onResolvePointerIcon

Added in API level 24
PointerIcon onResolvePointerIcon (MotionEvent event, 
                int pointerIndex)

返回运动事件的指针图标;如果未指定图标,则返回null。 默认实现不关心位置或事件类型,但某些子类可能会使用它(如WebViews)。

Parameters
event MotionEvent: The MotionEvent from a mouse
pointerIndex int: The index of the pointer for which to retrieve the PointerIcon. This will be between 0 and getPointerCount().
Returns
PointerIcon

onRestoreInstanceState

Added in API level 1
void onRestoreInstanceState (Parcelable state)

吊钩允许视图重新应用先前由onSaveInstanceState()生成的内部状态的表示。 这个函数永远不会被调用为null状态。

Parameters
state Parcelable: The frozen state that had previously been returned by onSaveInstanceState().

onRtlPropertiesChanged

Added in API level 17
void onRtlPropertiesChanged (int layoutDirection)

当任何RTL属性(布局方向或文本方向或文本对齐)已被更改时调用。 子类需要重写此方法以处理依赖于已解析布局方向的缓存信息,或通知继承其布局方向的子视图。 默认实现什么都不做。

Parameters
layoutDirection int: the direction of the layout

onSaveInstanceState

Added in API level 1
Parcelable onSaveInstanceState ()

钩子允许视图生成其内部状态的表示,稍后可用于创建具有相同状态的新实例。 此状态应仅包含不持久或以后不能重建的信息。 例如,您永远不会将当前位置存储在屏幕上,因为当视图的新实例放置在其视图层次结构中时会再次计算该位置。

您可能在此处存储的某些示例:文本视图中的当前光标位置(但通常不是文本本身,因为它存储在内容提供程序或其他永久性存储中),即当前在列表视图中选择的项目。

Returns
Parcelable Returns a Parcelable object containing the view's current dynamic state, or null if there is nothing interesting to save. The default implementation returns null.

onScreenStateChanged

Added in API level 16
void onScreenStateChanged (int screenState)

只要此视图的屏幕状态附加到更改,就会调用此方法。 状态变化通常会在屏幕打开或关闭时发生(无论是自动发生还是由用户手动完成)。

Parameters
screenState int: The new state of the screen. Can be either SCREEN_STATE_ON or SCREEN_STATE_OFF

onTextContextMenuItem

Added in API level 3
boolean onTextContextMenuItem (int id)

当选择文本视图的上下文菜单选项时调用。 目前,这将是一个selectAllcutcopypaste或者shareText

Parameters
id int
Returns
boolean true if the context menu item action was performed.

onTouchEvent

Added in API level 1
boolean onTouchEvent (MotionEvent event)

实现此方法来处理触摸屏幕动作事件。

如果此方法用于检测点击操作,建议通过实施并调用performClick()来执行操作。 这将确保一致的系统行为,包括:

  • obeying click sound preferences
  • dispatching OnClickListener calls
  • handling ACTION_CLICK when accessibility features are enabled

Parameters
event MotionEvent: The motion event.
Returns
boolean True if the event was handled, false otherwise.

onTrackballEvent

Added in API level 1
boolean onTrackballEvent (MotionEvent event)

实现这个方法来处理轨迹球运动事件。 自上次事件以来,轨迹球的相对移动可以通过MotionEvent.getX()MotionEvent.getY()进行检索。 这些都是标准化的,因此移动1对应于用户按下一个DPAD键(所以它们通常是小数值,表示轨迹球中可用的更细粒度的移动信息)。

Parameters
event MotionEvent: The motion event.
Returns
boolean True if the event was handled, false otherwise.

onWindowFocusChanged

Added in API level 1
void onWindowFocusChanged (boolean hasWindowFocus)

当包含此视图的窗口获得或失去焦点时调用。 请注意,这与视图焦点不同:要接收关键事件,视图和其窗口都必须具有焦点。 如果一个窗口显示在需要输入焦点的窗口上,那么您自己的窗口将失去焦点,但视图焦点将保持不变。

Parameters
hasWindowFocus boolean: True if the window containing this view now has focus, false otherwise.

performLongClick

Added in API level 1
boolean performLongClick ()

调用此视图的OnLongClickListener(如果已定义)。 如果OnLongClickListener没有使用该事件,则调用上下文菜单。

Returns
boolean true if one of the above receivers consumed the event, false otherwise

removeTextChangedListener

Added in API level 1
void removeTextChangedListener (TextWatcher watcher)

从TextView的文本更改时调用其方法的列表中删除指定的TextWatcher。

Parameters
watcher TextWatcher

setAllCaps

Added in API level 14
void setAllCaps (boolean allCaps)

设置此字段的属性以将输入转换为ALL CAPS显示。 这可能会使用“小型大写”格式(如果可用)。 如果此字段可编辑或可选,此设置将被忽略。 这个调用取代了当前的转换方法。 禁用此功能不一定会恢复之前的行为。

相关XML属性:

Parameters
allCaps boolean

也可以看看:

setAutoLinkMask

Added in API level 1
void setAutoLinkMask (int mask)

设置文本的自动链接掩码。 请参阅Linkify.ALL和同行以了解可能的值。

相关XML属性:

Parameters
mask int

setBreakStrategy

Added in API level 23
void setBreakStrategy (int breakStrategy)

设置将段落分段为行的中断策略。 为TextView的默认值是BREAK_STRATEGY_HIGH_QUALITY ,和EditText上的默认值是BREAK_STRATEGY_SIMPLE ,后者以避免文本“跳舞”正在编辑的时候。

相关XML属性:

Parameters
breakStrategy int

也可以看看:

setCompoundDrawablePadding

Added in API level 1
void setCompoundDrawablePadding (int pad)

设置复合绘图和文本之间的填充大小。

相关XML属性:

Parameters
pad int

setCompoundDrawableTintList

Added in API level 23
void setCompoundDrawableTintList (ColorStateList tint)

为复合绘图应用色调。 不会修改当前着色模式,默认为SRC_IN

setCompoundDrawables(Drawable, Drawable, Drawable, Drawable)和相关方法的后续调用将自动改变drawable,并使用 setTintList(ColorStateList)应用指定的色调和色调模式。

相关XML属性:

Parameters
tint ColorStateList: the tint to apply, may be null to clear tint

也可以看看:

setCompoundDrawableTintMode

Added in API level 23
void setCompoundDrawableTintMode (PorterDuff.Mode tintMode)

指定用于将setCompoundDrawableTintList(ColorStateList)指定的色调应用于复合绘图的混合模式。 默认模式是SRC_IN

相关XML属性:

Parameters
tintMode PorterDuff.Mode: the blending mode used to apply the tint, may be null to clear tint

也可以看看:

setCompoundDrawables

Added in API level 1
void setCompoundDrawables (Drawable left, 
                Drawable top, 
                Drawable right, 
                Drawable bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。 如果您不想在此处绘制Drawable,请使用null Drawables必须已经调用了setBounds(Rect)

调用此方法将覆盖先前使用 setCompoundDrawablesRelative(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
left Drawable
top Drawable
right Drawable
bottom Drawable

setCompoundDrawablesRelative

Added in API level 17
void setCompoundDrawablesRelative (Drawable start, 
                Drawable top, 
                Drawable end, 
                Drawable bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。 如果您不想在此处绘制Drawable,请使用null Drawables必须已经调用了setBounds(Rect)

调用此方法将覆盖先前使用 setCompoundDrawables(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
start Drawable
top Drawable
end Drawable
bottom Drawable

setCompoundDrawablesRelativeWithIntrinsicBounds

Added in API level 17
void setCompoundDrawablesRelativeWithIntrinsicBounds (Drawable start, 
                Drawable top, 
                Drawable end, 
                Drawable bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。 如果您不想在此处绘制Drawable,请使用null Drawables的边界将被设置为它们的内在边界。

调用此方法将覆盖先前使用 setCompoundDrawables(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
start Drawable
top Drawable
end Drawable
bottom Drawable

setCompoundDrawablesRelativeWithIntrinsicBounds

Added in API level 17
void setCompoundDrawablesRelativeWithIntrinsicBounds (int start, 
                int top, 
                int end, 
                int bottom)

设置Drawable(如果有的话)出现在文本的开头,上方,结尾和下方。 如果您不想在此处绘制Drawable,请使用0。 Drawables的边界将被设置为它们的内在边界。

调用此方法将覆盖先前使用 setCompoundDrawables(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
start int: Resource identifier of the start Drawable.
top int: Resource identifier of the top Drawable.
end int: Resource identifier of the end Drawable.
bottom int: Resource identifier of the bottom Drawable.

setCompoundDrawablesWithIntrinsicBounds

Added in API level 1
void setCompoundDrawablesWithIntrinsicBounds (Drawable left, 
                Drawable top, 
                Drawable right, 
                Drawable bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。 如果您不想在此处绘制Drawable,请使用null Drawables的边界将被设置为它们的内在边界。

调用此方法将覆盖先前使用 setCompoundDrawablesRelative(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
left Drawable
top Drawable
right Drawable
bottom Drawable

setCompoundDrawablesWithIntrinsicBounds

Added in API level 3
void setCompoundDrawablesWithIntrinsicBounds (int left, 
                int top, 
                int right, 
                int bottom)

设置Drawable(如果有)显示在文本的左侧,上方,右侧和下方。 如果您不想在此处绘制Drawable,请使用0。 Drawables的边界将被设置为它们的内在边界。

调用此方法将覆盖先前使用 setCompoundDrawablesRelative(Drawable, Drawable, Drawable, Drawable)或相关方法设置的任何Drawables。

相关XML属性:

Parameters
left int: Resource identifier of the left Drawable.
top int: Resource identifier of the top Drawable.
right int: Resource identifier of the right Drawable.
bottom int: Resource identifier of the bottom Drawable.

setCursorVisible

Added in API level 1
void setCursorVisible (boolean visible)

设置光标是否可见。 默认值是true。 请注意,此属性仅适用于可编辑的TextView。

相关XML属性:

Parameters
visible boolean

也可以看看:

setCustomInsertionActionModeCallback

Added in API level 23
void setCustomInsertionActionModeCallback (ActionMode.Callback actionModeCallback)

如果提供,则在此视图中启动文本插入时,将使用此ActionMode.Callback创建ActionMode。 标准实现使用Select All,Paste和Replace操作的子集填充菜单,具体取决于此View支持的内容。

自定义实现可以在其onPrepareActionMode(android.view.ActionMode, android.view.Menu)方法的默认菜单中添加新条目。 默认动作也可以从菜单中使用除去removeItem(int)和传球selectAllpastereplaceText ID作为参数。

onCreateActionMode(android.view.ActionMode, android.view.Menu)返回错误将会阻止启动操作模式。

操作点击事件应该由自定义实现 onActionItemClicked(android.view.ActionMode, android.view.MenuItem)

请注意,当TextView收到焦点并且已设置 selectAllOnFocus标志时,文本插入模式不会启动。

Parameters
actionModeCallback ActionMode.Callback

setCustomSelectionActionModeCallback

Added in API level 11
void setCustomSelectionActionModeCallback (ActionMode.Callback actionModeCallback)

如果提供,则在此视图中启动文本选择时,将使用此ActionMode.Callback来创建ActionMode。

标准实现使用Select All,Cut,Copy,Paste,Replace和Share操作的子集来填充菜单,具体取决于此View支持的内容。

自定义实现可以在其onPrepareActionMode(ActionMode, android.view.Menu)方法的默认菜单中添加新条目。 默认动作也可以从菜单中使用除去removeItem(int)和传球selectAllcutcopypastereplaceTextshareText ID作为参数。

onCreateActionMode(ActionMode, android.view.Menu)返回错误将阻止操作模式启动。

操作点击事件应该由自定义实现 onActionItemClicked(ActionMode, android.view.MenuItem)来处理。

请注意,当TextView接收到焦点并且已设置selectAllOnFocus标志时,文本选择模式不会启动。 在这种情况下,内容会突出显示,以便快速更换。

Parameters
actionModeCallback ActionMode.Callback

setEditableFactory

Added in API level 1
void setEditableFactory (Editable.Factory factory)

设置用于创建新可编辑的工厂。

Parameters
factory Editable.Factory

setElegantTextHeight

Added in API level 21
void setElegantTextHeight (boolean elegant)

设置TextView的高雅度量标志。 此设置选择未经过压缩的字体变体以适应基于拉丁的垂直度量标准,并且还会增加顶部和底部边界以提供更多空间。

相关XML属性:

Parameters
elegant boolean: set the paint's elegant metrics flag.

setEllipsize

Added in API level 1
void setEllipsize (TextUtils.TruncateAt where)

使文本中比视图宽度长的文字被省略化,而不是在中间断开。 您可能还想要setSingleLine()setHorizontallyScrolling(boolean)将文本限制为一行。 使用null来关闭椭圆化。 如果setMaxLines(int)已用于设置两行或更多行,则只支持ENDMARQUEE (其他椭圆化类型不会执行任何操作)。

相关XML属性:

Parameters
where TextUtils.TruncateAt

setEms

Added in API level 1
void setEms (int ems)

使TextView完全有这么多ems

相关XML属性:

Parameters
ems int

也可以看看:

setEnabled

Added in API level 1
void setEnabled (boolean enabled)

设置此视图的启用状态。 启用状态的解释因子而异。

Parameters
enabled boolean: True if this view is enabled, false otherwise.

setError

Added in API level 1
void setError (CharSequence error)

将TextView的右侧复合可绘制设置为“错误”图标,并设置当TextView具有焦点时将在弹出窗口中显示的错误消息。 当任何关键事件导致TextView文本更改时,图标和错误消息将被重置为空。 如果errornull ,则会清除错误消息和图标。

Parameters
error CharSequence

setError

Added in API level 1
void setError (CharSequence error, 
                Drawable icon)

将TextView的右侧复合drawable设置为指定的图标,并设置当TextView具有焦点时将在弹出窗口中显示的错误消息。 当任何关键事件导致TextView文本更改时,图标和错误消息将被重置为空。 drawable必须已经设置了setBounds(Rect) 如果errornull ,则错误消息将被清除(并且您还应该提供null图标)。

Parameters
error CharSequence
icon Drawable

setExtractedText

Added in API level 3
void setExtractedText (ExtractedText text)

应用于此文本查看给定的提取文本,如以前由 extractText(ExtractedTextRequest, ExtractedText)返回的 extractText(ExtractedTextRequest, ExtractedText)

Parameters
text ExtractedText

setFilters

Added in API level 1
void setFilters (InputFilter[] filters)

设置缓冲区为可编辑时将使用的输入过滤器列表。 否则无效。

相关XML属性:

Parameters
filters InputFilter

setFontFeatureSettings

Added in API level 21
void setFontFeatureSettings (String fontFeatureSettings)

设置字体功能设置。 格式与CSS font-feature-settings属性相同: http://dev.w3.org/csswg/css-fonts/#propdef-font-feature-settings

相关XML属性:

Parameters
fontFeatureSettings String: font feature settings represented as CSS compatible string

也可以看看:

setFreezesText

Added in API level 1
void setFreezesText (boolean freezesText)

控制此文本视图是否冻结冰柱时保存其全部文本内容,以及动态状态(如光标位置)。 默认情况下,这是错误的,不保存文本。 如果文本视图中的文本未被保存在持久性存储中的其他位置(例如在内容提供者中),则设置为true,以便稍后解冻视图时用户不会丢失其数据。 对于EditText ,无论属性的值如何,始终都会启用它。

相关XML属性:

Parameters
freezesText boolean: Controls whether a frozen icicle should include the entire text data: true to include it, false to not.

setGravity

Added in API level 1
void setGravity (int gravity)

设置文本的水平对齐方式和垂直引力,当TextView中有额外的空间时,将使用超出文本本身所需的空间。

相关XML属性:

Parameters
gravity int

也可以看看:

setHeight

Added in API level 1
void setHeight (int pixels)

使TextView正好有很多像素。 你可以通过在LayoutParams中指定这个数字来做同样的事情。 请注意,设置此值将覆盖任何其他(最小/最大)线数或高度设置。

相关XML属性:

Parameters
pixels int

setHighlightColor

Added in API level 1
void setHighlightColor (int color)

设置用于显示选择高亮显示的颜色。

相关XML属性:

Parameters
color int

setHint

Added in API level 1
void setHint (CharSequence hint)

设置当TextView的文本为空时要显示的文本。 空表示使用正常的空文本。 该提示目前不参与确定视图的大小。

相关XML属性:

Parameters
hint CharSequence

setHint

Added in API level 1
void setHint (int resid)

当TextView的文本为空时,从资源设置要显示的文本。

相关XML属性:

Parameters
resid int

setHintTextColor

Added in API level 1
void setHintTextColor (ColorStateList colors)

设置提示文本的颜色。

相关XML属性:

Parameters
colors ColorStateList

也可以看看:

setHintTextColor

Added in API level 1
void setHintTextColor (int color)

为此TextView的所有状态(禁用,聚焦,选定...)设置提示文本的颜色。

相关XML属性:

Parameters
color int

也可以看看:

setHorizontallyScrolling

Added in API level 1
void setHorizontallyScrolling (boolean whether)

设置是否允许文本比View更宽。 如果为false,它将被封装到视图的宽度。

相关XML属性:

Parameters
whether boolean

setHyphenationFrequency

Added in API level 23
void setHyphenationFrequency (int hyphenationFrequency)

设置连字频率。 从主题设置的TextView和EditText的默认值是HYPHENATION_FREQUENCY_NORMAL

相关XML属性:

Parameters
hyphenationFrequency int

也可以看看:

setImeActionLabel

Added in API level 3
void setImeActionLabel (CharSequence label, 
                int actionId)

更改与文本视图相关联的自定义IME操作,该文本视图具有焦点时将通过 actionLabelactionId向IME报告。

相关XML属性:

Parameters
label CharSequence
actionId int

也可以看看:

setImeHintLocales

Added in API level 24
void setImeHintLocales (LocaleList hintLocales)

更改与文本视图相关联的“提示”语言环境,该文本视图具有焦点时将通过 hintLocales报告给输入法。

注意:如果您希望新的“提示”立即生效,您需要致电 restartInput(View)

Parameters
hintLocales LocaleList: List of the languages that the user is supposed to switch to no matter what input method subtype is currently used. Set null to clear the current "hint".

也可以看看:

setImeOptions

Added in API level 3
void setImeOptions (int imeOptions)

更改与文本视图相关联的编辑器类型整数,该文本视图具有焦点时将用 imeOptions报告给IME。

相关XML属性:

Parameters
imeOptions int

也可以看看:

setIncludeFontPadding

Added in API level 1
void setIncludeFontPadding (boolean includepad)

设置TextView是否包含额外的顶部和底部填充以为高于正常上升和下降的重音腾出空间。 默认值是true。

相关XML属性:

Parameters
includepad boolean

也可以看看:

setInputExtras

Added in API level 3
void setInputExtras (int xmlResId)

设置文本的额外输入数据,即在创建输入连接时将填充的TextBoxAttribute.extras Bundle。 给定的整数是保存<input-extras> XML树的XML资源的资源ID。

相关XML属性:

Parameters
xmlResId int
Throws
XmlPullParserException
IOException

也可以看看:

setInputType

Added in API level 3
void setInputType (int type)

使用为inputType定义的常量设置内容的类型。 这将负责通过调用setKeyListener(KeyListener)来更改关键侦听器来匹配给定的内容类型。 如果给定的内容类型为TYPE_NULL则该文本视图不会显示软键盘。 请注意,如果更改输入类型的TYPE_TEXT_FLAG_MULTI_LINE标志,则显示的最大行数(见setMaxLines(int) )将被修改。

相关XML属性:

Parameters
type int

也可以看看:

setKeyListener

Added in API level 1
void setKeyListener (KeyListener input)

设置要用于此TextView的键监听器。 这可以为空以禁止用户输入。 请注意,此方法与软键盘和其他输入法具有显着且微妙的相互作用:有关重要细节,请参阅KeyListener.getContentType() 调用此方法将用关键字侦听器返回的内容类型替换文本视图的当前内容类型。

需要警告的是,如果您希望TextView中的按键侦听器或移动方法不是可以聚焦的,或者如果您希望没有按键侦听器或移动方法的TextView可以聚焦,您必须在调用此方法后再次调用 setFocusable(boolean)以获得可聚焦性你想要的方式。

相关XML属性:

Parameters
input KeyListener

setLetterSpacing

Added in API level 21
void setLetterSpacing (float letterSpacing)

设置文本字母间距。 值是'EM'单位。 轻微膨胀的典型值约为0.05。 负值可以缩小文字。

相关XML属性:

Parameters
letterSpacing float

也可以看看:

setLineSpacing

Added in API level 1
void setLineSpacing (float add, 
                float mult)

为此TextView设置行间距。 每条线将其高度乘以mult并将add添加到它。

相关XML属性:

Parameters
add float
mult float

setLines

Added in API level 1
void setLines (int lines)

使TextView正好有这么多行。 请注意,设置此值将覆盖任何其他(最小/最大)线数或高度设置。 单行TextView会将此值设置为1。

相关XML属性:

Parameters
lines int

setLinkTextColor

Added in API level 1
void setLinkTextColor (ColorStateList colors)

设置文本中链接的颜色。

相关XML属性:

Parameters
colors ColorStateList

也可以看看:

setLinkTextColor

Added in API level 1
void setLinkTextColor (int color)

设置文本中链接的颜色。

相关XML属性:

Parameters
color int

也可以看看:

setLinksClickable

Added in API level 1
void setLinksClickable (boolean whether)

设置是否运动方法将被自动设置为LinkMovementMethod如果setAutoLinkMask(int)已被设置为非零和检测环节setText(char[], int, int) 默认值是true。

相关XML属性:

Parameters
whether boolean

setMarqueeRepeatLimit

Added in API level 2
void setMarqueeRepeatLimit (int marqueeLimit)

设置重复选取框动画的次数。 仅在TextView启用了选取框的情况下应用。 设置为-1以无限重复。

相关XML属性:

Parameters
marqueeLimit int

也可以看看:

setMaxEms

Added in API level 1
void setMaxEms (int maxems)

使TextView最多有这么多的ems

相关XML属性:

Parameters
maxems int

setMaxHeight

Added in API level 1
void setMaxHeight (int maxHeight)

使TextView至多有很多像素高。 该选项与setMaxLines(int)方法是互斥的。 设置此值将覆盖任何其他(最多)行数设置。

相关XML属性:

Parameters
maxHeight int

setMaxLines

Added in API level 1
void setMaxLines (int maxlines)

使TextView至多有很多行高。 设置此值将覆盖任何其他(最大)高度设置。

相关XML属性:

Parameters
maxlines int

setMaxWidth

Added in API level 1
void setMaxWidth (int maxpixels)

使TextView最多有很多个像素

相关XML属性:

Parameters
maxpixels int

setMinEms

Added in API level 1
void setMinEms (int minems)

使TextView至少有很多这样的ems

相关XML属性:

Parameters
minems int

setMinHeight

Added in API level 1
void setMinHeight (int minHeight)

使TextView至少有很多像素高。 设置此值将覆盖任何其他(最小)行数设置。

相关XML属性:

Parameters
minHeight int

setMinLines

Added in API level 1
void setMinLines (int minlines)

使TextView至少有这么多行高。 设置此值将覆盖任何其他(最小)高度设置。 单行TextView会将此值设置为1。

相关XML属性:

Parameters
minlines int

也可以看看:

setMinWidth

Added in API level 1
void setMinWidth (int minpixels)

使TextView的宽度至少有很多像素

相关XML属性:

Parameters
minpixels int

setMovementMethod

Added in API level 1
void setMovementMethod (MovementMethod movement)

设置要用于此TextView的移动方法(箭头键处理程序)。 这可以为空以禁止使用箭头键移动光标或滚动视图。

需要警告的是,如果您希望TextView的关键侦听器或移动方法不可聚焦,或者如果您希望没有关键侦听器或移动方法的TextView可以聚焦,您必须在调用此方法后再次调用 setFocusable(boolean)以获得可聚焦性你想要的方式。

Parameters
movement MovementMethod

setOnEditorActionListener

Added in API level 3
void setOnEditorActionListener (TextView.OnEditorActionListener l)

设置一个特殊的侦听器,以便在文本视图上执行操作时调用。 当按下回车键时,或者当提供给IME的操作被用户选择时,这将被调用。 设置这意味着正常的硬键事件不会在文本视图中插入换行符,即使它是多行的; 然而,按住ALT修饰符将允许用户插入换行符。

Parameters
l TextView.OnEditorActionListener

setPadding

Added in API level 1
void setPadding (int left, 
                int top, 
                int right, 
                int bottom)

设置填充。 该视图可能会添加显示滚动条所需的空间,具体取决于滚动条的样式和可见性。 因此,从数值返回getPaddingLeft()getPaddingTop()getPaddingRight()getPaddingBottom()可能与此调用设置的值不同。

Parameters
left int: the left padding in pixels
top int: the top padding in pixels
right int: the right padding in pixels
bottom int: the bottom padding in pixels

setPaddingRelative

Added in API level 16
void setPaddingRelative (int start, 
                int top, 
                int end, 
                int bottom)

设置相对填充。 该视图可能会添加显示滚动条所需的空间,具体取决于滚动条的样式和可见性。 因此,从数值返回getPaddingStart()getPaddingTop()getPaddingEnd()getPaddingBottom()可能与此调用设置的值不同。

Parameters
start int: the start padding in pixels
top int: the top padding in pixels
end int: the end padding in pixels
bottom int: the bottom padding in pixels

setPaintFlags

Added in API level 1
void setPaintFlags (int flags)

在正在使用的Paint上设置标志以显示文本,如果文本与旧标志不同,则重新排列文本。

Parameters
flags int

也可以看看:

setPrivateImeOptions

Added in API level 3
void setPrivateImeOptions (String type)

设置文本的私人内容类型,即在创建输入连接时将填充的 EditorInfo.privateImeOptions字段。

相关XML属性:

Parameters
type String

也可以看看:

setRawInputType

Added in API level 3
void setRawInputType (int type)

直接更改文本视图的内容类型整数,而不修改任何其他状态。

相关XML属性:

Parameters
type int

也可以看看:

setScroller

Added in API level 1
void setScroller (Scroller s)

Parameters
s Scroller

setSelectAllOnFocus

Added in API level 1
void setSelectAllOnFocus (boolean selectAllOnFocus)

设置TextView,以便在焦点时选中所有文本。

相关XML属性:

Parameters
selectAllOnFocus boolean

setSelected

Added in API level 1
void setSelected (boolean selected)

更改此视图的选择状态。 视图可以被选择或不被选择。 请注意,选择与焦点不同。 视图通常在AdapterView(如ListView或GridView)的上下文中选择; 所选视图是突出显示的视图。

Parameters
selected boolean: true if the view must be selected, false otherwise

setShadowLayer

Added in API level 1
void setShadowLayer (float radius, 
                float dx, 
                float dy, 
                int color)

给文本指定的模糊半径和颜色的阴影,指定距离其绘制位置的距离。

生成的文本阴影不会与负责实时阴影的视图属性 elevationtranslationZ

相关XML属性:

Parameters
radius float
dx float
dy float
color int

也可以看看:

setShowSoftInputOnFocus

Added in API level 21
void setShowSoftInputOnFocus (boolean show)

设置在此TextView获得焦点时是否使软输入方法可见。 默认值是true。

Parameters
show boolean

setSingleLine

Added in API level 1
void setSingleLine (boolean singleLine)

如果为true,则将该字段的属性(行数,水平滚动,转换方法)设置为单行输入; 如果为false,则将其恢复为默认条件。 请注意,默认条件不一定是在此方法之前生效的那些条件,您可能希望将这些属性重置为您的自定义值。

相关XML属性:

Parameters
singleLine boolean

setSingleLine

Added in API level 1
void setSingleLine ()

将此字段的属性(行,水平滚动,转换方法)设置为单行输入。

相关XML属性:

setSpannableFactory

Added in API level 1
void setSpannableFactory (Spannable.Factory factory)

设置用于创建新Spannable的工厂。

Parameters
factory Spannable.Factory

setText

Added in API level 1
void setText (int resid)

Parameters
resid int

setText

Added in API level 1
void setText (CharSequence text)

设置TextView的字符串值。 TextView 接受类似HTML的格式,您可以使用XML资源文件中的文本字符串进行格式设置。 要设置字符串的样式,请将android.text.style。*对象附加到SpannableString ,或者参阅Available Resource Types文档以获取在XML资源文件中设置格式化文本的示例。

相关XML属性:

Parameters
text CharSequence

setText

Added in API level 1
void setText (CharSequence text, 
                TextView.BufferType type)

设置此TextView要显示的文本(请参阅 setText(CharSequence) ),并设置它是否存储在可修改/可跨越缓冲区中,以及它是否可编辑。

相关XML属性:

Parameters
text CharSequence
type TextView.BufferType

setText

Added in API level 1
void setText (int resid, 
                TextView.BufferType type)

Parameters
resid int
type TextView.BufferType

setText

Added in API level 1
void setText (char[] text, 
                int start, 
                int len)

将TextView设置为显示指定char数组的指定切片。 您必须承诺,除了在另一次调用setText()之前,不会更改数组的内容,因为TextView无法知道文本已更改,并且需要使其无效并重新布局。

Parameters
text char
start int
len int

setTextAppearance

Added in API level 1
void setTextAppearance (Context context, 
                int resId)

此方法在API级别23中已弃用。
改为使用setTextAppearance(int)

设置指定TextAppearance资源中的文本颜色,大小,样式,提示颜色和高亮颜色。

Parameters
context Context
resId int

setTextAppearance

Added in API level 23
void setTextAppearance (int resId)

从指定的样式资源中设置文本外观。

使用框架定义的 TextAppearance样式(如 @android:style/TextAppearance.Material.Body1或请参阅 TextAppearance以获取可在自定义样式中使用的属性集。

相关XML属性:

Parameters
resId int: the resource identifier of the style to apply

setTextColor

Added in API level 1
void setTextColor (int color)

将所有状态(正常,选定,聚焦)的文本颜色设置为该颜色。

相关XML属性:

Parameters
color int

也可以看看:

setTextColor

Added in API level 1
void setTextColor (ColorStateList colors)

设置文字颜色。

相关XML属性:

Parameters
colors ColorStateList

也可以看看:

setTextIsSelectable

Added in API level 11
void setTextIsSelectable (boolean selectable)

设置此视图的内容是否可由用户选择。 默认值为false ,表示内容不可选。

当您使用TextView向用户显示有用的信息片段(例如联系人的地址)时,请使其可选,以便用户可以选择并复制其内容。 您也可以使用将XML属性TextView_textIsSelectable设置为“true”。

当调用此方法来设置的值textIsSelectable ,它设置标志focusablefocusableInTouchModeclickable ,并longClickable为相同的值。 这些标志对应的属性android:focusableandroid:focusableInTouchModeandroid:clickable ,并android:longClickable 要恢复这些标志来您设置了前面,请拨打以下方法中的一种或多种状态: setFocusable()setFocusableInTouchMode()setClickable()或者setLongClickable()

Parameters
selectable boolean: Whether the content of this TextView should be selectable.

setTextKeepState

Added in API level 1
void setTextKeepState (CharSequence text)

setText(CharSequence)一样,除了光标位置(如果有的话)保留在新文本中。

Parameters
text CharSequence: The new text to place in the text view.

也可以看看:

setTextKeepState

Added in API level 1
void setTextKeepState (CharSequence text, 
                TextView.BufferType type)

setText(CharSequence, android.widget.TextView.BufferType)一样,除了光标位置(如果有)保留在新文本中。

Parameters
text CharSequence
type TextView.BufferType

也可以看看:

setTextLocale

Added in API level 17
void setTextLocale (Locale locale)

将此TextView中文本的默认值 LocaleList设置为仅包含给定值的一个成员列表。

Parameters
locale Locale: the Locale for drawing text, must not be null.

也可以看看:

setTextLocales

Added in API level 24
void setTextLocales (LocaleList locales)

将此TextView中文本的默认值LocaleList设置为给定值。 该值用于为模糊字符选择合适的字体(通常用于CJK语言环境来消除汉字/汉字/汉字字符的歧义)。 它还影响文本显示的其他方面,包括换行。

Parameters
locales LocaleList: the LocaleList for drawing text, must not be null or empty.

也可以看看:

setTextScaleX

Added in API level 1
void setTextScaleX (float size)

设置文本水平伸展的范围。

相关XML属性:

Parameters
size float

setTextSize

Added in API level 1
void setTextSize (int unit, 
                float size)

将默认文字大小设置为给定的单位和值。 有关可能的尺寸单位,请参阅TypedValue

相关XML属性:

Parameters
unit int: The desired dimension unit.
size float: The desired size in the given units.

setTextSize

Added in API level 1
void setTextSize (float size)

将默认文字大小设置为给定值,解释为“缩放像素”单位。 此大小根据当前密度和用户字体大小首选项进行调整。

相关XML属性:

Parameters
size float: The scaled pixel size.

setTransformationMethod

Added in API level 1
void setTransformationMethod (TransformationMethod method)

设置应用于此TextView显示的文本的转换。

相关XML属性:

Parameters
method TransformationMethod

setTypeface

Added in API level 1
void setTypeface (Typeface tf)

设置文字应显示的字体和样式。 请注意,并非所有的字体系列实际上都有粗体和斜体变体,因此您可能需要使用setTypeface(Typeface, int)来获得您实际需要的外观。

相关XML属性:

Parameters
tf Typeface

也可以看看:

setTypeface

Added in API level 1
void setTypeface (Typeface tf, 
                int style)

设置应该显示文本的字体和样式,如果您提供的字体没有指定样式中的所有位,则打开“Paint”中的假粗体和斜体位。

相关XML属性:

Parameters
tf Typeface
style int

setWidth

Added in API level 1
void setWidth (int pixels)

使TextView正好有很多像素宽。 你可以通过在LayoutParams中指定这个数字来做同样的事情。

相关XML属性:

Parameters
pixels int

也可以看看:

showContextMenu

Added in API level 1
boolean showContextMenu ()

显示该视图的上下文菜单。

Returns
boolean true if the context menu was shown, false otherwise

showContextMenu

Added in API level 24
boolean showContextMenu (float x, 
                float y)

显示锚定到指定视图相对坐标的此视图的上下文菜单。

Parameters
x float: the X coordinate in pixels relative to the view to which the menu should be anchored, or NaN to disable anchoring
y float: the Y coordinate in pixels relative to the view to which the menu should be anchored, or NaN to disable anchoring
Returns
boolean true if the context menu was shown, false otherwise

Protected methods

computeHorizontalScrollRange

Added in API level 1
int computeHorizontalScrollRange ()

计算水平滚动条代表的水平范围。

范围以任意单位表示,必须与 computeHorizontalScrollExtent()computeHorizontalScrollOffset()使用的单位相同。

默认范围是此视图的图纸宽度。

Returns
int the total horizontal range represented by the horizontal scrollbar

computeVerticalScrollExtent

Added in API level 1
int computeVerticalScrollExtent ()

计算垂直滚动条拇指在垂直范围内的垂直范围。 该值用于计算滚动条轨道内的拇指长度。

范围以任意单位表示,必须与 computeVerticalScrollRange()computeVerticalScrollOffset()使用的单位相同。

默认范围是此视图的绘图高度。

Returns
int the vertical extent of the scrollbar's thumb

computeVerticalScrollRange

Added in API level 1
int computeVerticalScrollRange ()

计算垂直滚动条代表的垂直范围。

范围以任意单位表示,必须与 computeVerticalScrollExtent()computeVerticalScrollOffset()使用的单位相同。

Returns
int the total vertical range represented by the vertical scrollbar

默认范围是此视图的绘图高度。

drawableStateChanged

Added in API level 1
void drawableStateChanged ()

只要视图的状态发生变化,就会调用此函数,使得它影响所显示的可绘制状态。

如果View有一个StateListAnimator,它也将被调用来运行必要的状态改变动画。

重写此功能时,一定要调用超类。

getBottomPaddingOffset

Added in API level 2
int getBottomPaddingOffset ()

扩展底部衰落区域的数量。 仅当isPaddingOffsetRequired()返回true时才被调用。

Returns
int The bottom padding offset in pixels.

getDefaultEditable

Added in API level 1
boolean getDefaultEditable ()

子类覆盖这个以指定它们默认具有KeyListener,即使在XML选项中没有专门调用它。

Returns
boolean

getDefaultMovementMethod

Added in API level 1
MovementMethod getDefaultMovementMethod ()

子类覆盖此以指定默认移动方法。

Returns
MovementMethod

getLeftFadingEdgeStrength

Added in API level 1
float getLeftFadingEdgeStrength ()

返回左边渐变边的强度或强度。 强度是介于0.0(无褪色)和1.0(全褪色)之间的值。 默认实现返回0.0或1.0,但两者之间没有值。 滚动发生时,子类应该重写此方法以提供更平滑的淡入淡出转换。

Returns
float the intensity of the left fade as a float between 0.0f and 1.0f

getLeftPaddingOffset

Added in API level 2
int getLeftPaddingOffset ()

扩展左衰落区域的量。 仅在isPaddingOffsetRequired()返回true时调用。

Returns
int The left padding offset in pixels.

getRightFadingEdgeStrength

Added in API level 1
float getRightFadingEdgeStrength ()

返回右边褪色边缘的强度或强度。 强度是介于0.0(无褪色)和1.0(全褪色)之间的值。 默认实现返回0.0或1.0,但两者之间没有值。 滚动发生时,子类应该重写此方法以提供更平滑的淡入淡出转换。

Returns
float the intensity of the right fade as a float between 0.0f and 1.0f

getRightPaddingOffset

Added in API level 2
int getRightPaddingOffset ()

扩展正确衰落区域的数量。 仅在isPaddingOffsetRequired()返回true时调用。

Returns
int The right padding offset in pixels.

getTopPaddingOffset

Added in API level 2
int getTopPaddingOffset ()

扩大最大衰落区域的数量。 仅当isPaddingOffsetRequired()返回true时才调用。

Returns
int The top padding offset in pixels.

isPaddingOffsetRequired

Added in API level 2
boolean isPaddingOffsetRequired ()

如果视图在其填充内绘制内容并启用淡化边缘,则需要支持填充偏移。 将填充偏移添加到淡出边缘以延长淡入淡出的长度,以便覆盖填充内部绘制的像素。 如果需要在填充内绘制内容,则此类的子类应该重写此方法。

Returns
boolean True if padding offset must be applied, false otherwise.

onAttachedToWindow

Added in API level 1
void onAttachedToWindow ()

这在视图附加到窗口时被调用。 此时它有一个Surface并将开始绘制。 注意这个函数保证在onDraw(android.graphics.Canvas)之前被调用,但是它可以在第一次onDraw之前的任何时候调用 - 包括在onMeasure(int, int)之前或之后。

onConfigurationChanged

Added in API level 8
void onConfigurationChanged (Configuration newConfig)

当应用程序使用的资源的当前配置发生更改时调用。 您可以使用它来决定何时重新加载可根据方向和其他配置特性更改的资源。 你只需要使用这个,如果你不依靠正常Activity机制在配置更改重新创建活动实例。

Parameters
newConfig Configuration: The new resource configuration.

onCreateContextMenu

Added in API level 1
void onCreateContextMenu (ContextMenu menu)

如果视图本身要将项目添加到上下文菜单,则视图应该执行此操作。

Parameters
menu ContextMenu: the context menu to populate

onCreateDrawableState

Added in API level 1
int[] onCreateDrawableState (int extraSpace)

为此视图生成新的Drawable状态。 当缓存的Drawable状态被确定为无效时,这由视图系统调用。 要检索当前状态,您应该使用getDrawableState()

Parameters
extraSpace int: if non-zero, this is the number of extra entries you would like in the returned array in which you can place your own states.
Returns
int[] Returns an array holding the current Drawable state of the view.

onDraw

Added in API level 1
void onDraw (Canvas canvas)

实施这个来做你的绘画。

Parameters
canvas Canvas: the canvas on which the background will be drawn

onFocusChanged

Added in API level 1
void onFocusChanged (boolean focused, 
                int direction, 
                Rect previouslyFocusedRect)

当视图的焦点状态改变时,由视图系统调用。 当焦点更改事件是由方向导航导致的,direction和previouslyFocusedRect提供了焦点来自何处的洞察。 重写时,一定要调用超类,以便进行标准的焦点处理。

Parameters
focused boolean: True if the View has focus; false otherwise.
direction int: The direction focus has moved when requestFocus() is called to give this view focus. Values are FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, FOCUS_RIGHT, FOCUS_FORWARD, or FOCUS_BACKWARD. It may not always apply, in which case use the default.
previouslyFocusedRect Rect: The rectangle, in this view's coordinate system, of the previously focused view. If applicable, this will be passed in as finer grained information about where the focus is coming from (in addition to direction). Will be null otherwise.

onLayout

Added in API level 1
void onLayout (boolean changed, 
                int left, 
                int top, 
                int right, 
                int bottom)

当这个视图为每个孩子分配一个大小和位置时,从布局调用。 带孩子的派生类应该覆盖这个方法,并调用他们每个孩子的布局。

Parameters
changed boolean: This is a new size or position for this view
left int: Left position, relative to parent
top int: Top position, relative to parent
right int: Right position, relative to parent
bottom int: Bottom position, relative to parent

onMeasure

Added in API level 1
void onMeasure (int widthMeasureSpec, 
                int heightMeasureSpec)

测量视图及其内容以确定测量宽度和测量高度。 此方法由measure(int, int)调用, measure(int, int)子类覆盖以提供其内容的准确和有效的度量。

合同:覆盖此方法时,您必须致电setMeasuredDimension(int, int)来存储此视图的测量宽度和高度。 如果不这样做将触发IllegalStateException ,由measure(int, int)抛出。 调用超类' onMeasure(int, int)是一个有效的用法。

Measure的基类实现默认为背景大小,除非MeasureSpec允许更大的大小。 子类应该覆盖onMeasure(int, int)以提供更好的内容度量。

如果此方法被覆盖,则子类的责任是确保测量的高度和宽度至少为视图的最小高度和宽度( getSuggestedMinimumHeight()getSuggestedMinimumWidth() )。

Parameters
widthMeasureSpec int: horizontal space requirements as imposed by the parent. The requirements are encoded with View.MeasureSpec.
heightMeasureSpec int: vertical space requirements as imposed by the parent. The requirements are encoded with View.MeasureSpec.

onScrollChanged

Added in API level 1
void onScrollChanged (int horiz, 
                int vert, 
                int oldHoriz, 
                int oldVert)

这是为了响应此视图中的内部滚动而调用的(即视图滚动了其自己的内容)。 这通常是因为调用了scrollBy(int, int)scrollTo(int, int)

Parameters
horiz int: Current horizontal scroll origin.
vert int: Current vertical scroll origin.
oldHoriz int: Previous horizontal scroll origin.
oldVert int: Previous vertical scroll origin.

onSelectionChanged

Added in API level 3
void onSelectionChanged (int selStart, 
                int selEnd)

当选择发生变化时调用此方法,以防子类想知道。

Parameters
selStart int: The new selection start location.
selEnd int: The new selection end location.

onTextChanged

Added in API level 1
void onTextChanged (CharSequence text, 
                int start, 
                int lengthBefore, 
                int lengthAfter)

当文本被改变时,这个方法被调用,以防任何子类想知道。 text ,该lengthAfter在最初的文字start刚刚取代了长了旧文本lengthBefore 尝试从此回调中更改text是错误的。

Parameters
text CharSequence: The text the TextView is displaying
start int: The offset of the start of the range of the text that was modified
lengthBefore int: The length of the former text that has been replaced
lengthAfter int: The length of the replacement modified text

onVisibilityChanged

Added in API level 8
void onVisibilityChanged (View changedView, 
                int visibility)

当视图的可见性或视图的祖先已更改时调用。

Parameters
changedView View: The view whose visibility changed. May be this or an ancestor view.
visibility int: The new visibility, one of VISIBLE, INVISIBLE or GONE.

setFrame

Added in API level 1
boolean setFrame (int l, 
                int t, 
                int r, 
                int b)

为此视图分配大小和位置。 这是从布局调用的。

Parameters
l int: Left position, relative to parent
t int: Top position, relative to parent
r int: Right position, relative to parent
b int: Bottom position, relative to parent
Returns
boolean true if the new size and position are different than the previous ones

verifyDrawable

Added in API level 1
boolean verifyDrawable (Drawable who)

如果你的视图子类正在显示它自己的Drawable对象,它应该覆盖这个函数,并且对于它显示的任何Drawable返回true。 这样可以安排这些可绘制的动画。

重写此功能时,一定要调用超类。

Parameters
who Drawable: The Drawable to verify. Return true if it is one you are displaying, else return the result of calling through to the super class.
Returns
boolean boolean If true than the Drawable is being displayed in the view; else false and it is not allowed to animate.

Hooray!