Add gui.core.(disable|clear)KeyFocus

README.md

@@ -17,6 +17,11 @@ Quickie is an [immediate mode gui][IMGUI] library for [LÖVE][LOVE]
 	-- checkboxes have only a `checked' status
 	local checkbox = {checked = false}
 
+	function love.load()
+		-- disable tabbing through the widgets
+		gui.core.disableKeyFocus()
+	end
+
 	function love.update(dt)
 		-- widgets are defined by simply calling them. usually a widget returns true if
 		-- if its value changed or if it was activated (click on button, ...)
@@ -37,8 +42,8 @@ Quickie is an [immediate mode gui][IMGUI] library for [LÖVE][LOVE]
 	end
 
 	function love.keypressed(key,code)
-		-- forward keyboard events to the gui. If you don't want widget tabbing and
+		-- forward keyboard events to the gui. If you don't want keyboard support
-		-- input widgets, skip this line
+		-- skip this line
 		gui.core.keyboard.pressed(key, code)
 	end
 

core.lua

@@ -17,6 +17,9 @@ local function isActive(id)  return context.active == id end
 local function setKeyFocus(id) context.keyfocus = id end
 local function hasKeyFocus(id) return context.keyfocus == id end
 
+local function disableKeyFocus() return setKeyFocus{} end
+local function clearKeyFocus() return setKeyFocus(nil) end
+
 -- input
 local mouse = {x = 0, y = 0, down = false}
 local keyboard = {key = nil, code = -1}
@@ -50,7 +53,7 @@ end
 
 function keyboard.tryGrab(id)
 	if not context.keyfocus then
-		context.keyfocus = id
+		setKeyFocus(id)
 	end
 end
 
@@ -146,6 +149,9 @@ return {
 	isHot           = isHot,
 	isActive        = isActive,
 	hasKeyFocus     = hasKeyFocus,
+
+	disableKeyFocus = disableKeyFocus,
+	clearKeyFocus   = clearKeyFocus,
 	makeCyclable    = makeCyclable,
 
 	style           = require((...):match("(.-)[^%.]+$") .. '.style-default'),