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

setElementParent

Client-side
Server-side
Shared

Pair: getElementParent

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

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

Note

This function does not change when an element will be destroyed - Elements are always destroyed when the resource that created them is stopped.

Note

When an element is destroyed, its parent becomes the new parent of its children.

Note

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 .

Important

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.

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: value

Returns true if both elements are valid, false otherwise.

Code Examples

shared

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

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