OnDgsFocus

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.

General

• onDgsBlur
• onDgsCreate
• onDgsCursorTypeChange
• onDgsCursorStateChange
• onDgsDestroy
• onDgsElementRender
• onDgsElementMove
• onDgsElementSize
• onDgsElementEnter
• onDgsElementLeave
• onDgsFocus
• onDgsKey
• onDgsPositionChange
• onDgsPreRender
• onDgsRender
• onDgsElementScroll
• onDgsSizeChange
• onDgsTextChange
• onDgsWindowClose
• onDgsPropertyChange

Check Box

• onDgsCheckBoxChange

Combo Box

• onDgsComboBoxStateChange
• onDgsComboBoxSelect

Drag'N Drop

• onDgsDrag
• onDgsDrop

Edit

• onDgsEditPreSwitch
• onDgsEditSwitched
• onDgsEditAccepted

Grid List

• onDgsGridListItemDoubleClick
• onDgsGridListSelect
• onDgsGridListHover

Menu

• onDgsMenuHover
• onDgsMenuSelect

Selector

• onDgsSelectorSelect

Mouse

• onDgsMousePreClick
• onDgsMouseClick
• onDgsMouseClickDown
• onDgsMouseClickUp
• onDgsMouseDrag
• onDgsMouseDoubleClick
• onDgsMouseDoubleClickDown
• onDgsMouseDoubleClickUp
• onDgsMouseDown
• onDgsMouseHover
• onDgsMouseEnter
• onDgsMouseLeave
• onDgsMouseMultiClick
• onDgsMouseMove
• onDgsMouseStay
• onDgsMouseUp
• onDgsMouseWheel

Radio Button

• onDgsRadioButtonChange

Switch Button

• onDgsSwitchButtonStateChange

Tab

• onDgsTabPanelTabSelect
• onDgsTabSelect

Animation

• onDgsStopMoving
• onDgsStopSizing
• onDgsStopAlphaing
• onDgsStopAniming

Plugin

Media

• onDgsMediaPlay
• onDgsMediaPause
• onDgsMediaStop
• onDgsMediaLoaded
• onDgsMediaTimeUpdate
• onDgsMediaBrowserReturn

Color Picker

• onDgsColorPickerChange
• onDgsColorPickerComponentSelectorChange

QRCode

• onDgsQRCodeLoad

Remote Image

• onDgsRemoteImageLoad

Client event functions

• triggerLatentServerEvent
• triggerServerEvent


• Shared
• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• wasEventCancelled