OnDgsBlur: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Thisdp moved page Dgs/onClientDgsDxBlur to OnClientDgsDxBlur)
No edit summary
Line 1: Line 1:
{{Client event}}
__NOTOC__
This event is triggered each time a DGS element looses input focus (mainly useful for windows, editboxes and memos but triggered for all DGS elements nevertheless).
==Parameters==
''None''
==Source==
The [[event system#Event source|source]] of this event is the DGS element which just lost input focus.
==Example==
<syntaxhighlight lang="lua">
local window, editbox = nil, nil
local window, editbox = nil, nil
DGS = exports.dgs
DGS = exports.dgs
Line 19: Line 7:
local left = screenWidth/2 - windowWidth/2
local left = screenWidth/2 - windowWidth/2
local top = screenHeight/2 - windowHeight/2
local top = screenHeight/2 - windowHeight/2
window = DGS:dgsDxCreateWindow(left, top, windowWidth, windowHeight, "Example Window", false)
window = DGS:dgsCreateWindow(left, top, windowWidth, windowHeight, "Example Window", false)
editbox = DGS:dgsDxCreateEdit(11, 41, 241, 22, "", false, window)
editbox = DGS:dgsCreateEdit(11, 41, 241, 22, "", false, window)
addEventHandler("onClientDgsDxFocus", editbox, onClientDGSFocus_editbox, true) --true because for the example we want propagated events
addEventHandler("onDgsFocus", editbox, onDGSFocus_editbox, true) --true because for the example we want propagated events
addEventHandler("onClientDgsDxBlur", editbox, onClientDGSBlur_editbox, true) --true because for the example we want propagated events
addEventHandler("onDgsBlur", editbox, onDGSBlur_editbox, true) --true because for the example we want propagated events
showCursor(true)
showCursor(true)
end)
end)


function onClientDGSFocus_editbox()
function onDGSFocus_editbox()
if source == editbox then
if source == editbox then
outputChatBox("Example editBox received input focus")
outputChatBox("Example editBox received input focus")
Line 34: Line 22:
end
end


function onClientDGSBlur_editbox()
function onDGSBlur_editbox()
if source == editbox then
if source == editbox then
outputChatBox("Example editBox lost input focus")
outputChatBox("Example editBox lost input focus")
Line 41: Line 29:
end
end
end
end
</syntaxhighlight>
==Notes==
*When the focus is transfered from one DGS element to an other, it is guaranteed that ''onClientDgsDxBlur'' on the element that lost focus is triggered before [[Dgs/onClientDgsDxBlur|onClientDgsDxBlur]] on the element that just gained focus
*When the focus of a full window is lost (transfered to an other window or lost), ''onClientDgsDxBlur'' 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 [[Dgs/DgsDxGUISetVisible|dgsDxGUISetVisible]], it (or its child widget having focus) keeps focus internally until an other window gains focus or the chatbox is used
==See Also==
===DGS events===
{{DGSEVENTS}}
===Client event functions===
{{Client_event_functions}}

Revision as of 13:36, 20 January 2018

local window, editbox = nil, nil DGS = exports.dgs 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 = DGS:dgsCreateWindow(left, top, windowWidth, windowHeight, "Example Window", false) editbox = DGS:dgsCreateEdit(11, 41, 241, 22, "", false, window) addEventHandler("onDgsFocus", editbox, onDGSFocus_editbox, true) --true because for the example we want propagated events addEventHandler("onDgsBlur", editbox, onDGSBlur_editbox, true) --true because for the example we want propagated events showCursor(true) end)

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

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

Retrieved from "https://wiki.multitheftauto.com/wiki/OnDgsBlur?oldid=53758"