OnDgsFocus
From Multi Theft Auto: Wiki
This event is triggered each time a DGS element gains input focus (mainly useful for windows, editboxes and memos but triggered for all DGS elements nevertheless).
Parameters
None
Source
The source of this event is the DGS element which just gained input focus.
Example
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
Note
When a widget in a window that didn't have focus before receives focus, onDgsFocus is triggered first for the window and then for the child widget. When the window already had focus, onDgsFocus is only triggered for the newly focused child widget.
See Also
DGS events
- onDgsArrowListValueChange
- onDgsBlur
- onDgsCheckBoxChange
- onDgsComboBoxStateChange
- onDgsComboBoxSelect
- onDgsCreate
- onDgsDestroy
- onDgsEditPreSwitch
- onDgsEditSwitched
- onDgsEditAccepted
- onDgsElementRender
- onDgsElementMove
- onDgsElementSize
- onDgsFocus
- onDgsGridListItemDoubleClick
- onDgsGridListSelect
- onDgsMouseClick
- onDgsMouseClickDown
- onDgsMouseClickUp
- onDgsMouseDrag
- onDgsMouseDoubleClick
- onDgsMouseDown
- onDgsMouseEnter
- onDgsMouseLeave
- onDgsMouseMove
- onDgsMouseUp
- onDgsMouseWheel
- onDgsRadioButtonChange
- onDgsPositionChange
- onDgsPreRender
- onDgsRender
- onDgsElementScroll
- onDgsSizeChange
- onDgsTabPanelTabSelect
- onDgsTabSelect
- onDgsTextChange
- onDgsWindowClose
Plugin
Media
- onDgsMediaPlay
- onDgsMediaPause
- onDgsMediaStop
- onDgsMediaDurationGet
- onDgsMediaTimeUpdate
- onDgsMediaBrowserReturn
Color Picker
Client event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- triggerLatentServerEvent
- triggerServerEvent
- wasEventCancelled