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

setElementParent

Client-side
Server-side
Shared

Pair: getElementParent

This function is used for setting an element as the parent of another element.

Note
  • The client-side version of this function can only be used on client-created elements. It cannot be used to modify the parent of server side elements.
  • This function does not change when an element will be destroyed - Elements are always destroyed when the resource that created them is stopped.
  • When an element is destroyed, its parent becomes the new parent of its children.
  • setElementParent only works if new parent is the root element, map root, or ancestor of map root.
Tip

This function does not affect the child elements position. To attach elements use the function attachElements.

OOP Syntax Help! I don't understand this!

  • Method:element:setParent(...)
  • Variable: .parent

Syntax 

​bool setElementParent ( ​element theElement, ​element parent )
Required Arguments
  • theElement: The element that you wish to set the parent of.
  • parent: The element you wish to be the parent of theElement .

Returns

  • bool: result

Returns true if both elements are valid, false otherwise.

Code Examples

server

This example sets the parent of each spawnpoint to a dummy element.

This is the equivalnet of the lua code below.

<spawngroup id="Group of spawn points">
  <spawnpoint id="spawnpoint_0" posX="2507.8715820313" posY="2772.6071777344" posZ="10.8203125" rot="270" skin="285"/>
  <spawnpoint id="spawnpoint_1" posX="2508.060546875" posY="2780.3647460938" posZ="10.8203125" rot="270" skin="285"/>
  <spawnpoint id="spawnpoint_2" posX="2508.0053710938" posY="2776.2897949219" posZ="10.8203125" rot="270" skin="285"/>
  <spawnpoint id="spawnpoint_3" posX="2510.6899414063" posY="2778.3745117188" posZ="10.8203125" rot="270" skin="285"/>
</spawngroup>

Lua code

local dummyElem = createElement("spawngroup", "Group of spawn points") -- create a dummy element
local spawnpoints = getElementsByType("spawnpoint") -- get a table of spawn point elements
for k, v in ipairs(spawnpoints) do -- loop through the table of spawn points
    setElementParent(v, dummyElem) -- set the dummy element as the parent of the spawn point
end
-- all of the spawn points are now children of 'dummyElem'

See Also

Element Functions
Element Events
Reference