类型 函数 库 display.* 返回值 TextObject（文本对象） 修订 版本 2024.3703 关键词 浮雕文本，文本 另请参阅 使用自定义字体 （指南） 显示对象 （指南） display.newText() object:setEmbossColor()
创建一个浮雕文本对象。局部原点位于文本中心，并且锚点初始化为此局部原点。
文本会在换行符处或在创建对象时指定 `width` 和 `height` 时换行。
默认情况下，文本颜色为白色( 1, 1, 1 )
display.newEmbossedText( options )
此函数接受一个参数 `options`，它是一个包含以下参数的表
GroupObject（组对象）. 用于插入文本对象的显示组。
String（字符串）. 要显示的文本。同样，要在创建文本对象后更改显示的文本，请设置 object.text 属性。
Number（数字）. 对象 **x** 和 **y** 中心点的坐标。
Number（数字）. 如果提供，文本将在 `width` 处换行并在 `height` 处裁剪。将 `height` 设置为 `0`，文本框高度将根据文本量进行调整，但永远不会超过设备的最大纹理高度。
String（字符串）、Userdata（用户数据） 或 Constant（常量）. 可以是以下之一
Number（数字）. 文本的大小（以 Corona 内容点为单位）。如果省略此参数或将其设置为 `nil` 或 `0`，则将使用系统的默认字体大小。
要在创建文本对象**之后**更改其字体大小，请设置 object.size 属性，**而不是** `object.fontSize`。
String（字符串）. 当宽度已知时（即包含换行符或提供了 `width` 参数），这指定文本的对齐方式。默认值为 `“left”`。有效值为 `“left”`、`“center”` 或 `“right”`。
display.newEmbossedText( [parent,] text, x, y, [width, height,] font, fontSize )
GroupObject（组对象）. 要将浮雕文本对象插入到的显示组。
String（字符串）. 要显示的文本。同样，要在创建文本对象后更改显示的文本，请设置 object.text 属性。
Number（数字）. 对象 **x** 和 **y** 中心点的坐标。
Number（数字）. 如果提供，文本将在 `width` 处换行并在 `height` 处裁剪。将 `height` 设置为 `0`，文本框高度将根据文本量进行调整，但永远不会超过设备的最大纹理高度。
String（字符串）、Userdata（用户数据） 或 Constant（常量）. 可以是以下之一
Number（数字）. 文本的大小（以 Corona 内容点为单位）。如果省略此参数或将其设置为 `nil` 或 `0`，则将使用系统的默认字体大小。
要在创建文本对象**之后**更改其字体大小，请设置 object.size 属性，**而不是** `object.fontSize`。
`newEmbossedText` 对象在创建时使用蒙版。嵌套蒙版限制为 3，因此在将蒙版对象插入充当容器的其他蒙版对象（包括 display.newContainer、widget.newScrollView、widget.newTableView 或蒙版的 显示组）时必须小心。其他利用蒙版的显示对象包括 display.newText 和任何其他 蒙版 显示对象。如果超过蒙版嵌套限制，文本可能会显示为纯白色块。例如，一个文本对象（一个蒙版）在一个容器（一个蒙版）内，而该容器又在另一个容器（一个蒙版）内，将达到但不超过 3 个嵌套蒙版的限制。
`newEmbossedText` 支持 `text.text = string` 和 `text:setText( string )` 方法来更改浮雕文本的文本。后一个函数返回一个显示组而不是矢量文本对象，并带有用于设置文本 (`text:setText()`) 和更改文本颜色 (`text:setFillColor()`) 的其他方法。使用 `text.text` 检索文本字符串。
`newEmbossedText` 支持 `text.size = number` 和 `text:setSize( number )` 来更改浮雕文本的大小。使用 `text.size` 检索文本大小。
使用 `text:setEmbossColor( colorTable )` 方法更改文本的浮雕颜色。
local myText = display.newEmbossedText( "hello", 200, 100, native.systemFont, 40 )
myText:setFillColor( 0.5 )
myText:setText( "Hello World!" )
local color =
{
highlight = { r=1, g=1, b=1 },
shadow = { r=0.3, g=0.3, b=0.3 }
}
myText:setEmbossColor( color )