SetParent

Moves an item to a different group.

 

JavaScript

 

SetParent(

       ID,

       ParentGroupID)

 

C#

 

void SetParent(

       string ID,

       string ParentGroupID)

 

C++

 

HRESULT SetParent(

       BSTR ID,

       BSTR ParentGroupID) 

Parameters

ID

Specifies which item is placed within the new parent.

ParentGroupID

The ID of the item that becomes the new parent for ID. The ParentGroupID must be a valid group ID.

Exceptions                    

HRESULT can return any of the values listed in the HRESULT Return Values list, as well as the following values:

TE_E_INFOTREE_PARENTNOTGROUP

The group ID entered does not represent a valid group in the Project Tree.

TE_E_INFOTREE_ITEMNOTGROUP

The item entered is not a group and therefore cannot be used as a group.

TE_E_INFOTREE_CANTUSEROOT

Cannot use Tree root for this operation

TE_E_INFOTREE_ITEMISGROUP

Item’s ID is a group so an object cannot be retrieved.

Remarks

SetParent is equivalent to dragging an item into another group.