InsertItemsFromTag

Parent Previous Next

InsertItemsFromTag

This function inserts items in the combo-box object from tag. If the type of the tag is a DataType, the user can insert the content of just one member rather than all the content of the tag.


Function Definition:


void InsertItemsFromTag( string tag );


.     string tag: A String parameter containing the tag name that will be inserted.



void InsertItemsFromTag( string tag, string member );


.     string tag: A String parameter containing the tag name that will be inserted.

.     string member: A String parameter containing the name of the tag member.



void InsertItemsFromTag(string tag, bool isScreenTag);


.     string tag: A String parameter containing the tag name that will be inserted.

.     bool isScreenTag: A bool parameter set if a tag is or isn't ScreenTag.



void InsertItemFromTag(string tag, string member, bool isScreenTag);


.     string tag: A String parameter containing the tag name that will be inserted.

.     string member: A String parameter containing the name of the tag member.

.     bool isScreenTag: A bool parameter set if a tag is or isn't ScreenTag.



To configure this function, follow the steps below:


1.   In an object event, configure the InsertItemsFromTag function: ComboBoxObjectName.InsertItemsFromTag( tagName );


2.   During the execution of the RunTime, run the configured event to insert a new item into the combo-box object.



Example with InsertItemsFromTag( string tag ):

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

            GraphicObject1.InsertItemsFromTag( tagName);

In this event, the content of the tag will be added in the GraphicObject1. In this case, if the tag is a DataType, the content of all members will be inserted too.



Example with InsertItemsFromTag( string tag, string member ):

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

                        GraphicObject1.InsertItemsFromTag( tagName, "Name");

In this event, the content of the tag member Name will be added in the GraphicObject1



Example with InsertItemsFromTag( string tag, bool isScreenTag ):

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

                        GraphicObject1.InsertItemsFromTag( tagName, true);

In this event, the content of the tag is a ScreenTag in the GraphicObject1

                        GraphicObject1.InsertItemsFromTag( tagName, false);

In this event, the content of the tag isn't a ScreenTag in the GraphicObject1



Example with InsertItemsFromTag( string tag, string member, bool isScreenTag ):

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


GraphicObject1.InsertItemsFromTag( tagName,  "Name",  true);


In this event, the content of the tag member Name will be added and the tag is a ScreenTag in the GraphicObject1.


GraphicObject1.InsertItemsFromTag( tagName,"Name", false);


In this event, the content of the tag member Name will be added and the tag isn't a ScreenTag in the GraphicObject1.


  

 

Note: This property exists only to the following objects:

.     Combo-Box