object:setState()

类型 函数
库 widget.*
返回值 无
修订版本 版本 2024.3703
关键字 组件，切换，单选，开/关，复选框，SwitchWidget，setState
另请参阅 widget.newSwitch()
SwitchWidget

概览

用于以编程方式设置 SwitchWidget 的状态。这还会从视觉上改变开关状态。

语法

object:setState( options )

此函数使用单个参数 options，这是一个表，接受以下参数

isOn(必需)

Boolean. 将开关设置为开（true）或关（false）。

isAnimated (可选)

Boolean. 仅适用于 style 为 "onOff" 的开关。如果设置为 true，则开关会从视觉上显示其状态变化动画。

onComplete (可选)

Listener. 当开关状态发生更改时要调用的回调函数。

示例

-- Create a default on/off switch
local onOffSwitch = widget.newSwitch
{
    left = 100,
    top = 300,
    initialSwitchState = true
}

local function changeComplete()
    print( "Switch change complete!" )
end

-- Set the on/off switch to off
onOffSwitch:setState( { isOn=false, isAnimated=true, onComplete=changeComplete } )