フェーズ

改築などの建築プロジェクトはいくつかのフェーズを踏みながら進行します。フェーズには次の特性があります。

フェーズは、プロジェクトのライフサイクルにおける個々の期間を表します。
建築内の要素の寿命はフェーズによってコントロールされます。
各要素は建設フェーズがありますが、破壊フェーズを持つのは有限寿命を持つ要素のみです。

プロジェクトのすべてのフェーズはドキュメントオブジェクトから取得できます。フェーズオブジェクトには、Name、ID、UniqueId の 3 つの有用な情報があります。残りのプロパティは、常に null または空の集合を返します。

プロジェクトに追加されているそれぞれの新しいモデリングコンポーネントには、Created Phase ID と Demolished Phase ID プロパティがあります。Element.AllowPhases()メソッドは、フェーズ ID プロパティが修正可能かどうかを示します。

Created Phase ID プロパティには次の特性があります。

コンポーネントが追加されたフェーズを識別します。
既定値は現在のフェーズ値と同じ ID になります。
ドロップダウンリストから対応する新しい値を選択して、Created Phase ID パラメータを変更します。

Demolished Phase ID プロパティには次の特性があります。

コンポーネントをどのフェーズで解体するかを定義します。
既定値は none です。
解体ツールを使用してコンポーネントを解体すると、要素を解体したビューの現在のフェーズ ID の値にプロパティが更新されます。
Demolished Phase ID プロパティを別の値にすることで、コンポーネントを解体することができます。
Revit プラットフォーム API を使用してフェーズを削除した場合は、現在のフェーズのすべてのモデリングコンポーネントはそのまま残ります。これらのコンポーネントの Created Phase ID パラメータ値は[プロパティ]ダイアログボックスのドロップダウンリストの次のアイテムに変更されます。

図 65: フェーズを作成したコンポーネントパラメータの値

次のコードサンプルでは、現在のドキュメント内のサポートされるすべてのフェーズが表示されます。フェーズ名がメッセージボックスに表示されます。

コード領域 15-6: サポートされるすべてのフェーズを表示

void Getinfo_Phase(Document doc)
{
        // Get the phase array which contains all the phases.
        PhaseArray phases = doc.Phases;
        // Format the string which identifies all supported phases in the current document.
        String prompt = null;
        if (0 != phases.Size)
        {
                prompt = "All the phases in current document list as follow:";
                foreach (Phase ii in phases)
                {
                        prompt += "\n\t" + ii.Name;
                }
        }
        else
        {
                prompt = "There are no phases in current document.";
        }
        // Give the user the information.
        TaskDialog.Show("Revit",prompt);
}