CreateGroup
This method creates a group in the Project Tree.
|
JavaScript |
|
|
CreateGroup( GroupName, ParentGroupID) |
|
|
C# |
|
|
string CreateGroup( string GroupName, string ParentGroupID = "") |
|
|
C++ |
|
|
HRESULT CreateGroup( BSTR GroupName, BSTR ParentGroupID, BSTR * pVal) |
|
Parameters
GroupName
Name assigned to the group being created.
ParentGroupID
The Project Tree group in which the group is created. If it is set to an empty string, the object is created under the root. You can obtain the GroupID by one of the following methods:
· Create the group using IProjectTree80.CreateGroup.
· Find the group, if you know the name, using IProjectTree80.FindItem.
· Traverse the Tree using IProjectTree80 methods such as GetNextItem, until you come to the desired GroupID.
Return Value
pVal
The ID of the group being created.
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. |