This function is protected, and cannot be called from insecure code while in in combat. It has been protected since patch 2.0. Snippets executed by SecureHandlers may alter [override] bindings in-combat.

Sets a binding to click the specified button object.

ok = SetBindingMacro("key", "macroName" or macroId);

Arguments

("key", "macroName") or ("key", macroId)

key 

String - Any binding string accepted by World of Warcraft. For example: "ALT-CTRL-F", "SHIFT-T", "W", "BUTTON4".

macroName 

String - Name of the macro you wish to execute.

macroId 

Number - Index of the macro you wish to execute.

Returns

ok 

Flag - 1 if the binding has been changed successfully, nil otherwise.

Details

• This function is functionally equivalent to the following statement.

ok = SetBinding("key", "MACRO " .. macroName);

• A single binding can only be bound to a single command at a time, although multiple bindings may be bound to the same command. The Key Bindings UI will only show the first two bindings, but there is no limit to the number of keys that can be used for the same command.
• You must use SetBinding to unbind a key.

See Also

• SetBinding