CreateElement: Difference between revisions

Latest revision as of 19:52, 15 April 2021

This function is used to create a new dummy element in the element tree which do not necessarily represent an entity within the San Andreas world. A common use for this function is for creating custom elements, such as a Flag or a Base.

Elements created using this function are placed in the element tree with their parent as the 'dynamic' map element.

Syntax

element createElement ( string elementType, [ string elementID = nil ] )

OOP Syntax Help! I don't understand this!

Method: Element(...)

Required Arguments

elementType: The type of element being created.

Optional Arguments

elementID: The ID of the element being created.

Returns

Returns the element if it was successfully created. Returns false if the arguments are wrong.

Example

This example creates a "flag" element, named "blue", which will be at the resource's dynamic map.

blueTeamFlag = createElement( "flag", "blue" )

Except for it being placed in a different map root, that line will have the same effect as having this in a .map file:

<flag id="blue" />

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{Server client function}}
-This function is used to create dummy elements in the element table, but do not have a counterpart within the San Andreas world. A common use for this function is for creating custom elements, such as a Flag or a Base.
+This function is used to create a new dummy element in the [[element tree]] which do not necessarily represent an entity within the San Andreas world. A common use for this function is for creating custom elements, such as a Flag or a Base.
+Elements created using this function are placed in the element tree with their parent as the 'dynamic' map element.
 ==Syntax==
 <syntaxhighlight lang="lua">
-element createElement ( string id, string type )
+element createElement ( string elementType, [ string elementID = nil ] )
 </syntaxhighlight>
+{{OOP||[[Element]]}}
 ===Required Arguments===
-*'''id:''' The ID of the element being created.
+*'''elementType:''' The type of element being created.
-*'''type:''' The type of element being created. This value will be returned if getElementType is used on it.
+===Optional Arguments===
+*'''elementID:''' The ID of the element being created.
 ===Returns===
-Returns the element if it was successfully created. Returns ''false'' if the arguments are wrong or if the type is not allowed. Unallowed types include hard-coded MTA elements (such as "vehicle") and the type "dummy".
+Returns the element if it was successfully created. Returns ''false'' if the arguments are wrong.
 ==Example==
-This example creates a "flag" element, named "blue", which will be at the root of the element tree.
+This example creates a "flag" element, named "blue", which will be at the resource's dynamic map.
 <syntaxhighlight lang="lua">
-blueTeamFlag = createElement( "blue", "flag" )
+blueTeamFlag = createElement( "flag", "blue" )
 </syntaxhighlight>
-This will have the same effect as having this in .map:
+Except for it being placed in a different map root, that line will have the same effect as having this in a .map file:
 <syntaxhighlight lang="xml">
 <flag id="blue" />
@@ Line 28: / Line 33: @@
 ==See Also==
-{{element functions}}
+{{Element functions}}
+[[en:createElement]]
+[[ru:createElement]]