OnClientGUIClick: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
|||
| Line 1: | Line 1: | ||
{{Client event}} | {{Client event}} | ||
__NOTOC__ | __NOTOC__ | ||
This event happens when any gui-element clicked | |||
gui-element | |||
==Parameters== | ==Parameters== | ||
| Line 9: | Line 7: | ||
string button, string state, int absoluteX, int absoluteY | string button, string state, int absoluteX, int absoluteY | ||
</syntaxhighlight> | </syntaxhighlight> | ||
*'''button:''' | *'''button:''' the name of the button which will be clicked , it can be ''left'', ''right'', ''middle'' | ||
*'''state:''' | *'''state:''' the state of the mouse button, will be ''down'' if the mouse button was pushed, or ''up'' if it was released. '''Please note currently only the ''up'' state is supported.''' | ||
*'''absoluteX:''' the X position of the mouse cursor, in pixels, measured from the left side of the screen. | |||
''down'' | *'''absoluteY:''' the Y position of the mouse cursor, in pixels, measured from the top of the screen. | ||
''up'' | |||
*'''absoluteX:''' | |||
*'''absoluteY:''' | |||
==Source== | ==Source== | ||
The [[event system#Event source|source]] of this event is the GUI element that was clicked. | |||
==Example== | ==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. | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | -- When client's resource starts, create the GUI | ||
function initGUI( ) | function initGUI( ) | ||
-- | -- Create our button | ||
btnOutput = guiCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true ) | btnOutput = guiCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true ) | ||
-- | -- And attach our button to the outputEditBox function | ||
addEventHandler ( "onClientGUIClick", btnOutput, outputEditBox, false ) | |||
addEventHandler ( "onClientGUIClick", btnOutput, outputEditBox, false ) | |||
-- | -- Create an edit box and define it as "editBox". | ||
editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "Type your message here!", true ) | editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "Type your message here!", true ) | ||
guiEditSetMaxLength ( editBox, 128 ) -- | guiEditSetMaxLength ( editBox, 128 ) -- The max chatbox text length is 128, so force this | ||
end | end | ||
addEventHandler( "onClientResourceStart", getResourceRootElement( getThisResource( ) ), initGUI ) | addEventHandler( "onClientResourceStart", getResourceRootElement( getThisResource( ) ), initGUI ) | ||
| Line 53: | Line 35: | ||
function outputEditBox ( button ) | function outputEditBox ( button ) | ||
if button == "left" then | if button == "left" then | ||
local text = guiGetText ( editBox )-- | local text = guiGetText ( editBox )-- Get the text from the edit box | ||
outputChatBox ( text ) -- | outputChatBox ( text ) -- Output that text | ||
end | end | ||
end | end | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== | ==See Also== | ||
=== | ===GUI events=== | ||
{{GUI_events}} | {{GUI_events}} | ||
===Client event functions=== | ===Client event functions=== | ||
{{Client_event_functions}} | {{Client_event_functions}} | ||
Revision as of 22:55, 23 August 2012
This event happens when any gui-element clicked
Parameters
string button, string state, int absoluteX, int absoluteY
- 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 down if the mouse button was pushed, or up if it was released. Please note currently only the up state is supported.
- 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 GUI 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.
-- When client's resource starts, create the GUI
function initGUI( )
-- Create our button
btnOutput = guiCreateButton( 0.7, 0.1, 0.2, 0.1, "Output!", true )
-- And attach our button to the outputEditBox function
addEventHandler ( "onClientGUIClick", btnOutput, outputEditBox, false )
-- Create an edit box and define it as "editBox".
editBox = guiCreateEdit( 0.3, 0.1, 0.4, 0.1, "Type your message here!", true )
guiEditSetMaxLength ( editBox, 128 ) -- The max chatbox text length is 128, so force this
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 = guiGetText ( editBox )-- Get the text from the edit box
outputChatBox ( text ) -- Output that text
end
end
See Also
GUI events
Input
GUI
- onClientGUIAccepted
- onClientGUIBlur
- onClientGUIChanged
- onClientGUIClick
- onClientGUIComboBoxAccepted
- onClientGUIDoubleClick
- onClientGUIFocus
- onClientGUIMouseDown
- onClientGUIMouseUp
- onClientGUIMove
- onClientGUIScroll
- onClientGUISize
- onClientGUITabSwitched
- onClientMouseEnter
- onClientMouseLeave
- onClientMouseMove
- onClientMouseWheel
Client event functions
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- triggerLatentServerEvent
- triggerServerEvent
- wasEventCancelled