Namespace: Autodesk.Revit.DB Class: Categories

Categories.NewSubcategory

Method

Description:
Add a new subcategory into the Autodesk Revit document.

Syntax

public Category NewSubcategory(
	Category parentCategory,
	string name
)

Public Function NewSubcategory ( 
	parentCategory As Category,
	name As String
) As Category

public:
Category^ NewSubcategory(
	Category^ parentCategory, 
	String^ name
)

member NewSubcategory : 
        parentCategory : Category * 
        name : string -> Category

Examples

public void AssignSubCategory(Document document, GenericForm extrusion)
{
    // create a new subcategory 
    Category cat = document.OwnerFamily.FamilyCategory;
    Category subCat = document.Settings.Categories.NewSubcategory(cat, "NewSubCat");

    // create a new material and assign it to the subcategory
    ElementId materialId = Material.Create(document, "Wood Material");
    subCat.Material = document.GetElement(materialId) as Material;

    // assign the subcategory to the element
    extrusion.Subcategory = subCat;
}

Public Sub AssignSubCategory(document As Document, extrusion As GenericForm)
    ' create a new subcategory 
    Dim cat As Category = document.OwnerFamily.FamilyCategory
    Dim subCat As Category = document.Settings.Categories.NewSubcategory(cat, "NewSubCat")

    ' create a new material and assign it to the subcategory
    Dim materialId As ElementId = Material.Create(document, "Wood Material")
    subCat.Material = TryCast(document.GetElement(materialId), Material)

    ' assign the subcategory to the element
    extrusion.Subcategory = subCat
End Sub

Parameters

Parameter	Type	Description
parentCategory	Category	The parent category.
name	String	The new category name.

Return Value

Type	Description
Category	If successful, the newly created subcategory.

Exceptions

Exception	Condition
ArgumentNullException	Thrown when the input argument-"parentCategory" or "name"-is.
ArgumentException	Thrown when the input argument-"parentCategory"-cannot add subcategory. Thrown when the input argument-"name"-is an illegal name.
InvalidOperationException	Thrown when subcategory creation failed.