OnDgsElementLeave: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 3: Line 3:
This event is fired when the user moves the mouse away from a DGS element even this DGS element is blocked by other DGS elements. This function is different from [[onDgsMouseLeave]].
This event is fired when the user moves the mouse away from a DGS element even this DGS element is blocked by other DGS elements. This function is different from [[onDgsMouseLeave]].


'''You have to set property [[DGS_General_Basic_Properties#enableFullEnterLeaveCheck|enableFullEnterLeaveCheck]] of the DGS element to ''true'' to use this event'''.
'''You have to set property [[DGS_General_Basic_Properties#enableFullEnterLeaveCheck|enableFullEnterLeaveCheck]] of the DGS element to ''true'' to use this event''' because full enter leave check is a little bit costly for cpu resource.


==Parameters==  
==Parameters==  
Line 28: Line 28:
end)
end)
</syntaxhighlight>
</syntaxhighlight>
==See Also==
===DGS events===
{{DGSEVENTS}}
===Client event functions===
{{Client_event_functions}}

Latest revision as of 06:00, 5 October 2023

This event is fired when the user moves the mouse away from a DGS element even this DGS element is blocked by other DGS elements. This function is different from onDgsMouseLeave.

You have to set property enableFullEnterLeaveCheck of the DGS element to true to use this event because full enter leave check is a little bit costly for cpu resource.

Parameters

int absoluteX, int absoluteY
  • absoluteX: the X position of the mouse cursor, in pixels, measured from the left side of the screen.
  • absoluteY: the Y position of the mouse cursor, in pixels, measured from the top of the screen.

Source

The source of this event is the DGS element that was moved away from.

Example

This example shows a message when you move over a DGS element.

DGS = exports.dgs

local imageA = DGS:dgsCreateImage(300,300,400,400,_,false,_,tocolor(128,0,0,255))
local imageB = DGS:dgsCreateImage(0,0,400,400,_,false,imageA,tocolor(128,0,0,255))
DGS:dgsSetProperty(imageA,"enableFullEnterLeaveCheck",true)

addEventHandler( "onDgsElementLeave", imageA, function(aX, aY)
	outputChatBox( "You left DGS element at ("..tostring(aX)..", "..tostring(aY)..")")
end)

See Also

DGS events

General

Check Box

Combo Box

Drag'N Drop

Edit

Grid List

Menu

Selector

Mouse

Radio Button

Switch Button

Tab

Animation

Plugin

Media

Color Picker

QRCode

Remote Image

Client event functions