V následující části je uveden postup začlenění makra do projektu maker aplikace Revit. Pokud ukázka, která byla popsána v části týkající se použití ukázek Revit Macro ze sady SDK dostatečně vyhovuje, můžete tuto část přeskočit.
Tato část vysvětluje, kde je v projektech integrovaného vývojového prostředí třeba vytvořit složky odpovídající prostředkům systému souborů, jak přidat požadované odkazy a jak definovat vlastnosti. V makrech sestavených do souboru Revit_Macro_Samples.rvt dodávaného se sadou SDK byly tyto kroky provedeny za vás.
Jestliže makro zobrazuje uživatelské rozhraní, bude nutné do projektu přidat požadované odkazy. Například v makru SDK SampleRooms je nutné odkazovat na:
Spusťte Správce maker, vyberte typ projektu a klikněte na tlačítko Upravit.
V integrovaném vývojovém prostředí přejděte k nástroji Project Explorer. Ve výchozím nastavení je ukotven na pravé straně obrazovky.
V projektu makra (například AppCSharp) klikněte pravým tlačítkem myši na část References a z nabídky vyberte příkaz Add Reference.
V dialogu Add Reference vyhledejte a vyberte v seznamu položky System.Drawing a System.Windows.Forms. Chcete-li provést vícenásobný výběr, podržte klávesu Ctrl. Příklad:
Jakmile budete hotovi, klikněte na tlačítko OK.
V nástroji Project Explorer integrovaného vývojového prostředí budou aktualizovány tyto odkazy:
V nástroji Project Explorer integrovaného vývojového prostředí klikněte pravým tlačítkem myši na projekt makra a z nabídky vyberte příkaz Add New Folder. Příklad:
Pojmenujte složku. V tomto příkladu ji můžeme nazvat Vzorky. Pak klikněte pravým tlačítkem myši na složku Vzorky a kliknutím na příkaz Add New Folder přidejte druhou složku, například Místnosti.
Mimo prostředí IDE použijte k přechodu do instalačních složek aplikace Revit nástroj Průzkumník Windows a přejděte do složky AppHookup. V tomto umístění byly vytvořeny odpovídající podsložky \Samples\Rooms.
Zůstaňte mimo integrované vývojové prostředí Revit a zkopírujte soubory makra do podsložky, kterou jste vytvořili.
Vraťte se do integrovaného vývojového prostředí Revit. V nástroji Project Explorer (stále v tomto příkladu) klikněte pravým tlačítkem myši na složku, kterou jste pro makro vytvořili, a z nabídky vyberte příkaz Add Existing Item. Příklad:
Ve výsledném dialogu integrovaného vývojového prostředí přejděte do odpovídající podsložky v systému souborů (například adresáře Revit SDK Macro Sample), v instalační složce produktu Revit vyberte všechny soubory tvořící makro a klikněte na tlačítko Přidat.
V tomto příkladu obsahuje aktualizovaný nástroj Project Explorer integrovaného vývojového prostředí pro GetTimeElapsed_CSharp následující položky:
Po přidání souborů do projektu můžete napsat metodu, která makro spustí. Příklad v jazyce C#:
/// Sample Rooms testpublic void RunSampleRooms(){SamplesRoom sample = new SamplesRoom(this);sample.Run();}
Nezapomeňte přidat direktivu using pro obor názvů makra. Příklad:
using Revit.SDK.Samples.Rooms.CS;
Uložte projekt a klikněte v nabídce panelu nástrojů integrovaného vývojového prostředí na příkaz Build. V aplikaci Revit spusťte Správce maker a vyberte makro v kategorizovaném seznamu. V sadě SDK mohou být vzorky místností zakódovány jako makra na úrovni dokumentu. V takovém případě budou nutné změny kódu, aby ji bylo možné spustit v projektu AppCSharp, který je znázorněn na obrazovkách v této části.
Makro při spuštění ze Správce maker shromáždí data z modelu a zobrazí souhrnné informace. Zde je uveden příklad:
Jedna z ukázek makra aplikace Revit, GridCreation, je závislá na souboru resources.resx. Než začnete s ukázkou GridCreation experimentovat, nastavte soubor ResX v integrovaném vývojovém prostředí Revit makro. Tato operace již byla provedena v ukázkách maker na úrovni dokumentu začleněných do souboru Revit_Macro_Samples.rvt (ze sady SDK). U maker, která vytvoříte sami, však může být zapotřebí definovat vlastnosti v souboru resources.resx daného projektu. V této části je uveden příklad.
V nástroji Project Explorer přejděte do složky Properties příslušného makra. Příklad YourMacro Samples
GridCreation
Properties.
Zvýrazněte soubor resources.resx.
V podokně Properties vyberte vlastnost Custom Tool a do sloupce value zadejte ResXFileCodeGenerator.