TextItemSetText: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__
{{Server function}}
Overwrites a previously created text item with the specified text.
Overwrites a previously created text item with the specified text.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">void textItemSetText ( textitem textitem, string text )</syntaxhighlight>  
<syntaxhighlight lang="lua">void textItemSetText ( textitem theTextitem, string text )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''textitem:''' Equal to a varible of an already existing '''textDisplayAddText''' you previously specified
*'''theTextitem:''' An existing text item that was previously created with [[textCreateTextItem]]
*'''text:''' A string that the '''textDisplayAddText''' you previously created will be changed to
*'''text:''' The new text for the text item


==Example==  
==Example==  
Here, it is being used to update a scoreboard:
Here, it is being used to update a scoreboard:
<syntaxhighlight lang="lua">addEventHandler ( "onPlayerWasted", getRootElement(), "onPlayerWasted")
<syntaxhighlight lang="lua">
function onPlayerWasted ( ammo, killer, weapon )
function updateScoreOnWasted ( ammo, killer, weapon )
if ( killer ~= false) then --Checks to see if anything killed the player. This can be false but it never equals true.
if ( killer ~= false) then                           -- Check to see if anything killed the player
if (players[getPlayerName(killer)].gang == "grove") then --If a player killed this person and they are part of the grove gang
local killerTeam = getTeamName ( getPlayerTeam(killer) )
groveteamscore = groveteamscore + 1 --Grove gets 1 point
if ( killerTeam == "grove" ) then             -- if a Grove player scored the kill
textItemSetText ( scoregrove, tostring(groveteamscore) ) --Updated scoreboard Uses tostring() to change the varible to a string to satisfy the function.
groveteamscore = groveteamscore + 1   -- Grove gets 1 point
elseif (players[getPlayerName(killer)].gang == "balla") then --If a player killed this person and they are part of the balla gang
textItemSetText ( scoregrove, tostring(groveteamscore) ) -- Update scoreboard.
ballateamscore = ballateamscore + 1 --Ballas get 1 point
elseif ( killerTeam == "balla" ) then         -- if a Balla player scored the kill
textItemSetText ( scoreballa, tostring(ballateamscore) ) --Updated scoreboard. Uses tostring() to change the varible to a string to satisfy the function.
ballateamscore = ballateamscore + 1   -- Ballas get 1 point
end
textItemSetText ( scoreballa, tostring(ballateamscore) ) -- Update scoreboard.
end
end
end</syntaxhighlight>
end
end
addEventHandler ( "onPlayerWasted", getRootElement(), updateScoreOnWasted )
</syntaxhighlight>


==See Also==
==See Also==
{{Text functions}}
{{Text functions}}

Revision as of 13:51, 27 August 2009

Overwrites a previously created text item with the specified text.

Syntax

void textItemSetText ( textitem theTextitem, string text )

Required Arguments

  • theTextitem: An existing text item that was previously created with textCreateTextItem
  • text: The new text for the text item

Example

Here, it is being used to update a scoreboard:

function updateScoreOnWasted ( ammo, killer, weapon )
	if ( killer ~= false) then                            -- Check to see if anything killed the player
		local killerTeam = getTeamName ( getPlayerTeam(killer) )
		if ( killerTeam == "grove" ) then             -- if a Grove player scored the kill
			groveteamscore = groveteamscore + 1   -- Grove gets 1 point
			textItemSetText ( scoregrove, tostring(groveteamscore) ) -- Update scoreboard.
		elseif ( killerTeam == "balla" ) then         -- if a Balla player scored the kill
			ballateamscore = ballateamscore + 1   -- Ballas get 1 point
			textItemSetText ( scoreballa, tostring(ballateamscore) ) -- Update scoreboard.
		end
	end
end
addEventHandler ( "onPlayerWasted", getRootElement(), updateScoreOnWasted )

See Also