setElementID | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setElementID

Client-side
Server-side
Shared

Pair: getElementID

This function sets the ID of an element to a string. This can be anything from an identifying number, to a name.

Note

You can only change the ID of an element clientside if that element has been created clientside as well.

OOP Syntax Help! I don't understand this!

  • Method:element:setID(...)
  • Variable: .id

Syntax 

​bool setElementID ( ​element theElement, ​string name )
Required arguments
  • theElement: The element you want to set the ID of.
  • name: The new ID for theElement.

Returns

This returns true if successful. It will return false if theElement is invalid, or does not exist, or if name is invalid, or is not a string.

  • bool: result

Code Examples

shared 
local players = getElementsByType("player")


for i = 1, #players do
    setElementID(players[i], "player" .. i) -- Change element IDs to 'player1', 'players2', 'players3'...
    outputDebugString("Player[" .. i .. "] = " .. getElementID(players[i])) -- Output all the new element IDs
end


-- Could also be --


for i = 1, #players do
    setElementID(players[i], getPlayerName(players[i])) -- Change the element ID to the players name.
    outputDebugString("Player[" .. i .. "] = " .. getElementID(players[i]))
end

See Also

Element Functions
Element Events
Reference