Difference between revisions of "SetLocalEvent"

From Dragon Age Toolset Wiki
Jump to: navigation, search
(Generated by Sunjammer's Dragon Age Script Paser)
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Generated}}
 
 
{{dafunction
 
{{dafunction
 
|name=SetLocalEvent
 
|name=SetLocalEvent
Line 23: Line 22:
 
object.
 
object.
  
<!-- == Remarks == -->
+
== Remarks ==
 
<!-- This section contains additional comments, observations and known issues. -->
 
<!-- This section contains additional comments, observations and known issues. -->
 +
All local variables must be predefined in the target object's variables 2da file before this function can be used successfully. If a local variable is not predefined this function will fail silently.
 +
 +
'''NOTE!''' This type of local variable is not saved/loaded via the save system. So, if a community member or designer wants to save information like this for use later, and someone saves/loads the game, that information is lost forever. Thus, using them outside of situations where you can guarantee no save/load occurs (i.e. during combat) is pretty much guaranteed to fail for some enduser. Furthermore, if you use these variable types in the var_ 2DAs, it will fail gloriously.
 +
 +
Don’t use this function. It will in all likelihood be removed in a future patch.
 +
  
 
<!-- == Examples == -->
 
<!-- == Examples == -->
 
<!-- This section contains examples transcluded from the snippet library. -->
 
<!-- This section contains examples transcluded from the snippet library. -->
 
 
== See also ==
 
== See also ==
 
<!-- This section contains links to articles, functions or constant groups. -->
 
<!-- This section contains links to articles, functions or constant groups. -->
 
[[GetLocalEvent]]
 
[[GetLocalEvent]]
 
[[Category: Variable functions]]
 
[[Category: Variable functions]]
 +
[[Category:Deprecated functions]]

Latest revision as of 19:54, 25 February 2010

Sets a local event variable on an object.

void SetLocalEvent(
object oObject,
string sVarName,
event evEvent
);
Parameters:
oObject
Object to set the variable on
sVarName
The name of the variable to set
evEvent
The value of the event variable to set
Returns:

Nothing.

Source:

script.ldf

Description

Sets a local event variable sVarName on the specified object.

Remarks

All local variables must be predefined in the target object's variables 2da file before this function can be used successfully. If a local variable is not predefined this function will fail silently.

NOTE! This type of local variable is not saved/loaded via the save system. So, if a community member or designer wants to save information like this for use later, and someone saves/loads the game, that information is lost forever. Thus, using them outside of situations where you can guarantee no save/load occurs (i.e. during combat) is pretty much guaranteed to fail for some enduser. Furthermore, if you use these variable types in the var_ 2DAs, it will fail gloriously.

Don’t use this function. It will in all likelihood be removed in a future patch.


See also

GetLocalEvent