OnClientGUIFocus - Revision history

Fernando187: formatting

2025-06-01T17:49:08Z

formatting

← Older revision		Revision as of 17:49, 1 June 2025
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This event is triggered each time a GUI element gains 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 gains input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements nevertheless).

			{{Note\|When a widget in a window that didn't have focus before receives focus, ''onClientGUIFocus'' is triggered first for the window and then for the child widget.
			When the window already had focus, ''onClientGUIFocus'' is only triggered for the newly focused child widget.}}

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

	~~==Note==~~
	~~When a widget in a window that didn't have focus before receives focus, ''onClientGUIFocus'' is triggered first for the window and then for the child widget.~~
	~~When the window already had focus, ''onClientGUIFocus'' is only triggered for the newly focused child widget.~~

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

LordHenry: /* See Also */

2018-05-20T14:30:36Z

Myonlake: /* Parameters */

2018-04-02T22:32:57Z

Parameters

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

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

	==Source==		==Source==

Kayl 712 at 21:50, 18 November 2010

2010-11-18T21:50:27Z

← Older revision		Revision as of 21:50, 18 November 2010
Line 1:		Line 1:
	{{Client event}}		{{Client event}}
	__NOTOC__		__NOTOC__
	This event is triggered each time a GUI element gains input focus (mainly useful for windows, editboxes and memos but triggered for all nevertheless).		This event is triggered each time a GUI element gains input focus (mainly useful for windows, editboxes and memos but triggered for all GUI elements nevertheless).

	==Parameters==		==Parameters==

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

2010-11-18T21:50:07Z

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

New page

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

==Parameters==
''None''

==Source==
The [[event system#Event source|source]] of this event is the GUI element which just gained 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>

==Note==
When a widget in a window that didn't have focus before receives focus, ''onClientGUIFocus'' is triggered first for the window and then for the child widget.
When the window already had focus, ''onClientGUIFocus'' is only triggered for the newly focused child widget.

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