GuiSetText: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
{{Client function}}
This function is for setting text of a GUI element
__NOTOC__
This function sets the text of a GUI element.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
bool guiSetText ( element guiElement, string text )
bool guiSetText ( element guiElement, string text )
</syntaxhighlight>  
</syntaxhighlight>
{{OOP||[[GUI widgets|GuiElement]]:setText|text|guiGetText}}


===Required Arguments===  
===Required Arguments===
*'''guiElement:''' The GUI element, the text of you wish to set
*'''guiElement:''' The GUI element you wish to change the text of
*'''text:''' The text
*'''text:''' The new text


===Returns===
===Returns===
Line 15: Line 17:


==Example==  
==Example==  
This example creates a label. When an element is clicked, the label displays in the position of the element telling you what kind of element you have clicked. It hides after 5 seconds.
This example creates a label. When an element is clicked, the label displays in the position of the element telling you what kind of element you have clicked. It hides after 5 seconds.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--create an empty label
-- create an empty label
local myLabel = guiCreateLabel  ( 0, 0, 1, 1, "", true )
local myLabel = guiCreateLabel  ( 0, 0, 1, 1, "", true )


function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )
function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )
--if an element was clicked on screen
-- if an element was clicked on screen
if ( clickedElement ) then
if ( clickedElement ) then
--retreive the element type
-- retrieve the element type
local elementType = getElementType ( clickedElement )
local elementType = getElementType ( clickedElement )
--change the label text to that element type
-- change the label text to that element type
guiSetText ( myLabel, elementType )
guiSetText ( myLabel, elementType )
--and place it in the position of where the element is
-- and place it in the position of where the element is
guiSetPosition ( myLabel, absoluteX, absoluteY, true )
guiSetPosition ( myLabel, absoluteX, absoluteY, true )
--hide the text by passing an empty string 5 seconds later
-- hide the text by passing an empty string 5 seconds later
setTimer ( guiSetText, 5000, 1, myLabel, "" )
setTimer ( guiSetText, 5000, 1, myLabel, "" )
end
end
Line 38: Line 40:
==See Also==
==See Also==
{{GUI_functions}}
{{GUI_functions}}
{{GUI_events}}

Latest revision as of 17:20, 21 November 2018

This function sets the text of a GUI element.

Syntax

bool guiSetText ( element guiElement, string text )

OOP Syntax Help! I don't understand this!

Method: GuiElement:setText(...)
Variable: .text
Counterpart: guiGetText


Required Arguments

  • guiElement: The GUI element you wish to change the text of
  • text: The new text

Returns

Returns true if text has been successfully set on the gui element, false otherwise.

Example

This example creates a label. When an element is clicked, the label displays in the position of the element telling you what kind of element you have clicked. It hides after 5 seconds.

-- create an empty label
local myLabel = guiCreateLabel  ( 0, 0, 1, 1, "", true )

function addLabelOnClick ( button, state, absoluteX, absoluteY, worldX, worldY, worldZ, clickedElement )
	-- if an element was clicked on screen
	if ( clickedElement ) then
		-- retrieve the element type
		local elementType = getElementType ( clickedElement )
		-- change the label text to that element type
		guiSetText ( myLabel, elementType )
		-- and place it in the position of where the element is
		guiSetPosition ( myLabel, absoluteX, absoluteY, true )
		-- hide the text by passing an empty string 5 seconds later
		setTimer ( guiSetText, 5000, 1, myLabel, "" )
	end
end
addEventHandler ( "onClientClick", getRootElement(), addLabelOnClick )

See Also

General functions

Browsers

Buttons

Checkboxes

Comboboxes

Edit Boxes

Gridlists

Memos

Progressbars

Radio Buttons

Scrollbars

Scrollpanes

Static Images

Tab Panels

Tabs

Text Labels

Windows

Input

GUI