FANDOM


Widget API ← CheckButton < SetChecked

Sets the checked status of a CheckButton frame.

CheckButton:SetChecked(State);

Parameters

Arguments

state 
boolean - 'true' sets the button state to checked. Default is 'false'.

Returns

none

Examples

CheckButton:SetChecked(true)

Button is checked

CheckButton:SetChecked(false)
CheckButton:SetChecked(0)
CheckButton:SetChecked(nil)
CheckButton:SetChecked()
CheckButton:SetChecked({1,2,3})
CheckButton:SetChecked("true")

Button is unchecked

Notes

  • Passing "nil" will uncheck the button, but passing *no* argument (although it should end up being nil for Lua) will enable it, also passing a table ({...}) will now check the button.
  • As of WoW 6.0 both GetChecked() and SetChecked() use Lua boolean values only. Passing value other than Lua boolean 'true' is the same as passing 'false', and GetChecked() will only return true or false. Prior to 6.0.2 values such as true, 1, -2397, {1,2,3}, "foo" would all set state as checked. Values such as false, 0, nil would set state as not checked.

See also

Community content is available under CC-BY-SA unless otherwise noted.