SetElementID: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
(27 intermediate revisions by 14 users not shown) | |||
Line 1: | Line 1: | ||
{{Server client function}} | |||
__NOTOC__ | __NOTOC__ | ||
This | This function sets the ID of an element to a string. This can be anything from an identifying number, to a name. | ||
You can only change the ID of an element clientside if that element has been created clientside as well. | |||
==Syntax== | ==Syntax== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
bool setElementID ( element | bool setElementID ( element theElement, string name ) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
{{OOP||[[element]]:setID|id|getElementID}} | |||
===Required Arguments=== | ===Required Arguments=== | ||
*''' | *'''theElement:''' The [[element]] you want to set the ID of. | ||
*'''name:''' The new ID for theElement. | |||
*''' | |||
===Returns=== | ===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. | |||
==Example== | ==Example== | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | 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 | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | ==See Also== | ||
{{ | {{element_functions}} |
Latest revision as of 19:54, 15 January 2018
This function sets the ID of an element to a string. This can be anything from an identifying number, to a name. You can only change the ID of an element clientside if that element has been created clientside as well.
Syntax
bool setElementID ( element theElement, string name )
OOP Syntax Help! I don't understand this!
- Method: element:setID(...)
- Variable: .id
- Counterpart: getElementID
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.
Example
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
- attachElements
- createElement
- destroyElement
- detachElements
- getAttachedElements
- getElementAlpha
- getElementAttachedOffsets
- getElementAttachedTo
- getElementByIndex
- getElementByID
- getElementChild
- getElementChildren
- getElementChildrenCount
- getElementCollisionsEnabled
- getElementColShape
- getElementData
- getAllElementData
- hasElementData
- getElementDimension
- getElementHealth
- getElementID
- getElementInterior
- getElementMatrix
- getElementModel
- getElementParent
- getElementPosition
- getElementRotation
- getElementsByType
- getElementsWithinColShape
- getElementsWithinRange
- getElementType
- getElementVelocity
- getLowLODElement
- getRootElement
- isElement
- isElementAttached
- isElementCallPropagationEnabled
- isElementDoubleSided
- isElementFrozen
- isElementInWater
- isElementLowLOD
- isElementWithinColShape
- isElementWithinMarker
- setElementAlpha
- setElementAngularVelocity
- getElementAngularVelocity
- setElementAttachedOffsets
- setElementCallPropagationEnabled
- setElementCollisionsEnabled
- setElementData
- setElementDimension
- setElementDoubleSided
- setElementFrozen
- setElementHealth
- setElementID
- setElementInterior
- setElementModel
- setElementParent
- setElementPosition
- setElementRotation
- setElementVelocity
- setLowLODElement
- getPedContactElement
- getResourceDynamicElementRoot
- getResourceRootElement