## MoveToPartition

### Description

Moves one or more objects from their current partition to the one specified.

### Scripting Syntax

    MoveToPartition( [Target], [InputObjs], [Source] );

### Parameters

Parameter | Type | Description
--- | --- | ---
Target | String | List of partitions to add the object to. Default Value: Current selection
InputObjs | String | List of objects to add to the target partition. Default Value: Current selection
Source | String | List of passes to use if more than one partitions to chose from. Default Value: Current selection

### Examples

#### VBScript Example

    '
    '       This example demonstrates how to move objects from one
    '       partition to another.
    '
    ' Create a new scene
    NewScene , false
    ' Create a standard (default) pass
    CreatePass , "PassMeBy", oPass
    ' Create a partition containg a new cone
    Set oCone = GetPrim( "Cone", "MeshSurface" )
    SICreatePartition oPass, "Yummy", oCone, oConePart
    ' Create a partition containg a new cube
    Set oCube = GetPrim( "Cube", "MeshSurface" )
    SICreatePartition oPass, "Icky", oCube, oCubePart
    ' Now move the cube from its current partition to the cone's
    MoveToPartition oConePart, oCube, oPass

### See Also

MoveToLayer CreateEmptyPartition CreatePassWithPartition AddToPartition RemoveFromPartition GetCurrentPass SetCurrentPass DeleteCurrentPass