GuiSetText

From Multi Theft Auto: Wiki
Jump to: navigation, search

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

FROM VERSION 1.5.6 r16361 ONWARDS

Browsers

Buttons

Checkboxes

Comboboxes

Edit Fields

Gridlists

FROM VERSION 1.5.6 r16204 ONWARDS

Memos

Progressbars

Radio Buttons

Scrollbars

Scrollpanes

Static Images

Tab Panels

Tabs

Text Labels

Windows

GUI events