## XSICollection.AddItems

### Description

Adds one or more items to the collection. Compare this method to XSICollection.Add, which only adds a single item at a time or XSICollection.SetAsText, which adds all items in the string list.

### C# Syntax

    XSICollection.AddItems( Object in_newVal );

### Scripting Syntax

    XSICollection.AddItems( Items );

### Parameters

Parameter | Type | Description
--- | --- | ---
Items | XSICollection, Array or object name | The items to add.

### Examples

#### VBScript Example

    Dim oColl		' object pointer for collection

    Dim aItems		' array of items to add all at once

    ' Create the new collection & populate it using SetAsText

    Set oColl = CreateObject( "XSI.Collection" )

    oColl.SetAsText "Camera,Light"

    checkContents oColl

    ' Clear it and add the items again using Add

    oColl.RemoveAll

    checkContents oColl

    oColl.Add "light"

    oColl.Add "camera"

    checkContents oColl

    ' Clear it again and add the items using AddItems

    oColl.RemoveAll

    aItems = Array( "Camera", "Light" )

    oColl.AddItems aItems

    checkContents oColl

    '--------------------------------------------------

    function checkContents( in_coll )

    	LogMessage "----------------"

    	If in_coll.Count > 0 Then

    		LogMessage "Collection now contains " & in_coll.GetAsText

    	Else

    		LogMessage "Collection is empty."

    	End If

    end function

    '--------------------------------------------------

    ' Output of above script:

    'INFO : "----------------"

    'INFO : "Collection now contains Camera,light"

    'INFO : "----------------"

    'INFO : "Collection is empty."

    'INFO : "----------------"

    'INFO : "Collection now contains light,Camera"

    'INFO : "----------------"

    'INFO : "Collection now contains Camera,light"

### See Also

XSICollection.GetAsText XSICollection.Add XSICollection.RemoveItems