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 group.

ParentGroupID

The ID of the item that becomes the new parent for the item specified by the ID parameter. 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 ID is a group so an object cannot be retrieved.

Remarks

SetParent is equivalent to dragging an item into another group.