OnDgsMouseClickUp: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(9 intermediate revisions by 2 users not shown)
Line 2: Line 2:
__NOTOC__
__NOTOC__
This event happens when any dgs-element clicked ( Mouse up ).
This event happens when any dgs-element clicked ( Mouse up ).
And this event is for those who are lazy to use judgment statement ( if state == "down" ) and those who are converting gui to dgs.
 
And this event is for those who are converting gui to dgs.
{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]].}}
{{Note|The '''player''' who clicked the dgs-element is always the [[localPlayer]].}}
{{Note|If you want to ask why everything is triggered... See the forth parameter of [[addEventHandler]]}}
{{Note|If you want to ask why everything is triggered... See the forth parameter of [[addEventHandler]]}}
{{Note|This event will not trigger when [[onDgsMousePreClick]] is cancelled.}}


==Parameters==  
==Parameters==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
string button, string state, int absoluteX, int absoluteY
string button, string state, int absoluteX, int absoluteY, bool isCoolingDown
</syntaxhighlight>
</syntaxhighlight>
*'''button:''' the name of the button which will be clicked , it can be ''left'', ''right'', ''middle''
*'''button''': the name of the button which will be clicked , it can be ''left'', ''right'', ''middle''.
*'''state:''' the state of the mouse button, will be "up"
*'''state''': a string of mouse state. In this cause, it is always '''up'''.
*'''absoluteX:''' the X position of the mouse cursor, in pixels, measured from the left side of the screen.
*'''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.
*'''absoluteY''': the Y position of the mouse cursor, in pixels, measured from the top of the screen.
*'''isCoolingDown''': A bool indicates whether this dgs element is cooling down. See [[DGS_General_Basic_Properties#clickCoolDown|Property:clickCoolDown]]


==Source==
==Source==
Line 36: Line 39:


-- Setup our function to output the message to the chatbox
-- Setup our function to output the message to the chatbox
function outputEditBox ( button, state )
function outputEditBox ( button )
     if button == "left" and state == "down" then
     if button == "left" then
         local text = DGS:dgsGetText( editBox )-- Get the text from the edit box
         local text = DGS:dgsGetText( editBox )-- Get the text from the edit box
         outputChatBox ( text ) -- Output that text
         outputChatBox ( text ) -- Output that text
Line 50: Line 53:
btnOutput = DGS:dgsCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )
btnOutput = DGS:dgsCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )


function outputEditBox ( button, state )
function outputEditBox ( button )
     if button == "left" then
     if button == "left" then
         outputChatBox ( "Hey bro, you clicked me, your state is "..state )
         outputChatBox ( "Hey bro, you clicked me, your state is "..state )

Latest revision as of 14:42, 18 February 2021

This event happens when any dgs-element clicked ( Mouse up ).

And this event is for those who are converting gui to dgs.

[[{{{image}}}|link=|]] Note: The player who clicked the dgs-element is always the localPlayer.
[[{{{image}}}|link=|]] Note: If you want to ask why everything is triggered... See the forth parameter of addEventHandler
[[{{{image}}}|link=|]] Note: This event will not trigger when onDgsMousePreClick is cancelled.

Parameters

string button, string state, int absoluteX, int absoluteY, bool isCoolingDown
  • button: the name of the button which will be clicked , it can be left, right, middle.
  • state: a string of mouse state. In this cause, it is always up.
  • 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.
  • isCoolingDown: A bool indicates whether this dgs element is cooling down. See Property:clickCoolDown

Source

The source of this event is the DGS element that was clicked.

Example

This example creates an edit box alongside an "Output!" button. When the button is clicked with the left mouse button, it will output the message in the edit box into the chat box. 

DGS = exports.dgs
-- When client's resource starts, create the GUI
function initGUI( )
    -- Create our button
    btnOutput = DGS:dgsCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )

    -- And attach our button to the outputEditBox function
    addEventHandler ( "onDgsMouseClickUp", btnOutput, outputEditBox )

    -- Create an edit box and define it as "editBox".
    editBox = DGS:dgsCreateEdit( 0.3, 0.1, 0.4, 0.1, "Type your message here!", true )
end
addEventHandler( "onClientResourceStart", getResourceRootElement( getThisResource( ) ), initGUI )

-- Setup our function to output the message to the chatbox
function outputEditBox ( button )
    if button == "left" then
        local text = DGS:dgsGetText( editBox )-- Get the text from the edit box
        outputChatBox ( text ) -- Output that text
    end
end

Clear Example

DGS = exports.dgs

btnOutput = DGS:dgsCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )

function outputEditBox ( button )
    if button == "left" then
        outputChatBox ( "Hey bro, you clicked me, your state is "..state )
    end
end
addEventHandler ( "onDgsMouseClickUp", btnOutput, outputEditBox )

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

Retrieved from "https://wiki.multitheftauto.com/wiki/OnDgsMouseClickUp?oldid=69061"