Make an ARC Behavior Control

Example: Global Script Variables

The ARC variable manager stores and retrieves global variables that are available within ARC plugins and controls. This allows you to Set and Get variables that other controls may be configuring or using.

Data Types
The script variable stores dynamic data types. This means that there is no declaration between numeric or string values. For example in JavaScript you would type...


setVar("$a", 3);
setVar("$b", 3.123);
setVar("$c", "This is a string");
setVar("$d", 0x55);

And in C# plugin you would type...


ARC.Scripting.VariableManager.SetVariable("$a", 3);
ARC.Scripting.VariableManager.SetVariable("$b", 3.123);
ARC.Scripting.VariableManager.SetVariable("$c", "This is a string");
ARC.Scripting.VariableManager.SetVariable("$d", 0x055);

Single Variables
ARC.Scripting.VariableManager.ClearVariable(string variableName)
Clear the variable and remove it from memory.

Clear the entire variable memory.

ARC.Scripting.VariableManager.DoesVariableExist(string variableName)
Returns a Boolean if the variable has been defined in memory.

Returns a string with each variable and the corresponding value (one per line). This is similar to the Variable Manager control found in EZ-Builder->Add Control->Scripting->Variable Manager.

ARC.Scripting.VariableManager.GetVariable(string variableName)
Get the value stored in the specified variable.

ARC.Scripting.VariableManager.GetVariable(string variableName, int index)
Get the value stored in the specified index of the array variable.

ARC.Scripting.VariableManager.SetVariable(string variableName, object value)
Set the value into the memory location of the specified variable. If the variable does not exist, this will create the variable and assign the value.

Array Variables
ARC.Scripting.VariableManager.AppendToVariableArray(string variableName, object value)
Append the value to the existing array.

ARC.Scripting.VariableManager.CreateVariableArray(string variableName, byte[] values)
ARC.Scripting.VariableManager.CreateVariableArray(string variableName, string[] values)
ARC.Scripting.VariableManager.CreateVariableArray(string variableName, object defaultValue, int size)
Create an array variable and specify the default values. Use AppendToVariableArray() to add more items to this array.

ARC.Scripting.VariableManager.FillVariableArray(string variableName, object defaultValue)
If a variable array already exists, this will fill every defined index of the array with the specified value.

ARC.Scripting.VariableManager.GetArraySize(string variableName)
Returns an integer that is the index size of the specified array variable.

ARC.Scripting.VariableManager.IsVariableArray(string variableName)
Returns a Boolean if the specified variable is an array.

ARC.Scripting.VariableManager.SetVariable(string variableName, object value, int index)
Set the value into the index of the specified array variable. The array size must already be defined. If you attempt to set a value to an index outside of the index size, an exception will be thrown.

Monitoring Variable Changes
The variable manager has an event which will be raised for any variable changes. If your plugin has a variable that you wish to watch for changes, subscribe to the event. Remember to unsubscribe from the event when your plugin closes, as per the plugin Compliance section of this tutorial. Below is an example of subscribing, checking for a variable change, and unsubscribing when the plugin closes.

If the variable is an array, the index will be populated with the array index that has changed. If the variable is not an array, the index will equal -1.


private MyForm() {


  // Subscribe to variable change event
  ARC.Scripting.VariableManager.OnVariableChanged += VariableManager_OnVariableChanged;

private void FormMain_FormClosing(object sender, FormClosingEventArgs e) {

  // Unsubscribe to variable change event
  ARC.Scripting.VariableManager.OnVariableChanged -= VariableManager_OnVariableChanged;

private void VariableManager_OnVariableChanged(string variableName, object value, int index) {

  if (!variableName.Equals("$myVariable", StringComparison.InvariantCultureIgnoreCase))

  // Do something because the variable has changed

Error: the referenced component" EZ_builder,EZ_B" could not be found, DJ Sure i hope you can help me !
#16   — Edited
User-inserted image
Joinny, you have to add the referencing by following the instructions in this tutorial. They are outlined with step by step to easily follow. Click add references, and browse to the appropriate files as directed in the tutorial. I can’t write anything clearer in response. The step to add references is incredibly clear but you’re skipping it.
The error cannot read the COM file, I downloaded it and when I follow the instructions, I get an error, while other files read normally.
.User-inserted image
#18   — Edited
sorry for me but i tried many different ways but still show the error,I couldn't find EZ_B.dll file even though I downloaded it
None of the required references are in your list. Please follow the tutorial. It explains exactly how to click the browse button and navigate to the folder and select the files.
Sorry, but the reason I can't reference is because there is no file in the EZ_B folder and there is an error : this folder is empty , I am trying to solve it. I would like to thank DJ sure for answering my superfluous questions and I'm sorry for bothering you