Začlenění maker do integrovaného vývojového prostředí Revit

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.

Přidání požadovaných odkazů

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:

  1. System.Windows.Forms
  2. System.Drawing

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:

Vytvoření složek v integrovaném vývojovém prostředí Revit

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.

Zkopírování makra do složky v systému souborů

Zůstaňte mimo integrované vývojové prostředí Revit a zkopírujte soubory makra do podsložky, kterou jste vytvořili.

Poznámka: Pokud je v makru použit soubor ResX, zkopírujte jej také.

Přidání existujících souborů do projektu makra v integrovaném vývojovém prostředí

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:

Vytvoření a sestavení makra

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:

Vlastnosti souboru Resources.resx

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.