element.setData: Difference between revisions

Latest revision as of 20:37, 19 November 2022

Method Server and Client Online and Offline

Available since Server 1.0.0, Client 1.0.0

void element.setData(string dataName, var theData, bool syncWithClientsNow)

The element.setData method is used to set a value for an element, referenced by a key.

The data will be sent to all clients when streaming in, so do not use element.setData() to store sensitive data like passwords.

Parameters

1)	string	dataName	The string name of the data for the element.
2)	var	theData	The data for the element, which is referenced by dataName.
3)	bool	syncWithClientsNow	Whether the data is sent to clients immediately. Note that all element data will be sent to a client when the element streams in. This argument only applies when the method is used server-side.

Return

void	This method doesn't return a value.

Types

Shared Blip
Shared Building
Shared Element
Shared Entity
Shared Marker
Shared Object
Shared Ped
Shared Physical
Shared Player
Shared Vehicle

Notes

The third arg (syncWithClients) is not available client side.

Examples

There aren't any examples for this method.

Compatibility

There isn't any compatibility information for this method.

element.children
element.clearExistsFor
element.dimension
element.existsFor
element.getData
element.getRotation
element.id
element.isCreatedFor
element.isLocal
element.isOwner
element.isSyncer
element.isType
element.name
element.netFlags
element.parent
element.position
element.removeAllData
element.removeData
element.resource
element.rotation
element.setData
element.setExistsFor
element.setRotation
element.setSyncer
element.streamInDistance
element.streamOutDistance
element.syncer
element.syncerId
element.type

Client Related

destroyElement
getElementCount
getElementFromId
getElementFromName
getElements
getElementsByType

element.children
element.clearExistsFor
element.dimension
element.existsFor
element.getData
element.getRotation
element.id
element.isCreatedFor
element.isLocal
element.isOwner
element.isSyncer
element.isType
element.name
element.netFlags
element.parent
element.position
element.removeAllData
element.removeData
element.resource
element.rotation
element.setData
element.setExistsFor
element.setRotation
element.setSyncer
element.streamInDistance
element.streamOutDistance
element.syncer
element.syncerId
element.type

@@ Line 1: / Line 1: @@
-{{ScriptItem
+{{ScriptItem2
-|endpoint = shared
+|name = setData
+|side = shared
 |type = method
 |class = Element
-|name = setData
+|games = iii vc sa iv
-|parameters = string dataName, var theData, bool syncWithClients
+|desc = set a value for an element, referenced by a key.<br>
-|parameter1 = string dataName The string name of the data for the element.
+The data will be sent to all clients when streaming in, so do not use element.setData() to store sensitive data like passwords.
-|parameter2 = var theData The data for the element, which is referenced by dataName.
+|arg1 = string dataName The string name of the data for the element.
-|parameter3 = bool syncWithClients Whether to sync the data with all clients.
+|arg2 = var theData The data for the element, which is referenced by dataName.
-|returnTypes = void
+|arg3 = bool syncWithClientsNow Whether the data is sent to clients immediately.<br>Note that all element data will be sent to a client when the element streams in.<br>This argument only applies when the method is used server-side.
-|returnInfo = void
+|return = void void
-|returnFail1 = void
+|freturn = void
-|usage = sets info, referenced by name
+|note = The third arg (syncWithClients) is not available client side.
-|notes = The third arg (syncWithClients) is not available client side.
 }}