object.alpha

类型 Number
Object DisplayObject
display.*
修订版 Release 2024.3703
关键字 不透明度、透明、不透明

概述

此属性表示显示对象的 Alpha 值。使用它来设置或检索对象的透明度。0 的值为透明,1.0 的值为完全不透明。

此属性通常用于transition.to()函数,以逐渐显示/隐藏对象。

需要特别注意的问题

object:setFillColor设置的 alpha 值仅适用于对象的 color/tint 部分,而object.alpha控制对象的整体不透明度,包括填充颜色/图像。填充 alpha 等于 object.alpha 值乘以 object:setFillColor() alpha 值。考虑以下示例:

还要注意,一个对象可能由填充颜色/色调和笔触组成。在这种情况下,object.alpha 控制两个部分的不透明度,而object:setFillColor仅控制填充颜色/色调。

示例

local rect1 = display.newRect( 100, 100, 50, 50 )
rect1:setFillColor( 1, 0, 0 )

local rect2 = display.newRect( 125, 125, 50, 50 )
rect2:setFillColor( 1, 1, 1 )
rect2.alpha = 0.5
local object = display.newImage( "image.png" )
object.alpha = 0.75  -- set to 75% opacity