OnClientGUIBlur - Revision history

Fernando187: formatting

2025-06-01T17:46:47Z

formatting

← Older revision		Revision as of 17:46, 1 June 2025
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This event is triggered each time a GUI element looses input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements nevertheless).		This event is triggered each time a GUI element looses input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements nevertheless).


			{{Note\|When the focus is transfered from one GUI element to an other, it is guaranteed that ''onClientGUIBlur'' on the element that lost focus is triggered before [[onClientGUIFocus]] on the element that just gained focus}}
			{{Note\|When the focus of a full window is lost (transfered to an other window or lost), ''onClientGUIBlur'' is only triggered for the window itself even if one of its widgets had focus too. It's important in this case to use the 4th parameter of [[addEventHandler]] if you are only registered for the events of a child widget (cf. Example)}}
			{{Note\|When a window is hidden with [[guiSetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used}}


	==Parameters==		==Parameters==
Line 41:		Line 47:
	end		end
	</syntaxhighlight>		</syntaxhighlight>

	~~==Notes==~~
	*When the focus is transfered from one GUI element to an other, it is guaranteed that ''onClientGUIBlur'' on the element that lost focus is triggered before [[onClientGUIFocus]] on the element that just gained focus
	*When the focus of a full window is lost (transfered to an other window or lost), ''onClientGUIBlur'' is only triggered for the window itself even if one of its widgets had focus too. It's important in this case to use the 4th parameter of [[addEventHandler]] if you are only registered for the events of a child widget (cf. Example)
	*When a window is hidden with [[guiSetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used

	==See Also==		==See Also==

LordHenry: /* See Also */

2018-05-20T14:29:31Z

Myonlake: /* Parameters */

2018-04-02T22:28:57Z

Parameters

← Older revision		Revision as of 22:28, 2 April 2018
Line 4:		Line 4:

	==Parameters==		==Parameters==
	~~''None''~~		No parameters.

	==Source==		==Source==

Kayl 712: /* Notes */

2010-11-18T22:02:23Z

Notes

← Older revision		Revision as of 22:02, 18 November 2010
Line 43:		Line 43:

	==Notes==		==Notes==
	*When the focus is transfered from one GUI element to an other, it is guaranteed that ''onClientGUIBlur'' on the element that lost focus is triggered before ''onClientGUIFocus'' on the element that just gained focus		*When the focus is transfered from one GUI element to an other, it is guaranteed that ''onClientGUIBlur'' on the element that lost focus is triggered before [[onClientGUIFocus]] on the element that just gained focus
	*When the focus of a full window is lost (transfered to an other window or lost), ''onClientGUIBlur'' is only triggered for the window itself even if one of its widgets had focus too. It's important in this case to use the 4th parameter of [[addEventHandler]] if you are only registered for the events of a child widget (cf. Example)		*When the focus of a full window is lost (transfered to an other window or lost), ''onClientGUIBlur'' is only triggered for the window itself even if one of its widgets had focus too. It's important in this case to use the 4th parameter of [[addEventHandler]] if you are only registered for the events of a child widget (cf. Example)
	*When a window is hidden with [[guiSetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used		*When a window is hidden with [[guiSetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used

Kayl 712: Created page with "{{Client event}} NOTOC This event is triggered each time a GUI element looses input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements ..."

2010-11-18T22:01:38Z

Created page with "{{Client event}} __NOTOC__ This event is triggered each time a GUI element looses input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements ..."

New page

{{Client event}}
__NOTOC__
This event is triggered each time a GUI element looses input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements nevertheless).

==Parameters==
''None''

==Source==
The [[event system#Event source|source]] of this event is the GUI element which just lost input focus.

==Example==
<syntaxhighlight lang="lua">
local window, editbox = nil, nil
addCommandHandler("example",
function()
local screenWidth, screenHeight = guiGetScreenSize()
local windowWidth, windowHeight = 263, 90
local left = screenWidth/2 - windowWidth/2
local top = screenHeight/2 - windowHeight/2
window = guiCreateWindow(left, top, windowWidth, windowHeight, "Example Window", false)
editbox = guiCreateEdit(11, 41, 241, 22, "", false, window)
addEventHandler("onClientGUIFocus", editbox, onClientGUIFocus_editbox, true) --true because for the example we want propagated events
addEventHandler("onClientGUIBlur", editbox, onClientGUIBlur_editbox, true) --true because for the example we want propagated events
showCursor(true)
end)

function onClientGUIFocus_editbox()
if source == editbox then
outputChatBox("Example editBox received input focus")
elseif source == window then
outputChatBox("Example window received input focus")
end
end

function onClientGUIBlur_editbox()
if source == editbox then
outputChatBox("Example editBox lost input focus")
elseif source == window then
outputChatBox("Example window lost input focus")
end
end
</syntaxhighlight>

==Notes==
*When the focus is transfered from one GUI element to an other, it is guaranteed that ''onClientGUIBlur'' on the element that lost focus is triggered before ''onClientGUIFocus'' on the element that just gained focus
*When the focus of a full window is lost (transfered to an other window or lost), ''onClientGUIBlur'' is only triggered for the window itself even if one of its widgets had focus too. It's important in this case to use the 4th parameter of [[addEventHandler]] if you are only registered for the events of a child widget (cf. Example)
*When a window is hidden with [[guiSetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used

==See Also==
===GUI events===
{{GUI_events}}
===Client event functions===
{{Client_event_functions}}