Moves an item to a different group, and returns the new Project Tree ItemID assigned to the item.
JavaScript |
|
SetParent( ItemID, ParentGroupID) |
|
C# |
|
int SetParent( int ItemID, int ParentGroupID) |
|
C++ |
|
HRESULT SetParent( LONG_PTR ItemID, LONG_PTR ParentGroupID, LONG_PTR * newItemID) |
|
Parameters
ItemID
Specifies which item is placed within the new parent.
ParentGroupID
The ID of the item that becomes the new parent for ItemID. The ParentGroupID must be a valid group ID.
Return Value
NewItemID
The new ItemID given to the item after the move.
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 |
Can not use tree root for this operation |
TE_E_INFOTREE_ITEMISGROUP |
ItemID is a group so an object cannot be retrieved. |
Remarks
SetParent is equivalent to dragging an item into another group.