## 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