Namespace: Autodesk.Revit.DB

ElementCategoryFilter

Class

Description:
A filter used to match elements by their category.

Remarks:
This filter is a quick filter. Quick filters operate only on the ElementRecord, a low-memory class which has a limited interface to read element properties. Elements which are rejected by a quick filter will not be expanded in memory.

Inheritance Hierarchy:
System.Object
  Autodesk.Revit.DB.ElementFilter
    Autodesk.Revit.DB.ElementQuickFilter
      Autodesk.Revit.DB.ElementCategoryFilter

Syntax

public class ElementCategoryFilter : ElementQuickFilter

Public Class ElementCategoryFilter
	Inherits ElementQuickFilter

public ref class ElementCategoryFilter : public ElementQuickFilter

type ElementCategoryFilter = 
    class
        inherit ElementQuickFilter
    end

Examples

// Find all Wall instances in the document by using category filter
ElementCategoryFilter filter = new ElementCategoryFilter(BuiltInCategory.OST_Walls);

// Apply the filter to the elements in the active document,
// Use shortcut WhereElementIsNotElementType() to find wall instances only
FilteredElementCollector collector = new FilteredElementCollector(document);
IList<Element> walls = collector.WherePasses(filter).WhereElementIsNotElementType().ToElements();
String prompt = "The walls in the current document are:\n";
foreach (Element e in walls)
{
    prompt += e.Name + "\n";
}
TaskDialog.Show("Revit", prompt);

' Find all Wall instances in the document by using category filter
Dim filter As New ElementCategoryFilter(BuiltInCategory.OST_Walls)

' Apply the filter to the elements in the active document,
' Use shortcut WhereElementIsNotElementType() to find wall instances only
Dim collector As New FilteredElementCollector(document)
Dim walls As IList(Of Element) = collector.WherePasses(filter).WhereElementIsNotElementType().ToElements()
Dim prompt As [String] = "The walls in the current document are:" & vbLf
For Each e As Element In walls
   prompt += e.Name + vbLf
Next
TaskDialog.Show("Revit", prompt)

ElementCategoryFilter Class Members:

Name	Description	Inherited From
ElementCategoryFilter(BuiltInCategory)	Constructs a new instance of a filter to match elements by category.
ElementCategoryFilter(ElementId)	Constructs a new instance of a filter to match elements by category.
ElementCategoryFilter(BuiltInCategory, Boolean)	Constructs a new instance of a filter to match elements by category, with the option to match all elements which are not of the given category.
ElementCategoryFilter(ElementId, Boolean)	Constructs a new instance of a filter to match elements by category, with the option to match all elements which are of the given category.

Name	Description	Inherited From
CategoryId	The category id.
Inverted	True if the results of the filter are inverted; elements that would normally be accepted by this filter will be rejected, and elements that would normally be rejected will be accepted. (Inherited from ElementFilter )	ElementFilter
IsValidObject	Specifies whether the .NET object represents a valid Revit entity. (Inherited from ElementFilter )	ElementFilter

Name	Description	Inherited From
Dispose	(Inherited from ElementFilter )	ElementFilter
Equals	Determines whether the specified object is equal to the current object. (Inherited from Object )	Object
GetHashCode	Serves as the default hash function. (Inherited from Object )	Object
GetType	Gets the Type of the current instance. (Inherited from Object )	Object
PassesFilter(Element)	Applies the filter to a given element. (Inherited from ElementFilter )	ElementFilter
PassesFilter(Document, ElementId)	Applies the filter to a given element. (Inherited from ElementFilter )	ElementFilter
ToString	Returns a string that represents the current object. (Inherited from Object )	Object