IsModifierKeyDown

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

	IsModifierKeyDown		+ 2.0.1 / 1.13.2
	IsControlKeyDown		+ 1.0.0 / 1.13.2
	IsShiftKeyDown		+ 1.0.0 / 1.13.2
	IsAltKeyDown		+ 1.0.0 / 1.13.2
	IsLeftControlKeyDown		+ 2.2.0 / 1.13.2
	IsLeftShiftKeyDown		+ 2.2.0 / 1.13.2
	IsLeftAltKeyDown		+ 2.2.0 / 1.13.2
	IsRightControlKeyDown		+ 2.2.0 / 1.13.2
	IsRightShiftKeyDown		+ 2.2.0 / 1.13.2
	IsRightAltKeyDown		+ 2.2.0 / 1.13.2

Returns true if a modifier key is currently pressed down.

isDown = IsModifierKeyDown() <- IsControlKeyDown() <- IsLeftControlKeyDown()
                                                   <- IsRightControlKeyDown()
                             <- IsShiftKeyDown()   <- IsLeftShiftKeyDown()
                                                   <- IsRightShiftKeyDown()
                             <- IsAltKeyDown()     <- IsLeftAltKeyDown()
                                                   <- IsRightAltKeyDown()

Returns

isDown

boolean - True if the specified modifier key is pressed down.

Details

Related Events	MODIFIER_STATE_CHANGED
Related API	IsModifiedClick • GetBindingByKey

Example

Prints if the left-ctrl and left-shift modifiers are pressed down.

local function OnEvent(self, event, ...)
	if IsLeftControlKeyDown() and IsLeftShiftKeyDown() then
		print("hello")
	end
end

local f = CreateFrame("Frame")
f:RegisterEvent("MODIFIER_STATE_CHANGED")
f:SetScript("OnEvent", OnEvent)