過去バージョン

この記事は Revit カテゴリの一部です。API の全体像は Revit API 概要 で押さえておくと理解が早まります。要素を集めたら、編集は トランザクションと要素編集 内で行います。

1FilteredElementCollector の基本

FilteredElementCollector は、Document（またはビュー）を対象に要素を収集するクラスです。生成しただけでは全要素が対象ですが、フィルタを連結（チェーン）して絞り込みます。フィルタは「速い順序」で適用されるよう、まず種別系で絞ってから条件を加えるのが定石です。

2OfClass と OfCategory

絞り込みには 2 系統あります。目的に応じて使い分けます。

壁インスタンスを取得する基本形は次の通りです。

using Autodesk.Revit.DB;
using System.Collections.Generic;
using System.Linq;

// doc は Document
FilteredElementCollector collector =
    new FilteredElementCollector(doc)
        .OfClass(typeof(Wall))
        .WhereElementIsNotElementType();

List<Wall> walls = collector.Cast<Wall>().ToList();
TaskDialog.Show("結果", "壁の数: " + walls.Count);

List<Wall> のようなジェネリクスを多用するため、型を意識してキャストするのがポイントです。

3インスタンスとタイプの区別

Revit の要素には「タイプ（ElementType: 種類・規格の定義）」と「インスタンス（実際に配置された個体）」があります。コレクタはどちらも拾うため、目的に応じて絞ります。

この絞り込みを忘れると、インスタンスとタイプが混在して件数が想定と合わなくなります。

4ElementId と LINQ による加工

取得した各要素は ElementId で一意に識別されます。ID から本体を得るには doc.GetElement(id) を使い、逆に要素から ID は element.Id で取得できます。

コレクタは IEnumerable<Element> を実装するため、LINQ で柔軟に処理できます。たとえばカテゴリで集めた上で、特定の高さの壁だけを抽出するには次のように書きます。

var tallWalls = new FilteredElementCollector(doc)
    .OfCategory(BuiltInCategory.OST_Walls)
    .WhereElementIsNotElementType()
    .Cast<Wall>()
    .Where(w => w.get_Parameter(
        BuiltInParameter.WALL_USER_HEIGHT_PARAM)
        .AsDouble() > 10.0)   // 内部単位フィート
    .ToList();

LINQ の Where でロジックを表現し、Select で値へ変換、Cast で型を確定する、という流れが基本パターンです。比較する数値は内部単位（フィート）である点に注意してください。

→次に読む