Add

Add

This function adds a new line with value(s) in the MultiTagViewer Object. This function has two ways to be used:

Function Definition:

void Add(string property, object value);

.     string property: A String parameter containing the property name.

.     object value: A object parameter containing the value that will be inserted in the property.

            void Add(Dictionary<string, object> properties);

.     Dictionary<string, object> properties: A Dictionary parameter containing all the properties and value that will be inserted in the object.

To configure this property, follow the steps below:

1.   In an object event, configure the Add function: MultiTagViewerObjectName.Add(Property,Value);

2.   During the execution of RunTime, run the configured event to add a item.

Example with Add(string property, object value):

In the graphic document, the user has one MultiTagViewer object (named as GraphicObject1). In a Button object (named as GraphicObject2) the user configures the MouseUp event with the following event:

GraphicObject1.Add("Property.Value", Value);

In this event, a new item will be added in the GraphicObject1.

Example with Add(Dictionary<string, object> properties):

In the graphic document, the user has one MultiTagViewer object (named as GraphicObject1). In a Text-Box object (named as GraphicObject2) the user configures the MouseUp event with the following event:

System.Collections.Generic.Dictionary<string, object> dict = new System.Collections.Generic.Dictionary<string, object>();

dict.Add("Name.Value", NameTextBox.Text);

dict.Add("LastName.Value", LastNameTextBox.Text);

GraphicObject1.Add(dict);

In this event, a new item will be added in the GraphicObject1. The difference between this function and the first one is that, using a dictionary the user can add an item with more than one property configured. For example, in the the following script:

GraphicObject1.Add("Name.Value", NameTextBox.Text);

GraphicObject1.Add("LastName.Value", LastNameTextBox.Text);

The result will be two new items in the MultiTagViewer instead of one new item with two configured properties.