文本

Text 分类是 nl.text 控件的 Self 节点集合：它显示的字符串、显示所用的字体与度量，以及叠加其上的静态效果。这些节点只出现在某个 nl.text 元素自身 widgetMain 蓝图的创建浮窗中，并且全部作用于该元素。要操作别的文本元素，请使用 Element 分类中同名的 blueprint.element.text.* 节点——属性完全相同，只是多一个用来指定目标的element:nl.text输入

约定

• 没有目标引脚。 Self 节点没有 Element 输入，它从蓝图的执行宿主解析目标。没有东西要接，也就不会接错元素
• 读取是 Pure，写入是 Latent。 每个 getter 都无副作用，在 event、function 和 macro 图中都合法。每个 setter 都会在宿主应用补丁期间挂起执行，因此不能出现在 function 图中——函数要同步把结果返回给调用方，没有地方安放一次待定的写入
• 不能在 Blueprint Value 中使用。 Blueprint Value 的宿主是 widgetValue，而这些节点的作用域是 widgetMain，所以即便 getter 是纯节点，它们也不会出现在那份创建浮窗里。要在 Blueprint Value 中读取文本属性，请配合 Element 字面量使用 Element 形态的 getter
• 写入需要正在运行的游戏。 Host API 只在蓝图运行时之下存在。在编辑器画布上，setter 会以Host API unavailable (use Dev Mode)失败，而 getter 什么都取不到
• 没有产生变化的写入什么也不做。 每个 setter 都会先规范化补丁，再与元素当前属性比较，两者一致时直接返回——不重绘，该元素也不会触发On Flush。getter 同样不会排队 flush，所以图可以反复轮询属性而不会把自己带进循环
• 未接线的输入不等于「保持原样」。 没有连线、卡片上也没有填值，或者填的值不在允许集合内时，多数 setter 会写入一个固定的兜底值而不是保留当前值：Set Text 写入空字符串，Set Font 清除字体，Set Font Size 写入 16，Set Line Height 写入 1.4，各个枚举 setter 写入其列表中的第一个值。什么都不会被拒绝，也不会抛错。只有 Set Text Color、Set Effects 以及 Set All Properties 的每一个引脚会回退到元素已有的值

Get Text

blueprint.text.getText · Pure

Get Text（获取文本）读取元素当前持有的字符串

Set Text

blueprint.text.setText · Latent

Set Text（设置文本）替换整个字符串

Append Text

blueprint.text.appendText · Latent

Append Text（追加文本）读取当前字符串，把 text 接在末尾后写回。追加空字符串会得到同一个字符串，因此是一次空操作

Clear Text

blueprint.text.clearText · Latent

Clear Text（清空文本）写入空字符串。它与什么都不接的 Set Text 等价，只是在卡片上把意图写明了

Get Font

blueprint.text.getFont · Pure

Get Font（获取字体）读取元素所用项目字体资源的 id

Set Font

blueprint.text.setFont · Latent

Set Font（设置字体）把元素指向某个项目字体资源

Get Font Size

blueprint.text.getFontSize · Pure

Get Font Size（获取字号）

Set Font Size

blueprint.text.setFontSize · Latent

Set Font Size（设置字号）

Get Font Weight

blueprint.text.getFontWeight · Pure

Get Font Weight（获取字重）

Set Font Weight

blueprint.text.setFontWeight · Latent

Set Font Weight（设置字重）。字重是一个三值枚举，而不是数值形式的 CSS font-weight。700 在这里不是 bold 的同义词——它不在集合内，因此会回退为 normal

Get Text Color

blueprint.text.getTextColor · Pure

Get Text Color（获取文本颜色）

Set Text Color

blueprint.text.setTextColor · Latent

Set Text Color（设置文本颜色）。元素内部把颜色存为 CSS 颜色字符串，这两个引脚负责双向转换，因此引脚类型是 RGBAColor 而不是 string

Get Text Align

blueprint.text.getTextAlign · Pure

Get Text Align（获取文本对齐）

Set Text Align

blueprint.text.setTextAlign · Latent

Set Text Align（设置文本对齐）让文本行在元素框内水平对齐。它不会移动或改变框本身的尺寸

Get Text Vertical Align

blueprint.text.getTextVerticalAlign · Pure

Get Text Vertical Align（获取文本垂直对齐）

Set Text Vertical Align

blueprint.text.setTextVerticalAlign · Latent

Set Text Vertical Align（设置文本垂直对齐）决定文本行在元素框内的分布。它移动的是框内的文本，不会改变框本身的尺寸

Get Line Height

blueprint.text.getLineHeight · Pure

Get Line Height（获取行高）

Set Line Height

blueprint.text.setLineHeight · Latent

Set Line Height（设置行高）

Get Wrap Mode

blueprint.text.getWrapMode · Pure

Get Wrap Mode（获取换行模式）

Set Wrap Mode

blueprint.text.setWrapMode · Latent

Set Wrap Mode（设置换行模式）

Get Effects

blueprint.text.getEffects · Pure

Get Effects（获取特效）把元素的静态效果块作为单个 JSON 对象读出，字段永远齐全：

{
    "effectBlur": 0,
    "effectBackgroundBlur": 0,
    "effectShadow": null,
    "effectTextShadow": null,
    "effectInnerShadow": null,
    "effectBlend": "",
    "effectGlow": null,
    "effectFilter": null
}

文本元素只认 effectBlur、effectTextShadow、effectBlend 和 effectFilter——它的阴影用 CSS text-shadow 绘制，而 box-shadow 那几个字段属于装饰类控件。因此在文本元素上，effectShadow、effectInnerShadow 和 effectGlow 读回来永远是 null

Set Effects

blueprint.text.setEffects · Latent

Set Effects（设置特效）替换整个效果块——这不是合并，所以只想改一个字段时，请先用 Get Effects 读出来再改那个对象

写入 box-shadow 字段并不会被悄悄丢掉：下次读取时，若尚未设置文字阴影，effectShadow（没有则是 effectGlow）会被提升为 effectTextShadow，而 box-shadow 字段本身返回 null。阴影确实会出现，只是不在你写入的那个键上

Get All Properties

blueprint.text.getAllProperties · Pure

Get All Properties（获取全部属性）在一张卡片上给出全部文本属性。每个输出携带的内容与各自专用 getter 完全一致

Set All Properties

blueprint.text.setAllProperties · Latent

Set All Properties（设置全部属性）在一次补丁里写入全部文本属性，元素只重绘一次而不是十次。它会先读取当前属性，并把它们作为每一个引脚的兜底值——这使它成为唯一一个「引脚不接就保留当前值」的 setter，与各个单属性 setter 恰好相反

Get Visible

blueprint.text.getVisible · Pure

Get Visible（获取可见性）

Set Visible

blueprint.text.setVisible · Latent

Set Visible（设置可见）写的是元素的 visible 属性。它和 Displayable 分类的 Set Display 不是同一个开关：display 是运行时渲染开关，用 CSS 隐藏元素及其子树但保持挂载；而 visible 是检视器里那个布局可见性属性

Get Enabled

blueprint.text.getEnabled · Pure

Get Enabled（获取启用）

Set Enabled

blueprint.text.setEnabled · Latent

Set Enabled（设置启用）传入 false 时会映射到底层的禁用交互机制；原始的 interactionDisabled 属性不对作者暴露，因此这一对节点就是全部接口