## FCurveKeyCollection.AddItems

### Introduced

v6.0

### Description

Adds an FCurveKeyCollection to an existing collection. The keys will be added to the collection if they belong to the same FCurve as the other keys in the collection. Any keys in the input collection that are already present in the existing collection will be ignored.
Note: FCurveKeyCollection is maintained in sorted order by parameter so new keys will be inserted at the proper location according to their parameter values.

### C# Syntax

    FCurveKeyCollection.AddItems( FCurveKeyCollection in_pVal );

### Scripting Syntax

    FCurveKeyCollection.AddItems( Keys );

### Parameters

Parameter | Type | Description
--- | --- | ---
Keys | FCurveKeyCollection | Keys to add to this collection

### Examples

#### JScript Example

    //

    // This example illustrates how to add keys to an existing FCurveKeyCollection.

    // Create a new scene

    NewScene(null, false);

    // Create a null

    oNull = Application.GetPrim("Null");

    // Get the posx parameter of the null

    oPosX = oNull.posx

    // Create array of time-value pairs

    aKeys = new Array( 0.00, 5.00,

    				1.00, 6.00,

    				2.00, 7.00,

    				3.00, 8.00,

    				4.00, 9.00,

    				5.00, 10.00 );

    // Create an empty FCurve

    oFCurve = oPosX.AddFCurve2( null, siStandardFCurve );

    // Set the fcurve keys

    oFCurve.SetKeys( aKeys );

    // Get two key collections

    var keys = oFCurve.GetKeysBetween( 4, 5 );

    var keys2 = oFCurve.GetKeysBetween( 0, 1 );

    // Merge the two collections

    keys.AddItems( keys2 );

    // Print out the contents of the collection

    for (var i = 0; i < keys.Count; i++)

    {

    	Application.LogMessage( 'Time: ' + keys(i).Time + ', Value: ' + keys(i).Value, siInfo );

    }

    // Produces the following output:

    //

    //INFO : Time: 0, Value: 5

    //INFO : Time: 1, Value: 6

    //INFO : Time: 4, Value: 9

    //INFO : Time: 5, Value: 10

### See Also

FCurveKeyCollection.Add FCurveKeyCollection.Remove FCurveKeyCollection.RemoveAt