java.lang.Object
|---ohos.agp.components.Component
|---|---ohos.agp.components.Text
public class Text
extends Component
显示组件中的文本。
文本是基本的 UI 元素。
Since:
3
| 修饰符和类型 | 类 | 描述 |
|---|---|---|
| static class | Text.ConversionType | 枚举转换类型。 |
| static interface | Text.EditorActionListener | 侦听编辑器操作的更改事件。 |
| static class | Text.FontFamilyType | 枚举字体系列类型。 |
| static interface | Text.TextColorObserver | 提供一个观察者来监听组件中的文本颜色变化。 |
| static interface | Text.TextObserver | 提供一个文本观察器来观察组件中的文本变化。 |
| static interface | Text.TextSizeObserver | 提供一个观察者来监听组件中文本大小的变化。 |
| static class | Text.TextSizeType | 枚举文本大小的类型。 |
| static class | Text.TruncationMode | 指示如何截断文本。 |
| 从类 ohos.agp.components.Component 继承的嵌套类/接口 |
|---|
| Component.BindStateChangedListener, Component.CanAcceptScrollListener, Component.ClickedListener, Component.ComponentStateChangedListener, Component.ContourRefreshedListener, Component.DefSpeechEventListener, Component.DoubleClickedListener, Component.DragFeedbackProvider, Component.DraggedListener, Component.DrawTask, Component.EditEventListener, Component.EstimateSizeListener, Component.EstimateSpec, Component.FadeEffectEnum, Component.FocusChangedListener, Component.ForwardHoverListener, Component.ForwardTouchListener, Component.GestureType, Component.HoverEventListener, Component.KeyEventListener, Component.LayoutDirection, Component.LayoutRefreshedListener, Component.LongClickedListener, Component.MeasureSpec, Component.MouseEventListener, Component.MousePointerStyleListener, Component.OnDragListener, Component.RotationEventListener, Component.ScaledListener, Component.ScrolledListener, Component.ShadowDevice, Component.ShadowMode, Component.ShadowSize, Component.SpeechEventListener, Component.TouchEventListener, Component.UnconsumedKeyEventListener, Component.VoiceEvent |
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| static int | AUTO_CURSOR_POSITION | 表示光标所在的位置。 |
| static int | AUTO_SCROLLING_FOREVER | 表示文本将始终处于自动滚动状态。 |
| 从类 ohos.agp.components.Component 继承的字段 |
|---|
| ACCESSIBILITY_ADAPTABLE, ACCESSIBILITY_DISABLE, ACCESSIBILITY_ENABLE, AXIS_X, AXIS_Y, CONTOUR_BACKGROUND, CONTOUR_BORDER, CONTOUR_PADDING_BORDER, DEFAULT_SCALE, DRAG_DOWN, DRAG_HORIZONTAL, DRAG_HORIZONTAL_VERTICAL, DRAG_LEFT, DRAG_RIGHT, DRAG_UP, DRAG_VERTICAL, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED, EVENT_TYPE_COMPONENT_ACCESSIBILITY_FOCUSED_CLEAR, EVENT_TYPE_COMPONENT_CLICKED, EVENT_TYPE_COMPONENT_FOCUSED, EVENT_TYPE_COMPONENT_LONG_CLICKED, EVENT_TYPE_COMPONENT_SCROLLED, EVENT_TYPE_COMPONENT_SELECTED, EVENT_TYPE_COMPONENT_TEXT_UPDATE, EVENT_TYPE_NOTICE, EVENT_TYPE_NOTIFICATION_STATE_UPDATE, EVENT_TYPE_TOAST_SHOW, EVENT_TYPE_WINDOW_STATE_UPDATE, FOCUS_ADAPTABLE, FOCUS_DISABLE, FOCUS_ENABLE, FOCUS_NEXT, FOCUS_PREVIOUS, FOCUS_SIDE_BOTTOM, FOCUS_SIDE_LEFT, FOCUS_SIDE_RIGHT, FOCUS_SIDE_TOP, HIDE, HORIZONTAL, ID_DEFAULT, INHERITED_MODE, INVISIBLE, mBackgroundElement, mCanvasForTaskOverContent, mCanvasForTaskUnderContent, mComponentParent, mContext, mDrawTaskOverContent, mDrawTaskUnderContent, mEstimateSizeListener, mForegroundElement, mForwardHoverListener, mHoverEventListener, mKeyEventListener, mMouseEventListener, mPosition, mRotationEventListener, mShadowElement, mUnconsumedKeyEventListener, OVAL_MODE, OVAL_SCROLL_BAR_MODE, POSITION_X_INDEX, POSITION_Y_INDEX, RECT_MODE, RECT_SCROLL_BAR_MODE, SCROLL_AUTO_STAGE, SCROLL_IDLE_STAGE, SCROLL_NORMAL_STAGE, UNSPECIFIED_SCROLL_BAR_MODE, VERTICAL, VISIBLE |
| 构造函数 | 描述 |
|---|---|
| Text(Context context) | 默认构造函数用于使用默认属性集和样式创建 Text 实例。 |
| Text(Context context, AttrSet attrSet) | 用于在 XML 文件解析后使用指定的属性集和默认样式创建 Text 实例的构造函数。 |
| Text(Context context, AttrSet attrSet, String styleName) | 用于在 XML 文件解析后使用指定的属性集和指定的样式创建 Text 实例的构造函数。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | addTextObserver(Text.TextObserver observer) | 添加文本观察器 TextObserver 以检测文本是否更改。 |
| boolean | adjustCursorPosition() | 检查光标是否可以移动到可见位置。 |
| void | append(String text) | 将文本字符串附加到文本组件中的现有文本。 |
| void | delete(int length) | 删除光标前的文本。 |
| void | delete(int length, boolean back) | 删除光标之前或之后的文本。 |
| void | delete(int length, boolean back, int pos) | 从指定位置删除文本。 |
| float | getAdditionalLineSpacing() | 获取添加到文本组件中每行高度的额外间距。 |
| Element[] | getAroundElements() | 获取文本周围的元素对象。 |
| int | getAroundElementsPadding() | 获取文本和元素对象之间的填充。 |
| Element[] | getAroundElementsRelative() | 获取文本周围的元素对象。 |
| int[] | getAutoFontSizeRule() | 获取自动调整大小的规则。 |
| int | getAutoFontSizeStep() | 获取自动调整大小的步骤。 |
| int | getAutoScrollingCount() | 获取文本的自动滚动次数。 |
| long | getAutoScrollingDuration() | 获取文本的自动滚动时长。 |
| int | getBaseLine(int line) | 获取目标线基线的 y 坐标。 |
| Element | getBottomElement() | 获取文本底部的元素。 |
| Element | getBottonElement() | 已弃用。 此更改从 API 版本 8 开始生效。由 getBottomElement() 替换。 |
| void | getBoundingRect(int line, Rect bounding) | 获取目标线的边界矩形。 |
| Element | getBubbleElement() | 获取光标所在气泡框的Element对象。 |
| int | getBubbleHeight() | 获取文本气泡框的高度。 |
| int | getBubbleWidth() | 获取文本气泡框的宽度。 |
| int | getCombinedPaddingBottom() | 获取此文本底部的组合填充。 |
| int | getCombinedPaddingEnd() | 获取文本末尾的组合填充。 |
| int | getCombinedPaddingLeft() | 获取此文本左侧的组合填充。 |
| int | getCombinedPaddingRight() | 获取此文本右侧的组合填充。 |
| int | getCombinedPaddingStart() | 获取此文本开头的组合填充。 |
| int | getCombinedPaddingTop() | 获取此文本顶部的组合填充。 |
| Element | getCursorElement() | 获取文本中光标的元素对象。 |
| String | getCustomInputMethodOptions() | 获取自定义输入法选项。 |
| String | getEditableString() | 获取可编辑文本组件中的文本。 |
| boolean | getEditingText(EditingCapability request, EditingText text) | 获取可编辑的文本。 |
| int | getEditorAction() | 获取编辑器动作。 |
| CharSequence | getEditorActionText() | 获取编辑器操作文本。 |
| Element | getEndElement() | 获取文本周围的结束元素。 |
| PacMap | getExtraInputData(boolean isCreate) | 获取发送到输入法的额外输入数据。 |
| int | getFadeEffectBoundaryWidth() | 获取文本淡化效果区域的边界宽度。 |
| Font | getFont() | 获取文本字体。 |
| Text.FontFamilyType | getFontFamilyType() | 获取此 Text 的字体系列类型。 |
| String | getFontFeatures() | 获取字体功能设置。 |
| String | getFontVariations() | 获取字体变化设置。 |
| String | getHint() | 获取文本为空时显示的提示文本。 |
| Color | getHintColor() | 获取文本组件中提示文本的颜色。 |
| TextLayout.HyphenationStrategy | getHyphenationStrategy() | 获取该文本的自动断字策略。 |
| InputFilter[] | getInputFilters() | 获取输入过滤器列表。 |
| LocaleProfile | getInputMethodLocales() | 获取此文本的建议 LocaleProfile。 |
| int | getInputMethodOption() | 获取文本的输入法选项。 |
| TextLayout.JustifyStrategy | getJustifyStrategy() | 获取文本对齐策略。 |
| Element | getLeftElement() | 获取文本左侧的元素。 |
| float | getLetterSpacing() | 获取文本字母之间的间距。 |
| TextLayout.LineBreakStrategy | getLineBreakStrategy() | 获取该文本的换行策略。 |
| int | getLineCount() | 获取此文本中的行数。 |
| int | getLineHeight() | 获取此文本中的行间高度。 |
| LocaleProfile | getLocales() | 获取此文本中的默认 LocaleProfile。 |
| int | getMaxAutoFontSize() | 获取自动调整大小允许的最大文本大小。 |
| int | getMaxTextHeight() | 获取文本的最大高度。 |
| int | getMaxTextLines() | 获取文本组件中允许的最大行数。 |
| int | getMaxTextWidth() | 获取文本的最大宽度。 |
| int | getMaxWidthInEms() | 获取此文本的最大宽度，以 em 为单位。 |
| int | getMinAutoFontSize() | 获取自动调整大小所允许的最小文本大小。 |
| int | getMinTextHeight() | 获取此 Text 的最小高度。 |
| int | getMinTextLines() | 获取此文本中的最小行数。 |
| int | getMinTextWidth() | 获取此 Text 的最小宽度。 |
| int | getMinWidthInEms() | 获取此文本的最小宽度，以 em 为单位。 |
| float | getNumOfFontHeight() | 获取行距乘数，它在文本组件中的行之间提供额外的间距。 |
| int | getOffsetByCoordinates(float x, float y) | 获取距离指定位置最近的字符偏移量。 |
| boolean | getPaddingForText() | 检查文本是否有额外的填充空间。 |
| Locale | getPrimaryLocale() | 获取此文本的默认语言环境。 |
| RichText | getRichText() | 获取文本组件中显示的富文本。 |
| Element | getRightElement() | 获取文本右侧的元素。 |
| Color | getSelectionColor() | 获取选定文本的颜色。 |
| int | getSelectionEnd() | 获得选择边的结束。 |
| Element | getSelectionLeftBubbleElement() | 获取显示在选中气泡框左侧内边距区域的 Element 对象。 |
| int | getSelectionLeftBubbleHeight() | 获取所选气泡框左侧填充区域的高度。 |
| int | getSelectionLeftBubbleWidth() | 获取所选气泡框左侧填充区域的宽度。 |
| Element | getSelectionRightBubbleElement() | 获取显示在选中气泡框右侧内边距区域的 Element 对象。 |
| int | getSelectionRightBubbleHeight() | 获取所选气泡框右侧填充区域的高度。 |
| int | getSelectionRightBubbleWidth() | 获取所选气泡框右侧填充区域的宽度。 |
| int | getSelectionStart() | 获取选择边的起点。 |
| Element | getStartElement() | 获取文本周围的起始元素。 |
| String | getText() | 获取文本组件中显示的文本。 |
| int | getTextAlignment() | 获取文本组件中的文本对齐方式。 |
| Color | getTextColor() | 获取文本组件的文本颜色。 |
| Text.ConversionType | getTextConversion() | 获取此文本的 ConversionType。 |
| BidiAnalyzer.BidiStrategy | getTextDirectionStrategy() | 获取文本方向策略。 |
| float | getTextHorizontalScale() | 获取此 Text 的水平乘数。 |
| int | getTextInputType() | 获取Text的文本输入类型。 |
| Color | getTextShadowColor() | 获取文本阴影的颜色。 |
| float | getTextShadowOffsetX() | 获取文本阴影的水平偏移量。 |
| float | getTextShadowOffsetY() | 获取文本阴影的垂直偏移量。 |
| float | getTextShadowRadius() | 获取文本阴影的模糊半径。 |
| int | getTextSize() | 获取文本组件的文本大小。 |
| int | getTextSize(Text.TextSizeType textSizeType) | 获取文本的字体大小。 |
| int | getTextToBottomSpace() | 获取显示的文本底部到文本组件底部的距离。 |
| int | getTextToTopSpace() | 获取显示的文本顶部到文本组件顶部的距离。 |
| Element | getTopElement() | 获取文本顶部的元素。 |
| Text.TruncationMode | getTruncationMode() | 获取截断模式。 |
| ListUrlRichStyle | getUrls() | 获取此文本中的超链接列表。 |
| void | insert(String text) | 在光标所在位置插入文本。 |
| void | insert(String text, int pos) | 在指定位置插入文本。 |
| boolean | isAdjustInputPanel() | 获取在弹出输入法面板时是否开启自动文本组件重新布局。 |
| boolean | isAllUpperCase() | 检查应用于此文本的 ConversionType 是否设置为 ConversionType#ALL_UPPERCASE。 |
| boolean | isAutoFontSize() | 获取是否自动调整文本大小以填充在组件内。 |
| boolean | isAutoSelectEnabled() | 获取文本获得焦点时是否选择所有文本。 |
| boolean | isEditable() | 检查此文本是否可编辑。 |
| boolean | isFallbackFontMetricsEnabled() | 检查是否为后备字体启用了上升或下降指标。 |
| boolean | isFocusedByTouch() | 当你触摸它时检查这个文本是否有焦点。 |
| boolean | isHyperLinkClickable() | 检查此文本中的超链接是否可单击。 |
| boolean | isInputMethodActive() | 检查此 Text 是否是当前输入法的目标。 |
| boolean | isMultipleLine() | 获取文本是否在文本组件中多行显示。 |
| boolean | isScrollable() | 获取文本在文本组件中是否可滚动。 |
| boolean | isSoftInputVisibleOnFocus() | 检查当此文本获得焦点时软输入是否可见。 |
| boolean | isTextCursorVisible() | 获取光标对于可编辑文本组件是否可见。 |
| boolean | isTextSelectable() | 检查是否可以选择此文本。 |
| int | length() | 获取文本组件中允许的文本长度。 |
| void | lockEditingState() | 锁定输入法并开始文本编辑。 |
| boolean | moveToPosition(int offset) | 根据指定的偏移量将字符移动到可见位置。 |
| boolean | onCustomInputMethodCommand(String action, PacMap data) | 由框架调用以响应来自输入法的自定义命令。 |
| void | onLockEditingState() | 当输入法被锁定时调用。 |
| protected void | onRtlChanged(Component.LayoutDirection layoutDirection) | 在更改任何 RTL 属性时调用。 |
| boolean | onTextEditorAction(int actionCode) | 在处理指定编辑器操作的更改事件时调用。 |
| void | onUnlockEditingState() | 当输入法解锁时调用。 |
| void | removeTextObserver(Text.TextObserver observer) | 删除文本观察者 TextObserver。 |
| void | setAdjustInputPanel(boolean adjust) | 设置当软输入面板弹出或隐藏时布局是否应调整大小。 |
| void | setAroundElements(Element left, Element top, Element right, Element bottom) | 围绕文本设置元素对象。 |
| void | setAroundElementsPadding(int padding) | 设置文本和元素对象之间的填充。 |
| void | setAroundElementsRelative(Element start, Element top, Element end, Element bottom) | 围绕文本设置元素对象。 |
| void | setAutoCursorAdjustmentEnabled(boolean isAutoMove) | 将光标设置为自动移动。 |
| void | setAutoFontSize(boolean autoFontSize) | 设置是否自动调整文本大小以填充组件。 |
| void | setAutoFontSize(boolean autoFontSize, boolean userSizeFirst) | 设置是否自动调整字体大小以填充组件内，以及是否在启用自动字体大小适应之前尝试指定的字体大小。 |
| void | setAutoFontSizeRule(int[] preSet) | 设置所有可能的自动字体大小的数组。 |
| void | setAutoFontSizeRule(int minFontSize, int maxFontSize, int autoFontStep) | 设置自动字体大小的范围和步长。 |
| void | setAutoScrollingCount(int count) | 设置文本的自动滚动计数。 |
| void | setAutoScrollingDuration(long duration) | 设置长文本的自动滚动持续时间。 |
| void | setAutoSelectEnabled(boolean isSelectAll) | 设置 thisText 有焦点时是否选择所有文本。 |
| void | setBubbleElement(int resId) | 为光标所在的气泡设置一个 Element 对象。 |
| void | setBubbleElement(Element element) | 为光标所在的气泡设置一个 Element 对象。 |
| void | setBubbleHeight(int height) | 设置文本气泡框的高度。 |
| void | setBubbleSize(int width, int height) | 设置显示文本的气泡框的宽度和高度。 |
| void | setBubbleWidth(int width) | 设置文本气泡框的宽度。 |
| void | setCursorElement(int resId) | 为文本中的光标设置元素对象。 |
| void | setCursorElement(Element element) | 设置此 Text 中光标的 Element 对象。 |
| boolean | setCursorPosition(int position) | 设置文本的光标位置。 |
| void | setCustomInputMethodOptions(String options) | 设置此文本的自定义输入法选项。 |
| void | setEditable(boolean isEditable) | 设置此文本的可编辑性。 |
| void | setEditorActionListener(Text.EditorActionListener listener) | 为组件中的编辑器操作注册一个侦听器。 |
| void | setEditorActionText(CharSequence text, int action) | 设置编辑器操作文本。 |
| void | setExtraInputData(PacMap data) | 为此文本设置额外的输入数据。 |
| void | setFadeEffectBoundaryWidth(int width) | 设置文本的淡入淡出效果区域的边界宽度。 |
| void | setFallbackFontMetricsEnabled(boolean isEnable) | 设置是否为后备字体启用上升或下降指标。 |
| void | setFont(Font font) | 设置文本字体。 |
| void | setFontFamilyType(Text.FontFamilyType type) | 设置此文本的字体系列。 |
| void | setFontFeatures(String settings) | 设置字体特征。 |
| boolean | setFontVariations(String variation) | 设置 TrueType 或 OpenType 字体变体设置。 |
| void | setHint(int resId) | 设置此 Text 为空时显示的提示文本。 |
| void | setHint(String hint) | 设置文本为空时显示的提示文本。 |
| void | setHintColor(Color color) | 设置文本组件中提示文本的颜色。 |
| void | setHyperLinkClickable(boolean isClickable) | 设置此文本中超链接的可点击性。 |
| void | setHyperLinkColor(Color color) | 设置文本中链接的颜色。 |
| void | setHyphenationStrategy(TextLayout.HyphenationStrategy strategy) | 设置此文本的自动断字策略。 |
| void | setInputFilters(InputFilter[] filters) | 设置文本的输入过滤器列表。 |
| void | setInputMethodLocales(LocaleProfile locales) | 为此文本设置建议的 LocaleProfile。 |
| void | setInputMethodOption(int option) | 设置文本的输入法选项。 |
| void | setJustifyStrategy(TextLayout.JustifyStrategy strategy) | 设置文本对齐策略。 |
| void | setLeftBubbleHeight(int height) | 设置文本左侧气泡框的高度。 |
| void | setLeftBubbleSize(int width, int height) | 设置显示文本的气泡框左侧填充区域的宽度和高度。 |
| void | setLeftBubbleWidth(int width) | 设置文本左侧气泡框的宽度。 |
| void | setLetterSpacing(float spacing) | 设置文本字母之间的间距。 |
| void | setLineBreakStrategy(TextLayout.LineBreakStrategy strategy) | 设置此文本的换行策略。 |
| void | setLineHeight(int lineHeight) | 设置此文本的行之间的高度。 |
| void | setLines(int lines) | 设置此文本的行数。 |
| void | setLineSpacing(float add, float mult) | 设置文本组件的行距。 |
| void | setLocales(LocaleProfile locales) | 设置用于绘制此文本的 LocaleProfile。 |
| void | setMaxCharacters(int maxValue) | 设置此文本的最大字符数。 |
| void | setMaxTextHeight(int maxTextHeight) | 设置文本的最大高度。 |
| void | setMaxTextLines(int maxLines) | 设置文本组件中允许的最大行数。 |
| void | setMaxTextWidth(int maxTextWidth) | 设置文本的最大宽度。 |
| void | setMaxWidthInEms(int maxEms) | 设置此文本的最大宽度，以 em 为单位。 |
| void | setMinTextHeight(int minHeight) | 设置此文本的最小高度。 |
| void | setMinTextLines(int minLines) | 设置此文本的最小行数。 |
| void | setMinTextWidth(int minWidth) | 设置此文本的最小宽度。 |
| void | setMinWidthInEms(int minEms) | 设置此文本的最小宽度，以 em 为单位。 |
| void | setMultipleLine(boolean multiple) | 设置文本是否在文本组件中多行显示。 |
| void | setPaddingForText(boolean hasPadding) | 设置文本是否有额外的填充空间。 |
| void | setPrimaryLocale(Locale locale) | 设置用于绘制此文本的区域设置。 |
| void | setRichText(RichText richText) | 设置要在文本组件中显示的富文本。 |
| void | setRightBubbleHeight(int height) | 设置文本右侧气泡框的高度。 |
| void | setRightBubbleSize(int width, int height) | 设置显示文本的气泡框右侧填充区域的宽度和高度。 |
| void | setRightBubbleWidth(int width) | 设置文本右侧气泡框的宽度。 |
| void | setScrollable(boolean scrollable) | 设置文本是否可滚动。 |
| boolean | setSelection(int start, int end) | 设置此文本的选择范围。 |
| void | setSelectionColor(Color color) | 设置选定文本的颜色。 |
| void | setSelectionLeftBubbleElement(int resId) | 设置要为左侧气泡显示的元素对象。 |
| void | setSelectionLeftBubbleElement(Element element) | 设置要为左侧气泡显示的元素对象。 |
| void | setSelectionRightBubbleElement(int resId) | 设置要为右侧气泡显示的元素对象。 |
| void | setSelectionRightBubbleElement(Element element) | 设置要为右侧气泡显示的元素对象。 |
| void | setSoftInputVisibleOnFocus(boolean isShow) | 设置当此文本获得焦点时是否使软输入可见。 |
| void | setText(int resId) | 设置要显示的文本的资源 ID。 |
| void | setText(String text) | 设置要在文本组件中显示的文本。 |
| void | setTextAlignment(int textAlignment) | 设置文本组件中的文本对齐方式。 |
| void | setTextColor(Color color) | 设置文本组件的文本颜色。 |
| void | setTextConversion(Text.ConversionType conversionType) | 设置此文本的 ConversionType。 |
| void | setTextCursorVisible(boolean visible) | 设置光标对于可编辑文本组件是否可见。 |
| void | setTextDirectionStrategy(BidiAnalyzer.BidiStrategy strategy) | 设置文本方向策略。 |
| void | setTextHeight(int pixels) | 设置此文本的固定高度。 |
| void | setTextHorizontalScale(float ratio) | 设置此文本的水平乘数。 |
| void | setTextInputType(int inputType) | 设置 Text 的文本输入类型。 |
| void | setTextSelectable(boolean isSelectable) | 设置此文本是否可选。 |
| void | setTextShadow(float offsetX, float offsetY, float radius, Color color) | 设置此文本的阴影。 |
| void | setTextSize(int size) | 为文本设置指定的字体大小。 |
| void | setTextSize(int size, Text.TextSizeType textSizeType) | 为具有指定文本大小类型的文本组件设置文本大小。 |
| void | setTextWidth(int width) | 设置此文本的确切宽度。 |
| void | setTextWidthInEms(int ems) | 设置此文本的宽度，以 em 为单位。 |
| void | setTruncationMode(Text.TruncationMode mode) | 当文本内容长于组件宽度时设置截断模式。 |
| void | startAutoScrolling() | 开始文本自动滚动。 |
| void | stopAutoScrolling() | 停止文本自动滚动。 |
| void | unlockEditingState() | 解锁输入法并结束文本编辑。 |
| 从类 ohos.agp.components.Component 继承的方法 |
|---|
| addDrawTask, addDrawTask, addScrolledListener, announceAccessibility, arrange, bindCornerMark, callOnClick, canScroll, clearFocus, createAnimatorProperty, disableFadeEffect, dispatchRestoreState, dispatchSaveState, draw, enableCornerMark, enableFadeEffect, enableSaveState, enableScrollBar, estimateSize, executeDoubleClick, executeLongClick, findComponentById, findComponentHolderById, findFocus, findNextFocusableComponent, findRequestNextFocus, getAccessibility, getAccessibilityDescription, getAlpha, getAltitude, getBackgroundElement, getBaseLine, getBottom, getBoundaryFadeEffectBottomRate, getBoundaryFadeEffectLeftRate, getBoundaryFadeEffectRightRate, getBoundaryFadeEffectTopRate, getCenterZoomFactor, getCentralScrollMode, getClickedListener, getClipEnabled, getComponentDescription, getComponentMinSize, getComponentParent, getComponentPosition, getComponentSize, getComponentStateChangedListener, getComponentTreeObserver, getContentEnable, getContentPosition, getContentPositionX, getContentPositionY, getContext, getContour, getContourRefreshedListener, getCornerMark, getDragAcceptAngle, getDraggedListener, getEditEventListener, getEstimatedHeight, getEstimatedWidth, getFadeEffectColor, getFocusable, getFocusBorderEnable, getFocusBorderPadding, getFocusBorderRadius, getFocusBorderWidth, getForegroundElement, getForegroundGravity, getForwardHoverListener, getForwardTouchListener, getGesturePriority, getHeight, getHorizontalPadding, getHorizontalPosition, getHoverEventListener, getId, getKeyEventListener, getLayoutConfig, getLayoutDirection, getLayoutDirectionResolved, getLayoutRefreshedListener, getLeft, getLocationOnScreen, getMarginBottom, getMarginLeft, getMarginRight, getMargins, getMarginsLeftAndRight, getMarginsTopAndBottom, getMarginTop, getMatrix, getMinHeight, getMinWidth, getMode, getModeResolved, getMouseEventListener, getMousePointerStyleListener, getName, getPadding, getPaddingBottom, getPaddingEnd, getPaddingLeft, getPaddingRight, getPaddingStart, getPaddingTop, getPivot, getPivotX, getPivotY, getResourceManager, getRight, getRotation, getRotationEventListener, getRotationSensitivity, getScale, getScaledListener, getScaleX, getScaleY, getScrollbarBackgroundColor, getScrollbarColor, getScrollbarFadingDelay, getScrollbarFadingDuration, getScrollBarMode, getScrollbarRadius, getScrollbarRoundRect, getScrollbarStartAngle, getScrollbarSweepAngle, getScrollbarThickness, getScrollState, getScrollValue, getSelfVisibleRect, getShadowColor, getSpeechEventListener, getTag, getTop, getTouchEventListener, getTransitionSymbol, getTranslation, getTranslationX, getTranslationY, getTranslationZ, getUserNextFocus, getVerticalPadding, getVerticalPosition, getVisibility, getVisibleRectOnScreen, getWidth, getWindowVisibleRect, hasFocus, hasFocusedEffect, hasOverlaps, hideFocusBorder, informConfigurationChanged, invalidate, isBoundaryFadeEffectEnable, isBoundToWindow, isClickable, isClipToContourEnabled, isComponentDisplayed, isEnabled, isFadeEffected, isFocusable, isFocused, isIdentityMatrix, isLongClickOn, isPressed, isRtl, isSaveStateEnabled, isScrollbarFadingOn, isScrollBarOn, isScrollbarOverlapEnabled, isSelected, isSoundEnable, isTouchFocusable, isVibrationEffectEnabled, notifyAccessibility, onAttributeConfigChanged, onDrag, onRestoreState, onSaveState, performScale, playSound, postLayout, refreshContour, release, removeBindStateChangedListener, removeScrolledListener, requestFocus, requestForceForwardTouchEvent, restoreComponentTreeState, saveComponentTreeState, scrollBy, scrollTo, setAccessibility, setAccessibilityDescription, setAlpha, setAltitude, setBackground, setBindStateChangedListener, setBottom, setBoundaryFadeEffectEnable, setCanAcceptScrollListener, setCenterZoomFactor, setCentralScrollMode, setClickable, setClickedListener, setClipEnabled, setClipToContourEnabled, setComponentDescription, setComponentMinSize, setComponentPosition, setComponentPosition, setComponentSize, setComponentStateChangedListener, setContentEnable, setContentPosition, setContentPositionX, setContentPositionY, setContour, setContourRefreshedListener, setDoubleClickedListener, setDragAcceptAngle, setDraggedListener, setEditEventListener, setEnabled, setEstimatedSize, setEstimateSizeListener, setFadeEffectColor, setFocusable, setFocusBorderEnable, setFocusBorderPadding, setFocusBorderRadius, setFocusBorderRadius, setFocusBorderWidth, setFocusChangedListener, setFocusedEffect, setForeground, setForegroundGravity, setForwardHoverListener, setForwardTouchListener, setGesturePriority, setHeight, setHorizontalPadding, setHorizontalPosition, setHoverEventListener, setId, setKeyEventListener, setLayoutConfig, setLayoutDirection, setLayoutRefreshedListener, setLeft, setLongClickable, setLongClickedListener, setMarginBottom, setMarginLeft, setMarginRight, setMarginsLeftAndRight, setMarginsTopAndBottom, setMarginTop, setMinHeight, setMinWidth, setMode, setMouseEventListener, setMousePointerStyleListener, setName, setOnDragListener, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRelative, setPaddingRight, setPaddingTop, setPivot, setPivot, setPivotX, setPivotY, setPosition, setPositionX, setPositionY, setPressState, setRight, setRotation, setRotationEventListener, setRotationSensitivity, setScale, setScaledListener, setScaleX, setScaleY, setScrollbarBackgroundColor, setScrollbarColor, setScrollbarFadingDelay, setScrollbarFadingDuration, setScrollbarFadingEnabled, setScrollBarMode, setScrollbarOverlapEnabled, setScrollbarRadius, setScrollbarRoundRect, setScrollbarStartAngle, setScrollbarSweepAngle, setScrollbarThickness, setScrolledListener, setSelected, setShadowColor, setShadowStyle, setSoundEnable, setSpeechEventListener, setTag, setTop, setTouchEventListener, setTouchFocusable, setTransitionSymbol, setTranslation, setTranslationX, setTranslationY, setTranslationZ, setUnconsumedKeyEventListener, setUserNextFocus, setVerticalPadding, setVerticalPosition, setVibrationEffectEnabled, setVisibility, setWidth, showFocusBorder, simulateClick, simulateDrag, startDragAndDrop, subscribeVoiceEvents, unsubscribeVoiceEvents |
| 从类 java.lang.Object 继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
public static final int AUTO_CURSOR_POSITION
表示光标所在的位置。
public static final int AUTO_SCROLLING_FOREVER
表示文本将始终处于自动滚动状态。
public Text(Context context)
默认构造函数用于使用默认属性集和样式创建 Text 实例。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
public Text(Context context, AttrSet attrSet)
用于在 XML 文件解析后使用指定的属性集和默认样式创建 Text 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
public Text(Context context, AttrSet attrSet, String styleName)
用于在 XML 文件解析后使用指定的属性集和指定的样式创建 Text 实例的构造函数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| context | 指示应用程序上下文。 |
| attrSet | 指示要使用的属性集。 |
| styleName | 指示要使用的样式名称。 |
public void addTextObserver(Text.TextObserver observer)
添加文本观察器 TextObserver 以检测文本是否更改。
在使用 TextObserver 之前，您必须实现 TextObserver#onTextUpdated。
参数：
| 参数名称 | 参数描述 |
|---|---|
| observer | 指示要添加的文本观察者。 |
public void removeTextObserver(Text.TextObserver observer)
删除文本观察者 TextObserver。
参数：
| 参数名称 | 参数描述 |
|---|---|
| observer | 指示要删除的文本观察者。 |
public void setEditorActionListener(Text.EditorActionListener listener)
为组件中的编辑器操作注册一个侦听器。
参数：
| 参数名称 | 参数描述 |
|---|---|
| listener | 指示编辑器操作的侦听器。 |
public void setFont(Font font)
设置文本字体。
参数：
| 参数名称 | 参数描述 |
|---|---|
| font | 表示文本字体。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果文本字体为空，则引发异常。 |
public Font getFont()
获取文本字体。
返回:
返回文本字体。
public void setTruncationMode(Text.TruncationMode mode)
当文本内容长于组件宽度时设置截断模式。
当文本组件不能在一行中显示所有文本内容时，可以选择以下模式：（1）文本的开头、中间或结尾被截断，截断部分显示为省略号，（2 ) 文本将滚动显示完整内容或 (3) 直接截断，无需任何特殊处理。
参数：
| 参数名称 | 参数描述 |
|---|---|
| mode | 表示截断模式。 |
public Text.TruncationMode getTruncationMode()
获取截断模式。
返回:
返回截断模式； 如果未设置模式，则返回 TruncationMode#NONE。
public void setInputMethodOption(int option)
设置文本的输入法选项。
参数：
| 参数名称 | 参数描述 |
|---|---|
| option | 表示文本的输入法选项。 |
public int getInputMethodOption()
获取文本的输入法选项。
返回:
返回文本的输入法选项。
public void setAutoFontSizeRule(int minFontSize, int maxFontSize, int autoFontStep)
设置自动字体大小的范围和步长。
最小字体大小必须小于最大字体大小，并且字体大小步长必须大于 0。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minFontSize | 指示最小自动字体大小。 |
| maxFontSize | 指示最大自动字体大小。 |
| autoFontStep | 指示自动字体大小步长。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果最小或最大字体大小值小于 0 或步长小于 0，则引发异常。 |
public void setAutoFontSizeRule(int[] preSet)
设置所有可能的自动字体大小的数组。
参数：
| 参数名称 | 参数描述 |
|---|---|
| preSet | 指示所有可能的自动字体大小的数组。 |
public int[] getAutoFontSizeRule()
获取自动调整大小的规则。
返回:
返回规则。
Since:
7
public boolean isAutoFontSize()
获取是否自动调整文本大小以填充在组件内。
返回:
如果自动调整文本大小以填充组件，则返回 true； 否则返回 false。
public int getMinAutoFontSize()
获取自动调整大小所允许的最小文本大小。
返回:
如果获得，则返回最小文本大小（以像素为单位）； 如果未配置自动调整大小，则返回 0。
Since:
7
public int getMaxAutoFontSize()
获取自动调整大小允许的最大文本大小。
返回:
如果获得，则返回最大文本大小（以像素为单位）； 如果未配置自动调整大小，则返回 0。
Since:
7
public int getAutoFontSizeStep()
获取自动调整大小的步骤。
返回:
如果获得，则返回步骤； 如果未配置自动调整大小，则返回 0。
Since:
7
public float getTextHorizontalScale()
获取此 Text 的水平乘数。
默认水平乘数为 1.0。
返回:
返回水平乘数。
Since:
7
public void setTextHorizontalScale(float ratio)
设置此文本的水平乘数。
默认水平乘数为 1.0。
参数：
| 参数名称 | 参数描述 |
|---|---|
| ratio | 指示要设置的水平乘数。 |
Since:
7
public void setTextWidth(int width)
设置此文本的确切宽度。
设置此值会覆盖之前的最小或最大宽度配置。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 指示要设置的确切宽度。 |
Since:
7
public void setMinTextWidth(int minWidth)
设置此文本的最小宽度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minWidth | 指示要设置的最小宽度。 |
Since:
7
public int getMinTextWidth()
获取此 Text 的最小宽度。
返回:
返回此文本的最小宽度。
Since:
7
public void setAutoScrollingDuration(long duration)
设置长文本的自动滚动持续时间。
在启用自动滚动之前，您必须在文本上使用此方法。 自动滚动持续时间必须大于或等于 0，以毫秒为单位。 如果持续时间设置为 0，则使用默认滚动速度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| duration | 指示文本组件的自动滚动持续时间。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则引发异常。 |
public long getAutoScrollingDuration()
获取文本的自动滚动时长。
返回:
如果可用，则返回为此文本设置的自动滚动持续时间； 否则返回 0。
public void setAutoScrollingCount(int count)
设置文本的自动滚动计数。
在启用自动滚动之前，您必须在文本上使用此方法。
参数：
| 参数名称 | 参数描述 |
|---|---|
| count | 表示文本的自动滚动次数，必须大于等于1，或者AUTO_SCROLLING_FOREVER，表示文本组件永远处于自动滚动状态。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值无效，则引发异常。 |
public int getAutoScrollingCount()
获取文本的自动滚动次数。
返回:
返回文本的自动滚动计数。
public void startAutoScrolling()
开始文本自动滚动。
public void stopAutoScrolling()
停止文本自动滚动。
public void setCursorElement(Element element)
设置此 Text 中光标的 Element 对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要设置的 Element 对象。 |
public void setCursorElement(int resId)
为文本中的光标设置元素对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 表示文本中光标所在的 Element 资源 id。 |
Since:
7
public void setAutoCursorAdjustmentEnabled(boolean isAutoMove)
将光标设置为自动移动。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isAutoMove | 指定光标滚动到视线之外时是否会自动移动到可见位置。 值 true 表示光标会自动移动到可见位置，false 表示相反。 |
Since:
7
public Element getCursorElement()
获取文本中光标的元素对象。
返回:
返回文本中光标的元素对象。
public void setAroundElements(Element left, Element top, Element right, Element bottom)
围绕文本设置元素对象。
此方法将元素对象放置在文本的左侧、顶部、右侧和底部。 元素对象的边由文本的阅读方式决定。
注意：如果未设置元素的边界，则此方法将其设置为最佳尺寸。
参数：
| 参数名称 | 参数描述 |
|---|---|
| left | 指示文本左侧的元素对象。 |
| top | 指示元素对象位于文本的顶部。 |
| right | 指示文本右侧的元素对象。 |
| bottom | 指示文本底部的元素对象。 |
public Element[] getAroundElements()
获取文本周围的元素对象。
文本左侧、顶部、右侧和底部的元素对象按顺序返回。
返回:
返回文本周围的元素对象。
public Element getLeftElement()
获取文本左侧的元素。
元素是指围绕文本的图形材料。
返回:
返回左侧元素。
Since:
4
public Element getRightElement()
获取文本右侧的元素。
元素是指围绕文本的图形材料。
返回:
返回正确的元素。
Since:
4
public Element getTopElement()
获取文本顶部的元素。
元素是指围绕文本的图形材料。
返回:
返回顶部元素。
Since:
4
@Deprecated public Element getBottonElement()
已弃用。 此更改从 API 版本 8 开始生效。由 getBottomElement() 替换。
获取文本底部的元素。
元素是指围绕文本的图形材料。
返回:
返回底部元素。
Since:
4
public Element getBottomElement()
获取文本底部的元素。
元素是指围绕文本的图形材料。
返回:
返回底部元素。
Since:
7
public Element getStartElement()
获取文本周围的起始元素。
元素是指围绕文本的图形材料。
返回:
返回起始元素。
Since:
4
public Element getEndElement()
获取文本周围的结束元素。
元素是指围绕文本的图形材料。
返回:
返回结束元素。
Since:
4
public void setAroundElementsRelative(Element start, Element top, Element end, Element bottom)
围绕文本设置元素对象。
注意：如果未设置元素的边界，则此方法将其设置为最佳尺寸。
参数：
| 参数名称 | 参数描述 |
|---|---|
| start | 指示文本开头的元素对象，如果文本从左侧开始，则在文本的左侧，反之亦然。 |
| top | 指示元素对象位于文本的顶部。 |
| end | 表示文本末尾的元素对象，如果文本从右开始，则在文本的左侧，反之亦然。 |
| bottom | 指示文本底部的元素对象。 |
public Element[] getAroundElementsRelative()
获取文本周围的元素对象。
文本开头、顶部、末尾和底部的元素对象按顺序返回。
返回:
返回文本周围的元素对象。
public void setAroundElementsPadding(int padding)
设置文本和元素对象之间的填充。
参数：
| 参数名称 | 参数描述 |
|---|---|
| padding | 指示文本和元素对象之间的填充。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则引发异常。 |
public int getAroundElementsPadding()
获取文本和元素对象之间的填充。
返回:
返回文本和元素对象之间的填充。
public void setTextInputType(int inputType)
设置 Text 的文本输入类型。
参数：
| 参数名称 | 参数描述 |
|---|---|
| inputType | 指示文本输入类型，如 InputAttribute 中所枚举。 |
public int getTextInputType()
获取Text的文本输入类型。
返回:
返回文本输入类型，如 InputAttribute 中所枚举。
public void setRichText(RichText richText)
设置要在文本组件中显示的富文本。
文本组件可以显示富文本或普通文本。 最新配置生效。
参数：
| 参数名称 | 参数描述 |
|---|---|
| richText | 指示要在文本组件中显示的富文本。 |
Since:
3
public RichText getRichText()
获取文本组件中显示的富文本。
返回:
返回文本组件中显示的富文本。
Since:
3
public void setText(String text)
设置要在文本组件中显示的文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| text | 指示要在文本组件中显示的文本。 |
public void setText(int resId)
设置要显示的文本的资源 ID。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 表示文本的资源ID。 |
Since:
3
public String getText()
获取文本组件中显示的文本。
返回:
返回文本组件中显示的文本。
public void setHint(String hint)
设置文本为空时显示的提示文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| hint | 指示文本为空时要显示的提示文本。 |
public void setHint(int resId)
设置此 Text 为空时显示的提示文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 指示提示文本的资源 ID。 |
Since:
7
public String getHint()
获取文本为空时显示的提示文本。
返回:
返回文本为空时要显示的提示文本。
public String getEditableString()
获取可编辑文本组件中的文本。 如果文本组件不可编辑，则返回 null。
返回:
返回可编辑文本组件中的文本。
Since:
4
public boolean isEditable()
检查此文本是否可编辑。
返回:
如果文本是可编辑的，则返回 true； 否则返回 false。
Since:
7
public void setTextSize(int size)
为文本设置指定的字体大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| size | 指示要设置的字体大小。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 size 参数值小于 0，则引发异常。 |
Since:
3
public void setTextSize(int size, Text.TextSizeType textSizeType)
为具有指定文本大小类型的文本组件设置文本大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| size | 指示文本组件的文本大小。 |
| textSizeType | 指示文本大小的类型。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 size 参数值小于 0，则引发异常。 |
Since:
4
public int getTextSize()
获取文本组件的文本大小。
返回:
返回文本大小。
public int getTextSize(Text.TextSizeType textSizeType)
获取文本的字体大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| textSizeType | 表示文本大小的单位。 |
返回:
返回字体大小。
Since:
4
public void setTextColor(Color color)
设置文本组件的文本颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示文本颜色。 |
public Color getTextColor()
获取文本组件的文本颜色。
返回:
返回文本颜色。
public void setHintColor(Color color)
设置文本组件中提示文本的颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示文本组件中提示文本的颜色。 |
Since:
4
public Color getHintColor()
获取文本组件中提示文本的颜色。
返回:
返回文本组件中提示文本的颜色。
Since:
4
public void setTextAlignment(int textAlignment)
设置文本组件中的文本对齐方式。
参数：
| 参数名称 | 参数描述 |
|---|---|
| textAlignment | 表示文本组件中的文本对齐方式TextAlignment。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值与 TextAlignment 不对应，则引发异常。 |
public int getTextAlignment()
获取文本组件中的文本对齐方式。
返回:
返回文本对齐方式 TextAlignment。
public void setTextCursorVisible(boolean visible)
设置光标对于可编辑文本组件是否可见。
参数：
| 参数名称 | 参数描述 |
|---|---|
| visible | 指示光标对于可编辑的文本组件是否可见。 true 表示可见； false 表示不可见。 |
Since:
4
public boolean isTextCursorVisible()
获取光标对于可编辑文本组件是否可见。
返回:
如果光标对可编辑文本组件可见，则返回 true； 否则返回 false。
Since:
4
public int length()
获取文本组件中允许的文本长度。
返回:
返回文本组件中允许的文本长度。
public void append(String text)
将文本字符串附加到文本组件中的现有文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| text | 指示要附加的文本字符串。 |
public void insert(String text)
在光标所在位置插入文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| text | 指示要插入的文本。 |
Since:
2
public void insert(String text, int pos)
在指定位置插入文本。 如果 pos 为 AUTO_CURSOR_POSITION，则将文本插入到光标所在的位置。
参数：
| 参数名称 | 参数描述 |
|---|---|
| text | 指示要插入的文本。 |
| pos | 指示插入文本的位置。 AUTO_CURSOR_POSITION 值表示从光标所在位置插入文本。 |
Since:
2
public void delete(int length)
删除光标前的文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| length | 指示要删除的文本的长度。 |
Since:
2
public void delete(int length, boolean back)
删除光标之前或之后的文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| length | 指示要删除的文本的长度。 |
| back | 指示是否以向后的方式删除文本。 true 表示删除光标前的文本； false 表示删除光标后的文本。 |
Since:
2
public void delete(int length, boolean back, int pos)
从指定位置删除文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| length | 指示要删除的文本的长度。 |
| back | 指示是否以向后的方式删除文本。 true 表示删除指定位置之前的文本； false 表示删除指定位置之后的文本。 |
| pos | 指示要删除文本的位置。 AUTO_CURSOR_POSITION 值表示从光标所在位置删除文本。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则引发异常。 |
Since:
2
public void setMultipleLine(boolean multiple)
设置文本是否在文本组件中多行显示。
参数：
| 参数名称 | 参数描述 |
|---|---|
| multiple | 指示文本是否以多行显示。 true 表示文本多行显示； false 表示文本不显示在多行中。 |
public boolean isMultipleLine()
获取文本是否在文本组件中多行显示。
返回:
如果文本以多行显示，则返回 true； 否则返回 false。
public void setMaxTextLines(int maxLines)
设置文本组件中允许的最大行数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| maxLines | 指示文本组件中允许的最大行数。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于或等于 0，则引发异常。 |
Since:
4
public int getMaxTextLines()
获取文本组件中允许的最大行数。
返回:
返回文本组件中允许的最大行数。
Since:
4
public void setScrollable(boolean scrollable)
设置文本是否可滚动。
参数：
| 参数名称 | 参数描述 |
|---|---|
| scrollable | 指示文本是否可滚动。 true 表示文本是可滚动的； false 表示文本不可滚动。 |
public boolean isScrollable()
获取文本在文本组件中是否可滚动。 true 表示文本是可滚动的； false 表示文本不可滚动。
返回:
如果文本是可滚动的，则返回 true； 否则返回 false。
public void setAutoFontSize(boolean autoFontSize)
设置是否自动调整文本大小以填充组件。
参数：
| 参数名称 | 参数描述 |
|---|---|
| autoFontSize | 指示是否自动调整文本大小以填充组件。 true 表示自动调整文本大小以填充到组件内； false 表示不会自动调整文本大小以填充组件。 |
public void setAutoFontSize(boolean autoFontSize, boolean userSizeFirst)
设置是否自动调整字体大小以填充组件内，以及是否在启用自动字体大小适应之前尝试指定的字体大小。
建议您在启用 userSizeFirst 之前启用 autoFontSize。
参数：
| 参数名称 | 参数描述 |
|---|---|
| autoFontSize | 指示是否启用自动字体大小调整。 true 表示自动调整字体大小以填充到组件内，以便显示完整的文本内容； false 表示相反。 |
| userSizeFirst | userSizeFirst 指示是否在启用自动字体大小调整之前尝试指定的字体大小。 true 表示为布局尝试指定的字体大小。 如果指定的字体大小不允许在组件中显示所有文本内容，则会选择由 setAutoFontSizeRule(int,int,int) 设置的合适字体大小。 false 表示由 setAutoFontSizeRule(int,int ,int) 设置的合适字体大小将直接用于布局，而不尝试指定的字体大小。 |
Since:
3
public void setLineSpacing(float add, float mult)
设置文本组件的行距。
每条线的高度乘以 mult，并加上 add。 例如，当height为1，mult为2，add为3时，行距为5。
参数：
| 参数名称 | 参数描述 |
|---|---|
| add | 表示要添加到除最后一行之外的每一行的高度的值。 |
| mult | 表示要乘以每行高度的值，最后一行除外。 |
public float getNumOfFontHeight()
获取行距乘数，它在文本组件中的行之间提供额外的间距。
返回:
返回行距乘数。
Since:
4
public float getAdditionalLineSpacing()
获取添加到文本组件中每行高度的额外间距。
返回:
返回添加到每行高度的额外间距。
Since:
4
public boolean isAdjustInputPanel()
获取在弹出输入法面板时是否开启自动文本组件重新布局。
返回:
如果启用了自动文本组件重新布局，则返回 true； 否则返回 false。
Since:
3
public void setAdjustInputPanel(boolean adjust)
设置当软输入面板弹出或隐藏时布局是否应调整大小。
参数：
| 参数名称 | 参数描述 |
|---|---|
| adjust | 指示布局是否应调整可编辑文本组件的大小。 true 表示调整大小； false 表示不是。 |
public void setMaxTextHeight(int maxTextHeight)
设置文本的最大高度。
此方法用于将文本高度设置为 MATCH_CONTENT 的情况。
参数：
| 参数名称 | 参数描述 |
|---|---|
| maxTextHeight | 指示文本的最大高度。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则引发异常。 |
Since:
4
public int getMaxTextHeight()
获取文本的最大高度。
返回:
返回文本的最大高度。
Since:
4
public void setMinTextHeight(int minHeight)
设置此文本的最小高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minHeight | 指示要设置的最小高度。 |
Since:
7
public void setMaxTextWidth(int maxTextWidth)
设置文本的最大宽度。
此方法用于将文本宽度设置为 MATCH_CONTENT 的情况。
参数：
| 参数名称 | 参数描述 |
|---|---|
| maxTextWidth | 指示文本的最大宽度。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值小于 0，则引发异常。 |
Since:
4
public int getMaxTextWidth()
获取文本的最大宽度。
返回:
返回文本的最大宽度。
Since:
4
protected void onRtlChanged(Component.LayoutDirection layoutDirection)
从类复制的描述：组件
在更改任何 RTL 属性时调用。
覆盖：
类组件中的 onRtlChanged
参数：
| 参数名称 | 参数描述 |
|---|---|
| layoutDirection | 表示当前布局方向的值。 |
public void setBubbleSize(int width, int height)
设置显示文本的气泡框的宽度和高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 指示要设置的气泡框的宽度，以像素为单位。 |
| height | 指示要设置的气泡框的高度，以像素为单位。 |
Since:
4
public void setBubbleWidth(int width)
设置文本气泡框的宽度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 表示要设置的宽度。 |
Since:
4
public void setBubbleHeight(int height)
设置文本气泡框的高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| height | 表示要设置的高度。 |
Since:
4
public int getBubbleWidth()
获取文本气泡框的宽度。
返回:
返回气泡框的宽度。
Since:
4
public int getBubbleHeight()
获取文本气泡框的高度。
返回:
返回气泡框的高度。
Since:
4
public void setLeftBubbleSize(int width, int height)
设置显示文本的气泡框左侧填充区域的宽度和高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 指示要设置的气泡框的宽度，以像素为单位。 |
| height | 指示要设置的气泡框的高度，以像素为单位。 |
Since:
4
public void setLeftBubbleWidth(int width)
设置文本左侧气泡框的宽度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 表示要设置的宽度。 |
Since:
4
public void setLeftBubbleHeight(int height)
设置文本左侧气泡框的高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| height | 表示要设置的高度。 |
Since:
4
public int getSelectionLeftBubbleWidth()
获取所选气泡框左侧填充区域的宽度。
返回:
返回宽度。
Since:
4
public int getSelectionLeftBubbleHeight()
获取所选气泡框左侧填充区域的高度。
返回:
返回高度。
Since:
4
public void setRightBubbleSize(int width, int height)
设置显示文本的气泡框右侧填充区域的宽度和高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 指示要设置的气泡框的宽度，以像素为单位。 |
| height | 指示要设置的气泡框的高度，以像素为单位。 |
Since:
4
public void setRightBubbleWidth(int width)
设置文本右侧气泡框的宽度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 表示要设置的宽度。 |
Since:
4
public void setRightBubbleHeight(int height)
设置文本右侧气泡框的高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| height | 表示要设置的高度。 |
Since:
4
public int getSelectionRightBubbleWidth()
获取所选气泡框右侧填充区域的宽度。
返回:
返回宽度。
Since:
4
public int getSelectionRightBubbleHeight()
获取所选气泡框右侧填充区域的高度。
返回:
返回高度。
Since:
4
public void setSelectionColor(Color color)
设置选定文本的颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 指示要设置的选定文本的颜色。 |
Since:
4
public Color getSelectionColor()
获取选定文本的颜色。
返回:
返回所选文本的颜色。
Since:
4
public int getSelectionStart()
获取选择边的起点。
返回:
返回选择边缘的起点。
Since:
7
public int getSelectionEnd()
获得选择边的结束。
返回:
返回选择边缘的结束。
Since:
7
public boolean setSelection(int start, int end)
设置此文本的选择范围。
参数：
| 参数名称 | 参数描述 |
|---|---|
| start | 指示选择范围的起始位置。 |
| end | 指示选择范围的结束位置。 |
返回:
如果选择范围设置成功，则返回 true； 否则返回 false。
Since:
7
public void setBubbleElement(Element element)
为光标所在的气泡设置一个 Element 对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要设置的 Element 对象。 |
Since:
4
public void setBubbleElement(int resId)
为光标所在的气泡设置一个 Element 对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 指示元素的资源ID。 |
Since:
7
public void setSelectionLeftBubbleElement(Element element)
设置要为左侧气泡显示的元素对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要显示的元素。 |
Since:
4
public void setSelectionLeftBubbleElement(int resId)
设置要为左侧气泡显示的元素对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 指示左气泡元素的资源 ID。 |
Since:
7
public void setSelectionRightBubbleElement(Element element)
设置要为右侧气泡显示的元素对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| element | 指示要显示的元素。 |
Since:
4
public void setSelectionRightBubbleElement(int resId)
设置要为右侧气泡显示的元素对象。
参数：
| 参数名称 | 参数描述 |
|---|---|
| resId | 表示右Bubble元素的资源ID。 |
Since:
7
public Element getBubbleElement()
获取光标所在气泡框的Element对象。
返回:
返回元素对象。
Since:
4
public Element getSelectionLeftBubbleElement()
获取显示在选中气泡框左侧内边距区域的 Element 对象。
返回:
返回元素对象。
Since:
4
public Element getSelectionRightBubbleElement()
获取显示在选中气泡框右侧内边距区域的 Element 对象。
返回:
返回元素对象。
Since:
4
public boolean setCursorPosition(int position)
设置文本的光标位置。
参数：
| 参数名称 | 参数描述 |
|---|---|
| position | 光标位置的偏移量。 |
返回:
成功设置为 true，否则为 false。
Since:
7
public void setFadeEffectBoundaryWidth(int width)
设置文本的淡入淡出效果区域的边界宽度。
覆盖：
类 Component 中的 setFadeEffectBoundaryWidth
参数：
| 参数名称 | 参数描述 |
|---|---|
| width | 指示要设置的边界宽度，以像素为单位。 |
Since:
4
public int getFadeEffectBoundaryWidth()
获取文本淡化效果区域的边界宽度。
覆盖：
类 Component 中的 getFadeEffectBoundaryWidth
返回:
返回文本淡入淡出区域的边界宽度。
Since:
4
public void setPaddingForText(boolean hasPadding)
设置文本是否有额外的填充空间。
此方法仅对单行文本有效。
参数：
| 参数名称 | 参数描述 |
|---|---|
| hasPadding | 指定文本是否有额外的填充空间。 true 表示文本的高度在上下边框之间，false 表示高度在字体上升和下降之间。 |
Since:
4
public boolean getPaddingForText()
检查文本是否有额外的填充空间。
返回:
如果文本的高度在上下边框之间，则返回 true； 如果高度在字体上升和下降之间，则返回 false。
Since:
4
public String getFontVariations()
获取字体变化设置。
返回:
如果获得，则返回当前的字体变化设置； 如果未指定任何字符串，则返回一个空字符串。
Since:
5
public boolean setFontVariations(String variation)
设置 TrueType 或 OpenType 字体变体设置。 设置字符串由多对标签和样式值组成。 标签必须包含精确的四个 ASCII 字符，并且必须用单引号或双引号括起来。 如果包含 U+0020..U+007E 以外的字符，则无效。 如果指定的标签名称尚未在字体中定义，则设置将被忽略。
下面显示了将字体宽度和粗细设置为 100 的示例代码。
text.setFontVariations("'wdth' 100,'wght' 100"); 参数:
| 参数名称 | 参数描述 |
|---|---|
| variation | 表示字体变化设置。 |
返回:
如果传递的变体对当前字体有效，则返回 true； 如果传递的变体是空字符串或不符合定义的规范，则返回 false。
Since:
5
public int getLineCount()
获取此文本中的行数。
返回:
返回行数。
Since:
7
public int getLineHeight()
获取此 Text 的行间高度。
返回:
返回行之间的高度。
Since:
7
public int getCombinedPaddingStart()
获取此文本开头的组合填充。
如果文本以组件开头，则组合内边距包括组件的宽度和组件内边距。
返回:
返回文本开头的组合填充，以像素为单位。
Since:
7
public int getCombinedPaddingTop()
获取此文本顶部的组合填充。
如果文本顶部有组件，则组合的 padding 包括组件的高度和组件的 padding。
返回:
返回文本顶部的组合填充，以像素为单位。
Since:
7
public int getCombinedPaddingEnd()
获取文本末尾的组合填充。
如果文本末尾有组件，则组合填充包括组件的宽度和组件填充。
返回:
返回文本末尾的组合填充，以像素为单位。
Since:
7
public int getCombinedPaddingBottom()
获取此文本底部的组合填充。
如果文本底部有组件，则组合的 padding 包括组件的高度和组件的 padding。
返回:
返回文本底部的组合填充，以像素为单位。
Since:
7
public int getCombinedPaddingLeft()
获取此文本左侧的组合填充。
如果文本左侧有组件，则合并的 padding 包括组件的宽度和组件的 padding。
返回:
返回文本左侧的组合填充，以像素为单位。
Since:
7
public int getCombinedPaddingRight()
获取此文本右侧的组合填充。
如果文本右侧有组件，则组合的 padding 包括组件的宽度和组件的 padding。
返回:
返回文本右侧的组合填充，以像素为单位。
Since:
7
public int getTextToTopSpace()
获取显示的文本顶部到文本组件顶部的距离。
返回:
返回从显示文本顶部到文本组件顶部的距离，以像素为单位。
Since:
7
public int getTextToBottomSpace()
获取显示的文本底部到文本组件底部的距离。
返回:
返回从显示文本底部到文本组件底部的距离，以像素为单位。
Since:
7
public void setHyperLinkColor(Color color)
设置文本中链接的颜色。
参数：
| 参数名称 | 参数描述 |
|---|---|
| color | 文本链接的颜色。 |
Since:
7
public void setHyperLinkClickable(boolean isClickable)
设置此文本中超链接的可点击性。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isClickable | 指定是否将超链接设置为可单击。 值 true 表示将超链接设置为可点击，false 表示相反。 |
Since:
7
public boolean isHyperLinkClickable()
检查此文本中的超链接是否可单击。
返回:
如果超链接是可点击的，则返回 true； 否则返回 false。
Since:
7
public ListUrlRichStyle getUrls()
获取此文本中的超链接列表。
返回:
返回超链接列表。
Since:
7
public Locale getPrimaryLocale()
获取此文本的默认语言环境。
返回:
返回此文本的默认语言环境。
Since:
7
public void setPrimaryLocale(Locale locale)
设置用于绘制此文本的区域设置。
参数：
| 参数名称 | 参数描述 |
|---|---|
| locale | 指示要设置的区域设置。 该值不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 locale 的值为 null，则引发此异常。 |
Since:
7
public LocaleProfile getLocales()
获取此 Text 的默认 LocaleProfile。
返回:
返回此文本的默认 LocaleProfile。
Since:
7
public void setLocales(LocaleProfile locales)
设置用于绘制此文本的 LocaleProfile。
参数：
| 参数名称 | 参数描述 |
|---|---|
| locales | 表示一组语言环境。 该值不能为空。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 locales 的值为 null，则引发此异常。 |
Since:
7
public LocaleProfile getInputMethodLocales()
获取此文本的建议 LocaleProfile。
返回:
如果获得，则返回建议的 LocaleProfile； 如果没有配置建议的 LocaleProfile，则返回 null。
Since:
7
public void setInputMethodLocales(LocaleProfile locales)
为此文本设置建议的 LocaleProfile。
当此文本具有焦点时，建议的语言环境信息将报告给输入法。
参数：
| 参数名称 | 参数描述 |
|---|---|
| locales | 指示要设置的建议 LocaleProfile。 |
Since:
7
public String getFontFeatures()
获取字体功能设置。
格式与 CSS font-feature-settings 属性的格式相同。
返回:
返回当前字体功能设置。
Since:
7
public void setFontFeatures(String settings)
设置字体特征。
格式与 CSS font-feature-settings 属性的格式相同。
参数：
| 参数名称 | 参数描述 |
|---|---|
| settings | 指示由 CSS 兼容字符串表示的字体功能设置。 |
Since:
7
public Color getTextShadowColor()
获取文本阴影的颜色。
返回:
文本阴影的颜色。
Since:
7
public void setTextShadow(float offsetX, float offsetY, float radius, Color color)
设置此文本的阴影。
参数：
| 参数名称 | 参数描述 |
|---|---|
| offsetX | 文字阴影的水平偏移。 |
| offsetY | 文字阴影的垂直偏移。 |
| radius | 文字阴影的模糊半径。 |
| color | 指示要设置的阴影颜色。 |
Since:
7
public float getTextShadowOffsetX()
获取文本阴影的水平偏移量。
返回:
文字阴影的水平偏移。
Since:
7
public float getTextShadowOffsetY()
获取文本阴影的垂直偏移量。
返回:
文字阴影的垂直偏移。
Since:
7
public float getTextShadowRadius()
获取文本阴影的模糊半径。
返回:
文字阴影的模糊半径。
Since:
7
public void setHyphenationStrategy(TextLayout.HyphenationStrategy strategy)
设置此文本的自动断字策略。
参数：
| 参数名称 | 参数描述 |
|---|---|
| strategy | 表示要设置的自动断字策略。 |
Since:
7
public TextLayout.HyphenationStrategy getHyphenationStrategy()
获取该文本的自动断字策略。
返回:
返回自动断字的策略。
Since:
7
public boolean moveToPosition(int offset)
根据指定的偏移量将字符移动到可见位置。
此方法用于滚动文本。 如果文本没有滚动，则返回 false。
参数：
| 参数名称 | 参数描述 |
|---|---|
| offset | 表示字符位置的偏移量。 偏移值只能是非负整数，任何负数都被视为 0。 |
返回:
如果文本滚动，则返回 true； 否则返回 false。
Since:
7
public float getLetterSpacing()
获取文本字母之间的间距。
返回:
返回文本字母之间的间距。
Since:
7
public int getBaseLine(int line)
获取目标线基线的 y 坐标。
参数：
| 参数名称 | 参数描述 |
|---|---|
| line | 表示目标行号，范围从0到总行号减1。可以使用getLineCount()获取总行号。 |
返回:
返回目标线基线的 y 坐标。
Since:
7
public void getBoundingRect(int line, Rect bounding)
获取目标线的边界矩形。
参数：
| 参数名称 | 参数描述 |
|---|---|
| line | 表示目标行号，范围从0到总行号减1。可以使用getLineCount()获取总行号。 |
| bounding | 表示目标线的位置，包括左侧的x坐标、顶部的y坐标、右侧的x坐标和底部的y坐标。 |
Since:
7
public int getMinTextHeight()
获取此 Text 的最小高度。
返回:
返回此文本的最小高度。
Since:
7
public void setMinTextLines(int minLines)
设置此文本的最小行数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minLines | 指示要设置的最小行数。 |
Since:
7
public int getMinTextLines()
获取此文本中的最小行数。
返回:
如果获得，则返回最小行数； 否则返回 -1。
Since:
7
public int getOffsetByCoordinates(float x, float y)
获取距离指定位置最近的字符偏移量。
参数：
| 参数名称 | 参数描述 |
|---|---|
| x | 表示指定位置的 x 坐标。 |
| y | 表示指定位置的 y 坐标。 |
返回:
返回最接近指定位置的字符偏移量。
Since:
7
public Text.FontFamilyType getFontFamilyType()
获取此 Text 的字体系列类型。
返回:
返回此文本的字体系列类型。
Since:
7
public void setFontFamilyType(Text.FontFamilyType type)
设置此文本的字体系列。
参数：
| 参数名称 | 参数描述 |
|---|---|
| type | 指示要设置的字体系列变体。 |
Since:
7
public int getMaxWidthInEms()
获取此文本的最大宽度，以 em 为单位。
返回:
如果获得，则返回最大宽度（以 em 为单位）； 如果未配置最大宽度，则返回 -1。
Since:
7
public int getMinWidthInEms()
获取此文本的最小宽度，以 em 为单位。
返回:
如果获得，则返回最小宽度（以 em 为单位）； 如果未配置最小宽度，则返回 -1。
Since:
7
public void setTextWidthInEms(int ems)
设置此文本的宽度，以 em 为单位。
参数：
| 参数名称 | 参数描述 |
|---|---|
| ems | 表示要设置的宽度，单位为 em。 |
Since:
7
public void setMaxWidthInEms(int maxEms)
设置此文本的最大宽度，以 em 为单位。
参数：
| 参数名称 | 参数描述 |
|---|---|
| maxEms | 表示要设置的最大宽度，以 em 为单位。 |
Since:
7
public void setMinWidthInEms(int minEms)
设置此文本的最小宽度，以 em 为单位。
参数：
| 参数名称 | 参数描述 |
|---|---|
| minEms | 表示要设置的最小宽度，以 em 为单位。 |
Since:
7
public TextLayout.JustifyStrategy getJustifyStrategy()
获取文本对齐策略。
返回:
返回文本对齐策略。
Since:
7
public void setJustifyStrategy(TextLayout.JustifyStrategy strategy)
设置文本对齐策略。
参数：
| 参数名称 | 参数描述 |
|---|---|
| strategy | 表示文本对齐策略。 |
Since:
7
public void setLetterSpacing(float spacing)
设置文本字母之间的间距。
参数：
| 参数名称 | 参数描述 |
|---|---|
| spacing | 指示文本字母之间的间距。 |
Since:
7
public void setLineHeight(int lineHeight)
设置此文本的行之间的高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| lineHeight | 指示行之间的高度，以像素为单位。 |
Since:
7
public void setTextHeight(int pixels)
设置此文本的固定高度。
参数：
| 参数名称 | 参数描述 |
|---|---|
| pixels | 指示要设置的高度，以像素为单位。 |
Since:
7
public void setLines(int lines)
设置此文本的行数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| lines | 指示要设置的行数。 |
Since:
7
public TextLayout.LineBreakStrategy getLineBreakStrategy()
获取该文本的换行策略。
返回:
返回换行策略。
Since:
7
public void setLineBreakStrategy(TextLayout.LineBreakStrategy strategy)
设置此文本的换行策略。
参数：
| 参数名称 | 参数描述 |
|---|---|
| strategy | 表示要设置的换行策略。 |
Since:
7
public void lockEditingState()
锁定输入法并开始文本编辑。
Since:
7
public void unlockEditingState()
解锁输入法并结束文本编辑。
Since:
7
public void onLockEditingState()
当输入法被锁定时调用。
Since:
7
public void onUnlockEditingState()
当输入法解锁时调用。
Since:
7
public boolean isFocusedByTouch()
当你触摸它时检查这个文本是否有焦点。
返回:
如果此 Text 具有焦点，则返回 true； 否则返回 false。
Since:
7
public boolean isTextSelectable()
检查是否可以选择此文本。
返回:
如果可以选择文本，则返回 true； 否则返回 false。
Since:
7
public boolean adjustCursorPosition()
检查光标是否可以移动到可见位置。
返回:
如果光标可以移动到可见位置，则返回 true； 否则返回 false。
Since:
7
public boolean isAutoSelectEnabled()
获取文本获得焦点时是否选择所有文本。
返回:
如果文本获得焦点时将选择所有文本，则返回 true； 否则返回 false。
Since:
7
public void setAutoSelectEnabled(boolean isSelectAll)
设置 thisText 有焦点时是否选择所有文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isSelectAll | 指定当此 Text 具有焦点时是否选择所有文本。 true 表示选择所有文本，false 表示相反。 |
Since:
7
public void setTextSelectable(boolean isSelectable)
设置此文本是否可选。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isSelectable | 指定文本是否可选。 值 true 表示文本是可选择的，false 表示相反。 |
Since:
7
public InputFilter[] getInputFilters()
获取输入过滤器列表。
返回:
返回输入过滤器列表。
Since:
7
public void setInputFilters(InputFilter[] filters)
设置文本的输入过滤器列表。
参数：
| 参数名称 | 参数描述 |
|---|---|
| filters | 输入过滤器列表。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果参数值为 null，则引发此异常。 |
Since:
7
public int getEditorAction()
获取编辑器动作。
返回:
返回编辑器操作。
Since:
7
public CharSequence getEditorActionText()
获取编辑器操作文本。
返回:
返回编辑器操作文本。
Since:
7
public void setEditorActionText(CharSequence text, int action)
设置编辑器操作文本。
当文本字段获得焦点时，该信息将报告给输入法。
参数：
| 参数名称 | 参数描述 |
|---|---|
| text | 指示发送到输入法的自定义编辑器操作文本。 |
| action | 指示发送到输入法的自定义编辑器操作。 |
Since:
7
public void setExtraInputData(PacMap data)
为此文本设置额外的输入数据。
当文本获得焦点时，会通过数据上报给输入法。
参数：
| 参数名称 | 参数描述 |
|---|---|
| data | 指示提供给输入法的 PacMap 对象。 |
Since:
7
public String getCustomInputMethodOptions()
获取自定义输入法选项。
返回:
返回自定义输入法选项。
Since:
7
public void setCustomInputMethodOptions(String options)
设置此文本的自定义输入法选项。
如果文本连接到输入法，自定义输入法选项将被发送到输入法。
参数：
| 参数名称 | 参数描述 |
|---|---|
| options | 指示要设置的自定义输入法选项。 |
Since:
7
public void setTextConversion(Text.ConversionType conversionType)
设置此文本的 ConversionType。
转换仅用于文本显示，不会改变文本内容。
参数：
| 参数名称 | 参数描述 |
|---|---|
| conversionType | 表示转换类型。 |
Since:
7
public Text.ConversionType getTextConversion()
获取此文本的 ConversionType。
默认转换类型为 ConversionType#NONE。
返回:
返回转换类型。
Since:
7
public boolean isAllUpperCase()
检查应用于此文本的 ConversionType 是否设置为 ConversionType#ALL_UPPERCASE。
返回:
如果 ConversionType 设置为 ConversionType#ALL_UPPERCASE，则返回 true； 否则返回 false。
Since:
7
public boolean isInputMethodActive()
检查此 Text 是否是当前输入法的目标。
返回:
如果文本是当前输入法的目标，则返回 true； 否则为 false。
Since:
7
public boolean onTextEditorAction(int actionCode)
在处理指定编辑器操作的更改事件时调用。
参数：
| 参数名称 | 参数描述 |
|---|---|
| actionCode | 指示编辑器操作。 例如，InputAttribute#ENTER_KEY_TYPE_GO 表示“开始”动作，InputAttribute#ENTER_KEY_TYPE_SEND 表示“发送”动作。 |
返回:
如果事件被处理，则返回 true； 否则返回 false。
Since:
7
public boolean isSoftInputVisibleOnFocus()
检查当此文本获得焦点时软输入是否可见。
默认值是true。
返回:
如果软输入可见，则返回 true； 否则返回 false。
Since:
7
public void setSoftInputVisibleOnFocus(boolean isShow)
设置当此文本获得焦点时是否使软输入可见。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isShow | 指定是否使软输入可见。 值 true 表示使软输入可见，false 表示相反。 默认值是true。 |
Since:
7
public boolean getEditingText(EditingCapability request, EditingText text)
获取可编辑的文本。
参数：
| 参数名称 | 参数描述 |
|---|---|
| request | 表示来自输入法的请求。 |
| text | 指示要检查的文本。 |
返回:
如果获取到可编辑文本，则返回 true； 否则返回 false。
Since:
7
public void setEditable(boolean isEditable)
设置此文本的可编辑性。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isEditable | 指定是否将文本设置为可编辑。 值 true 表示将文本设置为可编辑，false 表示相反。 |
Since:
7
public PacMap getExtraInputData(boolean isCreate)
获取发送到输入法的额外输入数据。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isCreate | 指定数据不存在时是否创建数据。 值 true 表示创建数据，false 表示相反。 |
返回:
如果获得，则返回提供给输入法的 PacMap 对象； 否则返回 null。
Since:
7
public boolean onCustomInputMethodCommand(String action, PacMap data)
由框架调用以响应来自输入法的自定义命令。
默认情况下，此方法不执行任何操作。
参数：
| 参数名称 | 参数描述 |
|---|---|
| action | 指示命令的名称。 |
| data | 指示命令的 PacMap 对象。 |
返回:
如果对命令执行操作，则返回 true； 否则返回 false。
Since:
7
public void setMaxCharacters(int maxValue)
设置此文本的最大字符数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| maxValue | 表示最大字符数。 |
Since:
7
public boolean isFallbackFontMetricsEnabled()
检查是否为后备字体启用了上升或下降指标。
默认值是true。
返回:
如果为后备字体启用上升或下降指标，则返回 true； 否则返回 false。
Since:
7
public void setFallbackFontMetricsEnabled(boolean isEnable)
设置是否为后备字体启用上升或下降指标。
参数：
| 参数名称 | 参数描述 |
|---|---|
| isEnable | 指定是否为后备字体启用上升或下降度量。 值 true 表示启用后备字体的上升或下降指标，而 false 表示相反。 默认值是true。 |
Since:
7
public void setTextDirectionStrategy(BidiAnalyzer.BidiStrategy strategy)
设置文本方向策略。
参数：
| 参数名称 | 参数描述 |
|---|---|
| strategy | 指示确定文本方向的策略。 |
Since:
7
public BidiAnalyzer.BidiStrategy getTextDirectionStrategy()
获取文本方向策略。
返回:
返回文本方向策略。
Since:
7