ElementCategoryFilter

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

public class ElementCategoryFilter : ElementQuickFilter

Public Class ElementCategoryFilter _
	Inherits ElementQuickFilter

public ref class ElementCategoryFilter : public ElementQuickFilter

// 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)

Name	Return Type	Description
C ElementCategoryFilter(BuiltInCategory)	None	Constructs a new instance of a filter to match elements by category.
C ElementCategoryFilter(BuiltInCategory, Boolean)	None	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.
C ElementCategoryFilter(ElementId)	None	Constructs a new instance of a filter to match elements by category.
C ElementCategoryFilter(ElementId, Boolean)	None	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	Return Type	Description	Inherited From
M Dispose()	None	Releases all resources used by the	ElementFilter
M PassesFilter(Document, ElementId)	bool	Applies the filter to a given element.	ElementFilter
M PassesFilter(Element)	bool	Applies the filter to a given element.	ElementFilter

Name	Return Type	Description	Inherited From
P CategoryId	ElementId	The category id.
P Inverted	bool	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.	ElementFilter
P IsValidObject	bool	Specifies whether the .NET object represents a valid Revit entity.	ElementFilter