過去バージョン

BuiltInCategory とは

BuiltInCategory は Revit API（Autodesk.Revit.DB 名前空間）で定義された列挙型で、Revit のすべての標準カテゴリ（壁・ドア・窓・床・配管等）を表します。FilteredElementCollector で要素を絞り込む際の必須キーです。

基本的な使い方

using Autodesk.Revit.DB;

// すべての壁を取得
var walls = new FilteredElementCollector(doc)
    .OfCategory(BuiltInCategory.OST_Walls)
    .WhereElementIsNotElementType()
    .ToElements();

Console.WriteLine($"壁の数: {walls.Count}");

// 複数カテゴリを一度に取得
var categories = new List<BuiltInCategory> {
    BuiltInCategory.OST_Doors,
    BuiltInCategory.OST_Windows
};
var filter = new ElementMulticategoryFilter(categories);
var openings = new FilteredElementCollector(doc)
    .WherePasses(filter)
    .WhereElementIsNotElementType()
    .ToElements();

建築カテゴリ（よく使う 15 個）

構造カテゴリ（よく使う 8 個）

MEP（設備）カテゴリ

注釈・ビュー系カテゴリ

カテゴリ判定の書き方

// パターン1: integer 値で比較
if (element.Category != null &&
    element.Category.Id.IntegerValue == (int)BuiltInCategory.OST_Walls)
{
    Console.WriteLine("これは壁");
}

// パターン2: BuiltInCategory に変換して比較
var bic = (BuiltInCategory)element.Category.Id.IntegerValue;
switch (bic)
{
    case BuiltInCategory.OST_Walls:
        Console.WriteLine("壁");
        break;
    case BuiltInCategory.OST_Doors:
        Console.WriteLine("ドア");
        break;
    case BuiltInCategory.OST_Windows:
        Console.WriteLine("窓");
        break;
    default:
        Console.WriteLine($"その他: {element.Category.Name}");
        break;
}

// パターン3: Category.BuiltInCategory プロパティ (Revit 2023+)
// if (element.Category.BuiltInCategory == BuiltInCategory.OST_Walls) ...

FilteredElementCollector との応用

// すべての建築要素を一度に取得
var archCategories = new List<BuiltInCategory> {
    BuiltInCategory.OST_Walls,
    BuiltInCategory.OST_Floors,
    BuiltInCategory.OST_Roofs,
    BuiltInCategory.OST_Ceilings,
    BuiltInCategory.OST_Doors,
    BuiltInCategory.OST_Windows,
    BuiltInCategory.OST_Columns,
    BuiltInCategory.OST_Stairs
};

var multiFilter = new ElementMulticategoryFilter(archCategories);
var archElements = new FilteredElementCollector(doc)
    .WherePasses(multiFilter)
    .WhereElementIsNotElementType()
    .ToElements();

// レベルごとに壁を集計
var levels = new FilteredElementCollector(doc)
    .OfCategory(BuiltInCategory.OST_Levels)
    .Cast<Level>();

foreach (var level in levels)
{
    var levelFilter = new ElementLevelFilter(level.Id);
    var wallsOnLevel = new FilteredElementCollector(doc)
        .OfCategory(BuiltInCategory.OST_Walls)
        .WherePasses(levelFilter)
        .WhereElementIsNotElementType()
        .Count();

    Console.WriteLine($"{level.Name}: {wallsOnLevel} walls");
}

カテゴリ一覧を動的に取得する

// プロジェクトの全カテゴリを列挙
foreach (Category cat in doc.Settings.Categories)
{
    int id = cat.Id.IntegerValue;
    string bicName = "";
    if (Enum.IsDefined(typeof(BuiltInCategory), id))
        bicName = ((BuiltInCategory)id).ToString();

    Console.WriteLine($"{cat.Name} | {id} | {bicName}");
}

FAQ

Q: BuiltInCategory 一覧を全て見たい
A: Revit API ドキュメント、または Enum.GetValues(typeof(BuiltInCategory)) で列挙できます。約 1300 個あります。

Q: カスタムカテゴリは作れる？
A: BuiltInCategory には追加できませんが、サブカテゴリは作成可能（ファミリエディタ内）。

Q: タイプ要素もまとめて取得するには？
A: WhereElementIsElementType() または WhereElementIsNotElementType() を省略すれば両方取れます。