GetElementByIndex
From Multi Theft Auto: Wiki
Note:
It is important to note that if you wish to retrieve more than one element at a time, it is more efficient to use getElementsByType instead.
This function returns an element of the specified type with the specified index.
Syntax
element getElementByIndex ( string type, int index )
Required Arguments
- type: the type of the element to be returned. Examples include "player", "vehicle", or a custom type.
- index: the element's index (0 for the first element, 1 for the second, etc).
Returns
Returns the requested element, or false if it doesn't exist.
Example
This example outputs the name of the specified vehicle currently existent in the XML tree. For example: 'vehicle 0' would return the first vehicle.
function showVehicle(thePlayer, command, index) local theVehicle = getElementByIndex("vehicle", tonumber(index)) if theVehicle then outputChatBox("Vehicle " .. index .. " is a: " .. getVehicleName(theVehicle), thePlayer) else outputChatBox("Vehicle not found.", thePlayer) end end addCommandHandler("vehicle", showVehicle)
See Also
- clearElementVisibleTo
- cloneElement
- createElement
- destroyElement
- getAllElementData
- getAttachedElements
- getElementAlpha
- getElementAttachedOffsets
- getElementCollisionsEnabled
- getElementAttachedTo
- getElementByID
- getElementByIndex
- getElementChild
- getElementChildren
- getElementChildrenCount
- getElementColShape
- getElementData
- getElementDimension
- getElementHealth
- getElementID
- getElementInterior
- getElementParent
- getElementPosition
- getElementRotation
- getElementsByType
- getElementsWithinColShape
- getElementType
- getElementVelocity
- getElementZoneName
- getRootElement
- isElement
- isElementAttached
- setElementFrozen
- setElementHealth
- setElementID
- setElementInterior
- setElementParent
- setElementPosition
- attachElements
- detachElements
- getElementModel
- getElementSyncer
- isElementInWater
- setElementAttachedOffsets
- setElementModel