Tworzenie makr

We wszystkich makrach poziomu aplikacji w programie Revit używane jest słowo kluczowe Aplikacja w odniesieniu do obiektu aplikacji w językach C#, VB.NET, Ruby i Python. . Ten obiekt zawiera wszystkie dane i ustawienia występujące w aplikacji.

W makrach poziomu dokumentu w programie Revit słowo kluczowe Dokument w języku C #, VB.NET, Ruby i Python zwraca obiekt Document interfejsu API. Aby uzyskać dostęp do obiektu Application z poziomu makra dokumentu, należy użyć:

Document.Application

Uwaga: Jeśli aplikacja lub bieżący dokument zawiera już makra, muszą one być włączone w ustawieniach Bezpieczeństwo makr. Zobacz Bezpieczeństwo makr.

Przegląd tworzenia makr

  1. W Menedżerze makr wybierz kartę Aplikacja (w przypadku makr poziomu aplikacji) lub kartę Projekt (w przypadku makr poziomu dokumentu), na której zostanie umieszczone makro.
  2. W sekcji Uruchom w oknie dialogowym Menedżer makr kliknij opcję Makro.

    Otwarte zostanie okno dialogowe Utwórz nowe makro.

  3. Podaj następujące informacje:
    • W polu Nazwa makra wprowadź nazwę.
    • Wybierz moduł nadrzędny z listy Makro w. Język modułu nadrzędnego będzie językiem makra.
    • Można również dodać krótki opis makra w polu Opis.
  4. Kliknij przycisk OK.

    Nowe makro jest umieszczane w module nadrzędnym w Menedżerze makr.

    Zostanie uruchomiona aplikacja Revit macro IDE umożliwiająca pisanie makr. Zostanie wyświetlony szablon początkowy dla makr w określonym języku programowania.

    Na przykład w szablonie C# dla makr poziomu aplikacji przy użyciu aplikacji Revit macro IDE wykonano następujące czynności:

    • Dołączono odpowiednie dyrektywy użycia.
    • Zidentyfikowano moduł obszaru nazw (MacroAppCS na powyższej ilustracji).
    • Uruchomiono definicję klasy ThisApplication.
    • Uruchomiono metody Module_Startup () i Module_Shutdown ().
    • Uruchomiono metodę nowego makra (MyFirstMacrosApp na powyższej ilustracji), umożliwiając dodanie kodu implementacji w nawiasach.

    Należy również zauważyć, że w Eksploratorze projektów Revit macro IDE wyświetlany jest kontekst.

  5. W głównym oknie środowiska IDE można teraz wprowadzić kod źródłowy. Zobacz Przykłady kodów źródłowych makr.
  6. Kliknij kolejno opcje PlikZapisz <nazwa makra>, a następnie zamknij środowisko Revit macro IDE.
  7. Powtórz czynności od 1 do 6 w przypadku wszystkich dodatkowych makr wymaganych w module.
    Uwaga: Należy pamiętać, że konieczne jest prawidłowe zbudowanie i zapisanie projektów modułu w środowisku Revit macro IDE, aby mogły być one wyświetlane na liście kategorii w Menedżerze makr. Zobacz Budowanie makr w środowisku Revit macro IDE.

    Narzędzia opcjonalne