OnDgsFocus: Difference between revisions
		
		
		
		
		
		Jump to navigation
		Jump to search
		
				
		
		
	
| m (Thisdp moved page Dgs/onClientDgsDxFocus to OnClientDgsDxFocus) | No edit summary | ||
| Line 19: | Line 19: | ||
| 	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: | 	window = DGS:dgsCreateWindow(left, top, windowWidth, windowHeight, "Example Window", false)		 | ||
| 	editbox = DGS: | 	editbox = DGS:dgsCreateEdit(11, 41, 241, 22, "", false, window) | ||
| 	addEventHandler(" | 	addEventHandler("onDgsFocus", editbox, onClientDGSFocus_editbox, true) --true because for the example we want propagated events | ||
| 	addEventHandler(" | 	addEventHandler("onDgsBlur", editbox, onClientDGSBlur_editbox, true) --true because for the example we want propagated events | ||
| 	showCursor(true) | 	showCursor(true) | ||
| end) | end) | ||
| Line 44: | Line 44: | ||
| ==Note== | ==Note== | ||
| When a widget in a window that didn't have focus before receives focus, '' | 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, '' | When the window already had focus, ''onDgsFocus'' is only triggered for the newly focused child widget. | ||
| ==See Also== | ==See Also== | ||
Revision as of 13:35, 20 January 2018
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, onClientDGSFocus_editbox, true) --true because for the example we want propagated events
	addEventHandler("onDgsBlur", editbox, onClientDGSBlur_editbox, true) --true because for the example we want propagated events
	showCursor(true)
end)
function onClientDGSFocus_editbox()
	if source == editbox then
		outputChatBox("Example editBox received input focus")
	elseif source == window then
		outputChatBox("Example window received input focus")
	end
end
function onClientDGSBlur_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
General
- onDgsBlur
- onDgsCreate
- onDgsCursorTypeChange
- onDgsCursorStateChange
- onDgsDestroy
- onDgsElementRender
- onDgsElementMove
- onDgsElementSize
- onDgsElementEnter
- onDgsElementLeave
- onDgsFocus
- onDgsKey
- onDgsPositionChange
- onDgsPreRender
- onDgsRender
- onDgsElementScroll
- onDgsSizeChange
- onDgsTextChange
- onDgsWindowClose
- onDgsPropertyChange
Check Box
Combo Box
Drag'N Drop
Edit
Grid List
Menu
Selector
Mouse
- onDgsMousePreClick
- onDgsMouseClick
- onDgsMouseClickDown
- onDgsMouseClickUp
- onDgsMouseDrag
- onDgsMouseDoubleClick
- onDgsMouseDoubleClickDown
- onDgsMouseDoubleClickUp
- onDgsMouseDown
- onDgsMouseHover
- onDgsMouseEnter
- onDgsMouseLeave
- onDgsMouseMultiClick
- onDgsMouseMove
- onDgsMouseStay
- onDgsMouseUp
- onDgsMouseWheel
Radio Button
Switch Button
Tab
Animation
Plugin
Media
- onDgsMediaPlay
- onDgsMediaPause
- onDgsMediaStop
- onDgsMediaLoaded
- onDgsMediaTimeUpdate
- onDgsMediaBrowserReturn
Color Picker
QRCode
Remote Image
Client event functions
- triggerLatentServerEvent
- triggerServerEvent
- Shared
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled