Funkcje dokumentu zapewniają dostęp do dokumentów części, zespołów lub rysunków Inventor.
Pozwalają wykonywać zadania takie jak pobieranie nazwy pliku lub aktualizacja modelu.
W funkcjach dokumentu ThisDoc odnosi się do dokumentu programu Inventor, w którym zapisano regułę. Często jest to aktywny dokument, lecz może to również być część w zespole. Gdziekolwiek przechowywana jest reguła, ThisDoc daje użytkownikowi dostęp do tego dokumentu.
Aby uzyskać dostęp do funkcji dokumentu, rozwiń węzeł Dokument na karcie System w obszarze Szablony kodu okna dialogowego Edycja reguły funkcji iLogic.
Zwraca ścieżkę dostępu do dokumentu (nazwę folderu) w postaci ciągu tekstowego.
Składnia
ThisDoc.Path
Zwraca nazwę pliku dokumentu.
Składnia
ThisDoc.FileName(False)
Rozszerzenie pliku nie jest uwzględniane, gdy jako argument podano False. Jeśli potrzebne jest rozszerzenie pliku, podstaw True jako argument.
Zwraca ścieżkę dostępu i nazwę pliku dokumentu.
Składnia
ThisDoc.PathAndFileName(False)
Rozszerzenie pliku nie jest uwzględniane, gdy jako argument podano False. Aby uwzględnić rozszerzenie pliku, podstaw True w nawiasie.
Tworzy nazwę pliku, korzystając z nazwy pliku dokumentu i zmienionego rozszerzenia.
Składnia
changedName = ThisDoc.ChangeExtension(".now")
Zwraca ścieżkę dostępu (nazwę folderu) aktywnego obszaru roboczego projektu Inventor. Jeśli nie zdefiniowano żadnego obszaru roboczego, funkcja zwraca pusty ciąg (ciąg nie zawierający żadnych znaków, o długości = zero).
Składnia
ThisDoc.WorkspacePath()
Otwiera plik w oparciu o podaną ścieżkę dostępu i nazwę pliku (wraz z rozszerzeniem). Jeśli wybrano plik danych, zostaje on otwarty w swojej macierzystej aplikacji. Jeśli wybrano plik wykonalny (.exe), zostaje uruchomiony program. Jeśli nie zdefiniowano pełnej ścieżki dostępu, iLogic szuka pliku w tym samym folderze, w którym znajduje się dokument Inventor. Można również określić relatywną nazwę i ścieżkę dostępu do folderu zawierającego dokument.
Składnia
ThisDoc.Launch("ścieżka\plik.roz”)
Zapisuje bieżący aktywny dokument. Ta funkcja nie działa w regułach uruchamianych przez zdarzenie zmiany parametru.
Składnia
ThisDoc.Save
Aktualizuje dokument zawierający regułę, gdy ta (i każda inna przez nią uruchomiona) kończy działanie. Aktualizacja daje rezultat identyczny, jak kliknięcie przycisku Uaktualnij w interfejsie użytkownika.
Składnia
iLogicVb.UpdateWhenDone = True
Jeśli reguła spowodowała zmianę wartości któregoś z parametrów, ta funkcja wprowadza nowe wartości do modelu Inventor. Jeśli użytkownik nie korzysta z tej funkcji, zmiany nie zostają wprowadzone aż do momentu, gdy reguła kończy działanie. Użyj tej funkcji, jeśli musisz dokonać aktualizacji za pomocą DocumentUpdate. Użyj jej również, jeśli używasz funkcji iLogicVb.RunRule, tak aby druga reguła otrzymała nowe wartości parametrów.
Składnia
RuleParametersOutput()
Dokonuje natychmiastowej aktualizacji w bieżącym dokumencie (zawierającym regułę) i aktualizuje wyświetlaną reprezentację. Użyj tej funkcji, jeśli zachodzi potrzeba przebudowy geometrii (np. w przypadku obliczania masy za pomocą iProperties.Mass). Jeśli reguła powoduje uruchomienie innych reguł (poprzez zmianę parametrów), włącz opcję Natychmiast uruchom reguły zależne w oknie dialogowym Edycja reguły. Zagwarantuje to, że pozostałe reguły zakończą działanie przed dokonaniem aktualizacji.
Składnia
InventorVb.DocumentUpdate()
Dokonuje natychmiastowej aktualizacji w bieżącym dokumencie (zawierającym regułę), nie aktualizując wyświetlanej reprezentacji. Funkcja InventorVb.DocumentUpdate uaktualnia zarówno wyświetlaną reprezentację, jak i model. Jeśli aktualizacja wyświetlanej reprezentacji nie jest pożądana, użyj przedstawionej funkcji.
Składnia
InventorVb.DocumentUpdate(False)
Ta funkcja Inventor API uaktualnia wyłącznie wyświetlaną reprezentację, nie model.
Składnia
ThisApplication.ActiveView.Update()
Weryfikuje wartości parametrów, lecz nie zmienia żadnej z wartości.
Funkcja ta ma zastosowanie w następujących sytuacjach:
Załóżmy, że parametry są połączone z częścią bazową, a w części bazowej z zewnętrznym arkuszem kalkulacyjnym. Istnieje możliwość zmiany wartości parametrów w arkuszu i ich zapisania tak, aby zmiany te nie zostały odzwierciedlone w części głównej. Zastosuj przedstawioną funkcję w regule wewnątrz części głównej przed zastosowaniem GoExcel w celu zmiany wartości parametrów w arkuszu. Funkcja ta gwarantuje, że część bazowa pozostaje załadowana (w tle) oraz że zmiany zostają rozpropagowane do części głównej zespołu.
Składnia
InventorVb.CheckParameters("")
Zapisuje dokument używając nowej nazwy pliku i, opcjonalnie, z nowym rozszerzeniem.
Składnia
ThisDoc.Document.SaveAs(NazwaNowegoPlikuZRozszerzeniem, True)
True
Zastosuj ustawienie True, aby wykonać operację Zapisz kopię jako, albo ustawienie False, aby wykonać operację Zapisz jako.