Dowiedz się więcej na temat interfejsu API związanego z poleceniem rysunku warsztatowego prefabrykatu
Polecenie rysunku warsztatowego prefabrykatu tworzy rysunek elementu prefabrykowanego na podstawie charakterystycznych dla typu ustawień określonych w konfiguracji prefabrykatu. Często pojedynczy element wymaga więcej niż jednego rysunku warsztatowego, np. jednego z deskowaniem i jednego ze zbrojeniem. Uwzględnić trzeba też różne wymagania dotyczące etykietowania i wymiarowania rysunków warsztatowych.
Wszystkie części interfejsu API prefabrykatów są zaimplementowane w pojedynczym pliku DLL i użytkownicy interfejsu API nie muszą odwoływać się z poziomu prefabrykatu do niczego poza tym plikiem DLL. Sam prefabrykat nie jest w żaden sposób uzależniony od niczego w interfejsie API prefabrykatów, nawet od samego istnienia pliku DLL interfejsu API.
Rozpoczęcie tworzenia rysunku warsztatowego. Gdy interfejs API wywołuje utworzenie rysunku warsztatowego, może przekazać te same ustawienia, które są używane w konfiguracji prefabrykatu. Ustawienia, których nie określono dla interfejsu API, pochodzą z konfiguracji prefabrykatu. Aby to osiągnąć, metoda tworzenia wymaga wystąpienia interfejsu IShopDrawingOptions. Program wywołujący może zaimplementować go w dowolnej klasie i wskazać za jego pomocą, które opcje są przy jego użyciu definiowane, a które nie. Interfejs API nie wymaga ani nie ma dostępu do konfiguracji prefabrykatu. Jeśli program wywołujący interfejs API nie zdefiniował jakiegoś ustawienia, kod wewnętrzny odczyta tę konfigurację. Użytkownik ma dostęp do konfiguracji prefabrykatu tylko za pomocą narzędzi interfejsu użytkownika.
W prefabrykacie programu Revit klasy tworzące rysunki warsztatowe są wyspecjalizowane pod kątem poszczególnych rodzajów elementów. Istnieje na przykład kreator rysunku warsztatowego z pustym rdzeniem i kreator rysunku warsztatowego pełnej ściany. Każdy z nich dziedziczy po wspólnej klasie bazowej. Interfejs API ujawnia klasy za pomocą klasy Factory i interfejsu publicznego zaimplementowanego w tych klasach i definiującego części tych klas, które będą widoczne dla publicznego interfejsu API.
Zdarzenia tworzenia rysunku warsztatowego. Proces tworzenia rysunku warsztatowego obejmuje etapy tworzenia, uzupełniania szczegółów i przenoszenia widoków oraz rzutni. Uzupełnianie szczegółów widoków obejmuje wymiarowanie i etykietowanie widoków. Z każdym etapem powiązane jest zdarzenie poprzedzające i następujące, a zdarzenie poprzedzające może zostać anulowane przez program obsługi zdarzeń. Program obsługi może wykonać pracę samodzielnie lub może nie wykonywać jej w ogóle, jeśli jest taka potrzeba.
Jeśli jest zarejestrowany program obsługi zdarzeń, interfejs API prefabrykatów rejestruje się w celu uzyskiwania informacji o zdarzeniach wewnętrznych, które nie są widoczne dla publicznego interfejsu API. Będzie wtedy przekazywać informacje do zarejestrowanych zewnętrznych programów obsługi zdarzeń, chroniąc poszczególne programy obsługi zdarzeń w ich własnych transakcjach podrzędnych.
W tym przypadku parametry programów obsługi zdarzeń są zdefiniowane jako interfejsy, co odłącza interfejs API prefabrykatów od spraw wewnętrznych — ułatwia to zmianę kodu wewnętrznego w przyszłości bez wpływu na interfejs API prefabrykatów.