Widget API: CheckButton:SetChecked

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ Methods

← Widget API ← CheckButton < SetChecked

Sets the status of a CheckButton.

CheckButton:SetChecked(State);

Parameters

Arguments

(State)

State

Mixed - Basically expressions LUA evaluates to true will check the button. Everything else will uncheck.

Returns

nil

nil

This function will always return nil.

---

Example

CheckButton:SetChecked(true);
CheckButton:SetChecked(1);
CheckButton:SetChecked(-2397);
CheckButton:SetChecked("-2397");
CheckButton:SetChecked({1,2,3});
CheckButton:SetChecked("foo");
CheckButton:SetChecked();

Result

Button is checked

Example

CheckButton:SetChecked(false);
CheckButton:SetChecked(0);
CheckButton:SetChecked(nil);

Result

Button is unchecked

---

Patch 1.11 WARNING

In patch 1.11 it seems like this method was changed so that it no longer works when passing nil as argument. I have tested that it works as intended when passing true and false.

That's not really correct. Passing "nil" will still 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.

Yep, you're right watchout. Also, I think this behavior was changed in 1.11.1, as it was fine right after 1.11. Krellmax 14:34, 29 June 2006 (MDT)