display.newRoundedRect()

类型 函数
库 display.*
返回值 ShapeObject
修订版 发行版 2024.3703
关键词 圆角矩形、矩形、矢量对象
另请参阅 形状 — 路径、填充、笔触 (指南)
显示对象 (指南)

概述

创建一个圆角矩形对象。四分之一圆的角由指定半径值进行舍入。局部原点位于矩形中心，锚点初始化为该局部原点。

注意事项

如果圆角半径大于矩形宽度或高度的一半，则实际半径将减小，以便以“胶囊”形状渲染圆角矩形。

语法

display.newRoundedRect( [parent,] x, y, width, height, cornerRadius )
parent (可选)

GroupObject. 可选的用于插入圆角矩形的显示组。

x / y (必需)

数字. 矩形中心点的 x 和 y 坐标。

width / height (必需)

数字. 矩形的宽度和高度。

cornerRadius (必需)

数字. 四分之一圆的角由该半径值进行舍入。

属性

(继承自 ShapeObject 的属性)

圆角矩形对象具有一个 path 属性，该属性可修改半径、宽度和高度。

object.path.radius

数字. 角的半径。该值不能设置为大于矩形宽度或高度一半的值。

object.path.height

数字. 矩形的高度。

object.path.width

数字. 矩形的宽度。

示例

local myRoundedRect = display.newRoundedRect( 0, 0, 150, 50, 12 )
myRoundedRect.strokeWidth = 3
myRoundedRect:setFillColor( 0.5 )
myRoundedRect:setStrokeColor( 1, 0, 0 )