简介

文本（Text）控件类型向玩家显示非交互式文本。此控件类型可用于为其他 UI 对象（UI Object）提供标题或标签，或显示说明或其他文本。

【UIEditor_Text001.png】

默认文本控件类型实例化的 UI 对象效果。

属性

文本（Text）控件类型的 UI 对象可以设置字体、字体样式、字体大小以及文本是否支持富文本功能。属性中有一些选项可以设置文本的对齐方式、水平和垂直溢出的设置（控制文本大于矩形的宽度或高度时会发生什么情况）以及一个使文本调整大小来适应可用空间的 最佳配合（Best Fit）属性。

【UIEditor_Text002.png】

名称	描述
内容（Content）	用于编辑 UI 对象显示的文本。一般情况下此属性的名称隐藏，只会显示文本框，输入的值类型为 文本（String）类型。
字体（Font）	用于编辑 UI 对象显示的文本字体，关于字体的详细信息请参阅 字体 章节。输入的值类型为 引用 类型。
射线投射目标（Raycast Target）	编辑此文本类型的 UI 对象能否被点击或与其他射线交互。 勾选，表示此 UI 对象可以被点击或与其他射线交互。 不勾选，表示此 UI 对象不可被点击或其他射线交互。
射线范围拓展（Raycast Padding）	编辑此文本类型的 UI 对象能被点击或其他射线交互的范围。 属性值是对应边距占宽高的比例，输入的值范围为 0 至 1 的浮点数，且如果与对边边距相加大于 1，属性值会自动调整对边的边距比例至相加的值等于 1。 值得注意的是，需要 射线投射目标 属性勾选了这里的设置才会生效。
字体大小（Fontsize）	显示的文本的字体大小，用字号表示。输入的值范围为 0 至 300 的整数。
自动缩放字号（Best Fit）	设置当 UI 对象显示不完文本内容时，是否自动缩小字号以适应 UI 对象矩形大小。 勾选，表示随文本类型 UI 对象的字体大小根据矩形变换而在设置的字体大小区间内变化。数值属性框内编辑字体大小的变化范围，输入的值范围为 0 至 300 的整数。 【UIEditor_Text003.gif】 不勾选，表示文本类型 UI 对象的字体大小不随矩形变换而变化。
字体样式（Font Style）	您可以设置本文本 UI 对象是否启用加粗、倾斜、下划线和删除线效果。当点击对应属性至高亮（有橙色边框）时，代表启用该效果，各个效果对应的按钮如下： 【UIEditor_Text004.png】Bold 属性确定文本是正常还是加粗。 【UIEditor_Text005.png】Italic 属性确定文本是正常还是倾斜。 【UIEditor_Text006.png】Underline 属性确定文本是否有下划线。 【UIEditor_Text007.png】StrikeThrough 属性确定文本是否标有删除线标记。
对齐（Alignment）	文本的水平和垂直对齐方式。默认情况下是对齐 UI 对象矩形的左上角。
文本颜色（Text Color）	用于渲染文本的颜色。
背景颜色（Background Color）	设置用于填充文本类型 UI 对象的颜色。
描边（Outline）	设置文本描边的宽度，单位是像素。如果输入 0 则代表文本没有描边。
描边颜色（Out Line Color）	设置文本描边的颜色。
文本间隔（Text Space）	此折叠条目内包含了 水平间隔（Horizontal）和 垂直间隔（Vertical）两个子属性，用于设置文本在水平和垂直方向字符间的间隔。 水平间隔（Horizontal）和 垂直间隔（Vertical）两个子属性输入的是字符的宽度，只能输入整数。
高级（Advanced）
自动换行（Auto Warp）	设置文本内容的长度超过 UI 对象矩形的宽度时，文本是否自动换行。 勾选，表示会自动换行。 不勾选，表示文本将不会自动换行。
文本偏移（Offset）	文本的位置相对于 UI 对象的偏移，属性值为 二维向量（Vector 2）。可分别设置 X 和 Y 方向的偏移，属性值可以输入自然数，单位为像素。 · X 属性输入正整数是向右偏移，输入负整数是向左偏移。 · Y 属性输入正整数是向下偏移，输入负整数是向上偏移。值得注意的是，偏移属性仅在文本 对齐（Alignment）属性值设置为居中时才会生效。
转义字符（Transferred）	如果文本属性中输入的文本内容包含了转义字符（如换行转义字符 “\n”），设置是否对转义符进行转义。 勾选，表示会读取转义字符并执行转义。这样您可以通过转义使用无法输入的字符，同时可以让您在一个字符串中使用转义字符“ \" ”添加多个引号，而不会导致文本出错。 不勾选，表示不会对文本进行转义。这样转义字符就会以文本的形式输出，且此时不能添加引号，否则会导致文本运行时出现错误。
富文本（Rich Text）	设置文本中的标记字符是否应解释为富文本样式的信息。 勾选，文本中的标记字符将视为富文本样式的信息，因此可仅让单个字符或句子使用不同字体样式、不同颜色、不同字号等（请参阅 富文本 章节以获取有关标记方法的详细介绍）。 不勾选，全部字符都不解释为富文本样式，直接输出字符字面内容。
水平调整器（Horizontal Fitter）	设置文本控件类型的 UI 对象 宽度（W）的自适应类型。 · 无约束（Unconstrained ），文本控件类型的 UI 对象 宽度（W）由 UI 对象 矩形变换（Rect Transform）的 宽度（W）属性值决定。 · 自适应（Preferred Size），文本控件类型的 UI 对象 宽度（W）将会根据文本内容自动调整。当此属性设置为该值时，自动换行（Auto Warp）属性将失效，且在自动缩放字号（Best Fit）属性勾选（值为 True）时，字号会变为范围内的最小值。
垂直调整器（Vertical Fitter）	设置文本控件类型的 UI 对象 高度（H）的自适应类型。 · 无约束（Unconstrained ），文本控件类型的 UI 对象 高度（H）由 UI 对象 矩形变换（Rect Transform）的 高度（H）属性值决定。 · 自适应（Preferred Size），文本控件类型的 UI 对象 高度（H）将会根据文本内容自动调整。当此属性设置为该值且 自动缩放字号（Best Fit）属性勾选（值为 True）时，字号会变为范围内的最小值。

有些控件类型实例化的 UI 对象内置了文本控件类型的 UI 对象，如 按钮（Button）、文本框（Text Box）等，因此在该类型的 UI 对象中也会有文本控件类型的属性，其用法与本章节一致。